# Search objects step

![](/files/-Miqf5VrLrO_C4t7kOhM)

### General parameters

First and foremost you choose the structure, where you want to find objects.

Then, choose the format of the search result:

* **arrayLink** – as a result you'll have an [array of links](/data/data-types.md#available-data-types) to found objects (array of their IDs).
* **count** – as a result you'll have the *quantity* of found objects.
* **sum** — as a result you will have a sum of values of the chosen field of found objects.
* **array of fields** — as a result you will have an array of values the chosen field of found objects.

The, pick the field of the current object where you want to save the result.

Set the **generate event** option if you want another scenario be triggered by this step.

### Search conditions

Set up conditions of your search (similar to [Condition step](/scenarios/editing-scenarios/condition-steps/condition-step.md)).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://readme.directual.com/scenarios/editing-scenarios/action-steps/search-objects-step.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.