--- title: Connect Elastic Agent Builder agents and Elastic Workflows description: Learn how Agent Builder works with Elastic Workflows, including creating workflows from chat, workflow tools, pre-execution workflows, and the `ai.agent` step. url: https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7588/explore-analyze/ai-features/agent-builder/agents-and-workflows products: - Elastic Cloud Serverless - Elastic Observability - Elastic Security - Elasticsearch - Kibana applies_to: - Elastic Cloud Serverless: Preview - Elastic Stack: Preview since 9.3 --- # Connect Elastic Agent Builder agents and Elastic Workflows Elastic Workflows and Elastic Agent Builder combine deterministic automation with conversational reasoning. You can create workflows conversationally, make workflows available to agents, and invoke agents from workflows. ## Approaches There are three ways to use Elastic Agent Builder and workflows together: - **Create workflows from Agent Chat** Elastic Stack: Planned Elastic Cloud Serverless: Generally available: Describe the automation you want in natural language, refine the generated draft, then open **Preview** and select **Save** to create it. Refer to [Create skills and workflows in chat](/elastic/docs-content/pull/7588/explore-analyze/ai-features/agent-builder/chat#create-skills-and-workflows-directly-from-chat). - **Use workflows from agents:** Trigger an existing workflow from a conversation with a [workflow tool](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7588/explore-analyze/ai-features/agent-builder/tools/workflow-tools), or assign [pre-execution workflows](#pre-execution-workflows) that run before the agent starts reasoning. - **Use agents from workflows:** Invoke an agent from a workflow with the [`ai.agent` step](#use-ai-agent-workflow-step). For advanced API operations, use the [`kibana.request` step](#use-kibana-request-workflow-step). ## Prerequisites Before you begin: - Familiarize yourself with the core concepts of [Elastic Workflows](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7588/explore-analyze/workflows). - Enable the Workflows feature in **Advanced settings**. - Ensure you have the correct privileges to create and run workflows. - For details, refer to [Set up workflows](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7588/explore-analyze/workflows/get-started/setup). ## Pre-execution workflows - Elastic Stack: Generally available since 9.4 Pre-execution workflows run after each user message, before the agent makes any LLM calls in response. They let you use Elastic Workflows for deterministic preparation or control before the agent begins its reasoning loop. Only administrators can configure pre-execution workflows. A pre-execution workflow runs once for each user message. It does not run before every LLM call or tool call within the agent's response. Pre-execution workflows can: - Add or rewrite prompt context before the agent starts. - Cancel the agent run when a workflow detects that the request should not continue. - Run multiple workflows in sequence when more than one workflow is assigned. To configure pre-execution workflows: 1. Select **Manage components** at the bottom of the left sidebar, then select **Agents**. 2. Select an agent, then go to **Settings**. 3. In the **Pre-execution workflow** section, open the **Workflows** selector. 4. Select one or more workflows. They run after each user message, before the agent makes any LLM calls in response. 5. Save the agent. The following screenshot shows the **Pre-execution workflow** setting in the agent **Settings** view. ![Edit agent settings flyout showing the Pre-execution workflow section with a workflow selector](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7588/explore-analyze/ai-features/agent-builder/images/pre-execution-workflows.png) ## Use the `ai.agent` step Follow these steps to invoke an `ai.agent` as a step within a workflow. 1. Open the **Workflows** editor and create or edit a workflow. 2. Add a new step with the type `ai.agent`. 3. Set the **`agent-id`** parameter at the top level of the step to the unique identifier of the target agent. If you omit it, the step uses the built-in Elastic AI Agent. 4. In the **`with`** block, set the **`message`** parameter to your natural language prompt. 5. Optionally, in the **`with`** block, set the **`schema`** parameter to a JSON Schema object to receive structured output from the agent instead of free-text. 6. Optionally, route the step to a specific model by setting **`connector-id`** or **`inference-id`** at the top level of the step. These parameters are mutually exclusive. ### Example: Analyze flight delays The following example demonstrates a workflow that searches for flight delays and uses the **Elastic AI Agent** to summarize the impact. To follow along with this example ensure that the [Kibana sample flight data](https://www.elastic.co/docs/extend/kibana/sample-data) is installed. ```yaml version: "1" name: analyze_flight_delays description: Fetches delayed flights and uses an agent to summarize the impact. enabled: true triggers: - type: manual steps: # Step 1: Get data from Elasticsearch - name: get_delayed_flights type: elasticsearch.search with: index: "kibana_sample_data_flights" query: range: FlightDelayMin: gt: 60 size: 5 # Step 2: Ask the agent to reason over the data - name: summarize_delays type: ai.agent agent-id: "elastic-ai-agent" with: message: | Review the following flight delay records and summarize which airlines are most affected and the average delay time: {{ steps.get_delayed_flights.output }} # Step 3: Print the agent's summary - name: print_summary type: console with: message: "{{ steps.summarize_delays.output }}" ``` ### Parameters Set `agent-id` and other configuration keys at the top level of the step. Set inputs like `message` in the `with` block. | Parameter | Location | Type | Required | Description | |-----------------------|-----------|---------|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `agent-id` | Top level | string | No | The unique identifier of the target agent (must exist in Elastic Agent Builder). Defaults to the built-in Elastic AI Agent. | | `connector-id` | Top level | string | No | The GenAI connector to use for model routing. Mutually exclusive with `inference-id`. | | `inference-id` | Top level | string | No | The inference endpoint ID to use for model routing. Mutually exclusive with `connector-id`. | | `create-conversation` | Top level | boolean | No | When `true`, persists the conversation so that follow-up steps or later requests can continue it. | | `message` | `with` | string | Yes | The natural language prompt to send to the agent. Can include template variables to reference data from previous steps. | | `schema` | `with` | object | No | A JSON Schema object that defines the structure of the expected response. When provided, the agent returns structured data matching the schema instead of free-text. | | `conversation_id` | `with` | string | No | Continue an existing conversation by ID. | | `attachments` | `with` | array | No | Attachments to provide to the agent. | For the complete step reference, refer to [`ai.agent`](/elastic/docs-content/pull/7588/explore-analyze/workflows/steps/ai-steps#ai-agent). ## Use `kibana.request` step Use the generic `kibana.request` step to interact with Elastic Agent Builder APIs programmatically. 1. Add a new step with the type `kibana.request`. 2. Set the method (for example: `GET`, `POST`). 3. Set the `path` to the specific [Agent Builder API endpoint](https://www.elastic.co/docs/api/doc/kibana/group/endpoint-agent-builder). ### Example: List available agents This step retrieves a list of all agents currently available in Agent Builder. ```yaml name: list_agents enabled: true triggers: - type: manual steps: - name: list_agents type: kibana.request with: method: GET path: /api/agent_builder/agents ``` ## Examples The [`elastic/workflows` GitHub repo](https://github.com/elastic/workflows) contains more than 50 examples you can use as a starting point. ## Related pages - [Tools overview](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7588/explore-analyze/ai-features/agent-builder/tools) - [Workflow tools](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7588/explore-analyze/ai-features/agent-builder/tools/workflow-tools) - [Workflows](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7588/explore-analyze/workflows) - [Agent Builder API](https://www.elastic.co/docs/api/doc/kibana/group/endpoint-agent-builder)