Agent

Add reasoning and external tools to your pipelines through the Agent component.

Basic Information

  • Type: haystack.components.agents.agent.Agent
  • Components it can connect with:
    • To pass a query to an Agent, use OutputAdapter, DeepsetChatHistoryParser, or ChatPromptBuilder. ChatPromptBuilder also lets you pass dynamic content to the Agent.
    • To make the Agent's response the final output of your pipeline, use an OutputAdapter to convert the Agent's messages into a list of strings and send them on to DeepsetAnswerBuilder.
    • The connections depend on the output and input types configured in the Agent's state_schema.

Inputs

Required Inputs

NameTypeDescription
messagesList of ChatMessage objectsThe list of ChatMessages to process.
Required.

Optional Inputs

NameTypeDefaultDescription
streaming_callbackUnion[SyncStreamingCallbackT, AsyncStreamingCallbackT]NoneA callback function for streaming responses. Can be sync or async, depending on whether you're running the pipeline in sync or async mode.
kwargsDictionaryAdditional inputs forwarded to the Agent's state.

Outputs

TypeDescription
DictionaryDictionary containing messages and outputs matching the defined output types. If you want the Agent to produce additional structured outputs (for example, retrieved documents), you define them in state_schema.

Unlike a ChatGenerator, which returns only the final message, the Agent returns all messages generated during the process. This includes the messages provided as input.

Overview

Agent is designed to help AI systems use tools to accomplish tasks. You can think of it like a coordinator that manages conversations and knows when and how to use different tools.

Key features:

  • Works with different LLMs.
    You can configure the model through an underlying ChatGenerator.
  • Can use external tools.
    The tools include pipeline components, entire pipelines, and custom functions.
  • Lets you define custom exit conditions.
    Exit conditions specify when the Agent should stop, for example, after generating text or using a specific tool.
  • Maintains conversation history.
    The Agent keeps track of events during a single interaction. To maintain context across multiple queries (like in a real chat), use the deepset Chat endpoint or DeepsetChatHistoryParser.
  • Allows real-time streaming responses.
    Streaming is supported for both sync and async mode.
  • Has tracing support.
    Connect a tracer like Langfuse or Weights & Biases Weave to monitor the Agent’s execution in depth.

How It Works

  1. The Agent receives a message from the user.
  2. It sends the message to its chat model (ChatGenerator), along with the list of tools.
  3. The model decides whether it needs to call tools or can answer right away. It responds with either plain text (the final response) or a tool call.
    1. If the response is just text, the Agent returns the current conversation and the response.
    2. If the response includes a tool call:
      1. The Agent calls the tool and collects the result.
      2. If the tool has outputs_to_state defined, the Agent adds the specified tool result to the state.
      3. The Agent adds the result to the conversation history.
  4. Then:
    1. If the tool name matches an item of the exit_conditionslist, the Agent exits and returns the conversation.
    2. If it doesn't match, the Agent continues. It sends the updated conversation back to the model. The model may decide to call another tool or the same one again. This loop continues until one of the exit_conditions is met or max_agent_steps is reached.

Configuration

To configure an Agent, you need to provide:

  • A chat model: Supplied through an underlying ChatGenerator, which processes and generates text. The Agent is provider-agnostic, so it can work with any model. Make sure you choose a ChatGenerator that works with the desired model and supports tool calls.
  • A list of tools These can be custom tools for a specific use case, pipeline components, pipelines, or MCP tools.
  • Exit conditions: Defined using exit_conditions. The Agent runs iteratively—calling tools and feeding their outputs back to the model—until one of these conditions is met. For example, you can configure it to stop after a tool is used or once the model returns a text response.

You configure the Agent in YAML.

State Schema

The state_schema Agent parameter lets you define extra inputs for tools—beyond what the LLM generates—and collect additional outputs from them. This is useful when some tool parameters come from outside the LLM (for example, user credentials) or when you need to accumulate tool results (such as a growing list of retrieved documents).

To define the state schema, use the following format:

state_key_name:
  type: <type>

For example, this is the state schema with two items retrieved_documents and repository:

retrieved_documents:
  type: typing.List[haystack.dataclasses.Document]
repository:
  type: str

📘

Type Mismatch

If a tool's output is incompatible with the type you specified in state_schema, you may encounter an error or unexpected behavior. Make sure the types align.

Messages from a single Agent execution are automatically part of the Agent's schema.

Using Schema to Pass Arguments to Tools

Tools can automatically receive arguments from the Agent's state if their run() method defines parameters with matching names.

For example, if you define a repositoryfield of type string in your state_schema and the tool's run() method includes a repository: str argument, the Agent automatically fills that parameter from the state_schema.

You can also explicitly map state attributes to tool parameters by using the inputs_from_state setting when configuring the tool. This mapping uses the format: state_attribute_name: tool_parameter_name.

For example, the following configuration passes the repository value from the Agent's state to the tool's repository_name parameter:

- data
   component:
     init_parameters:
       parameter: value
   type: component_type
   description: Here comes the description of the tool
   name: tool_name
   inputs_from_state:
     repository: repository_name # the tool's `repository` argument will be filled in with the state's `repository` attribute
      ...

📘

Explicit Mapping Limits

When you explicitly map tool inputs using inputs_from_state, the tool only receives the attributes you specify.
Even if the state_schema contains additional attributes, the tool will not have access to them unless they are explicitly mapped.

If the tool needs other arguments at runtime, those arguments must come from the LLM’s output. Otherwise, the tool will not receive them.

If both the LLM and the state contain a value for the same parameter, the LLM's value takes precedence.

Using Schema to Accumulate Tool Outputs

By default, when an Agent uses a tool, all its outputs are converted to strings and appended as a single ChatMessage with the tool role. This approach ensures that every tool result is recorded in the conversation history, making it available for the LLM in the next turn.

When a tool runs multiple times, only the outputs from the last run are included. To accumulate outputs across runs, you can define them in the state_schema, specifying the output names, their types, and optionally, a handler function.

By default, outputs are merged based on their declared types:

  • List: If the tool output is a list, it's extended using the list.extend function. If the output is not a list, the value is appended to the existing list.
  • Other types: The existing value is replaced with the new one.

You can also explicitly specify which tool outputs to add to the schema using the outputs_to_state parameter. Each entry should include:

  • state_key: The name under which the data will be stored in the Agent's state.
  • source: The specific output field from the tool's result you want to store. If you don't specify a source, the entire output from the tool is added to the state.

Here's an example of how to add documents resulting from a tool call to the Agent's schema:

- data
    component:
      init_parameters:
       parameter: value
    type: component_type
    description: Here comes the description of the tool
    name: tool_name
    outputs_to_state: 
      retrieved_documents: # key of the attribute in state_schema
        source: documents # defines the output to store
        

System Prompt

You can optionally configure a system prompt for the Agent to provide fixed instructions that guide its behavior, tone, or knowledge throughout the conversation. The system prompt only supports static content. It's plain text.

Adding Dynamic Content to the System Prompt

To include dynamic content, such as variables, in the system prompt, use a ChatPromptBuilder and connect it to the Agent. The template parameter accepts a list of ChatMessage objects. Each ChatMessage includes a content field, which can contain a text key. This text value supports Jinja2 templating, allowing you to dynamically insert variables and logic into the message content.

For detailed instructions and examples of how to write prompts, see Writing Prompts in deepset AI Platform.

Agent and Tools

Agents can use individual pipeline components—or even entire pipelines—as tools. This section explains how to configure both options.

Using Pipeline Components as Tools with ComponentTool

To make a component available to an Agent, wrap it with haystack.tools.component_tool.ComponentTool. This makes a component callable by the Agent.

When configuring a ComponentTool, you can control how it interacts with the Agent using the following settings:

  • name: The name of the tool. You can refer to this name in the Agent's prompt.
  • description: The description that helps the Agent decide when to use the tool.
  • inputs_from_state: A mapping of keys from the Agent’s state to the tool’s input parameter names. This tells the tool where to retrieve its inputs from in the Agent’s memory. For details, see Using Schema to Pass Inputs to Tools.
  • outputs_to_state: A mapping of the tool’s output fields to keys in the Agent’s state. This determines how the tool’s results are stored for later use. For details, see Using Schema to Accumulate Tool Outputs.
  • parameters: A JSON schema of the inputs the tool expects. If not provided, the Agent infers the tool's inputs from its run() method. See Usage Examples for examples of how to use this parameter.

For detailed explanation of parameters, see Component Tool Parameters.

Using Pipelines as Tools with SuperComponent

To use an entire pipeline as a tool, you first need to make it callable by setting its type to haystack.tools.component_tool.ComponentTool. Then, define the pipeline as a component inside ComponentTool, wrapping it with a SuperComponent by setting its type to haystack.core.super_component.super_component.SuperComponent. SuperComponent runs the pipeline internally and manages input and output mappings. It automatically matches received arguments to the inputs of the pipeline’s components and collects outputs from the final components.

You can also explicitly configure input and output mappings:

  • input_mapping Maps the Agent’s input fields to specific component inputs within the pipeline used as a tool.
    For example, you can indicate that the query_embedder's text input should receive the query input as follows:

    input_mapping:
      query:
        - query_embedder.text
    
    
  • output_mapping Specifies which outputs from the pipeline should be returned to the Agent, and under what names.
    For example, this configuration returns the retriever's documents output under the label retrieved_documents. The label is the label that will be used to store the documents in the Agent's state:

    output_mapping:
      retriever.documents: retrieved_documents
    

Check the Usage Examples section below for more examples.

Usage Examples

Agent Configuration

In this example, the Agent:

  • Uses AnthropicChatGenerator. Note that you pass the generator's init parameters and type in the configuration.
  • Stops when the LLM generates text without tool calls (exit_conditions: ['text']).
  • Has streaming enabled using:streaming_callback: deepset_cloud_custom_nodes.callbacks.streaming.streaming_callback. Note that you enable the streaming for the Agent, not the ChatGenerator it uses.
  • Includes a system prompt with instructions on how to answer queries and use tools.
  • Defines a state_schemawith a list of Document objects. Tools can read from and write to these documents. For instance, if a web_search tool retrieves documents, they are saved under documents in the Agent’s state. These documents are then available as the Agent’s output and can be sent to the AnswerBuilder.
  • Uses the SerperDevWebSearch component as a tool. To use a pipeline component as a tool, set its type to haystack.tools.component_tool.ComponentTool. Then, wrap the tool init parameters in the data object. You configure the tools for the Agent the same way as you do for ToolInvoker. For details and examples of how to configure tools, see ToolInvoker documentation.
  • The Agent is connected to other components in the pipeline with its messages input and documents output (defined in state_schema). The Agent also sends its messages output to the Adapter.
components:
  agent:
    type: haystack.components.agents.agent.Agent
    init_parameters:
      chat_generator:
        init_parameters: # here you configure the ChatGenerator
          api_key:
            env_vars:
            - ANTHROPIC_API_KEY
            strict: false
            type: env_var
          generation_kwargs:
            max_tokens: 8000
          ignore_tools_thinking_messages: true
          model: claude-3-7-sonnet-latest
        type: haystack_integrations.components.generators.anthropic.chat.chat_generator.AnthropicChatGenerator
      exit_conditions: ['text'] # this tells the Agent to stop once it receives text from the LLM, without tool calls
      max_agent_steps: 100
      raise_on_tool_invocation_failure: false
      streaming_callback: deepset_cloud_custom_nodes.callbacks.streaming.streaming_callback # enables streaming for the Agent
      system_prompt: |-
        You are a deep research assistant.
        You create comprehensive research reports to answer the user's questions.
        You use the 'search'-tool to answer any questions.
        You perform multiple searches until you have the information you need to answer the question.
        Make sure you research different aspects of the question.
        Use markdown to format your response.
        When you use information from the websearch results, cite your sources using markdown links.
        It is important that you cite accurately.
      state_schema: # define the data the components will have access to
        documents: # here, we're giving the web_search component access to the documents
          type: typing.List[haystack.dataclasses.Document]
      tools:
      - type: haystack.tools.component_tool.ComponentTool # this is the type you use to configure pipeline components as tools
        data: # wrap the component configuration in the data object
          component: # specify the tool type, for pipeline components, it's `component`
            type: haystack.components.websearch.serper_dev.SerperDevWebSearch # this is the component import path or type
            init_parameters: # pass the component configuration here
              api_key:
                type: env_var
                env_vars:
                - SERPERDEV_API_KEY
                strict: false
              top_k: 10
          name: web_search # give the tool a name, you can use this name as the exit condition
          description: Search the web for current information on any topic # describe what the tool does, this can help the model to decide when and if to use the tool

  answer_builder:
    init_parameters:
      pattern:
      reference_pattern:
    type: haystack.components.builders.answer_builder.AnswerBuilder
    
  history_parser:
    init_parameters: {}
    type: dc_custom_component.components.parsers.chat_history_parser.DeepsetChatHistoryParser
    
  adapter:
    init_parameters:
      custom_filters: {}
      output_type: typing.List[str]
      template: '{{ [(messages|last).text] }}'
      unsafe: false
    type: haystack.components.converters.output_adapter.OutputAdapter

connections:
- receiver: agent.messages # agent's input is always `messages`
  sender: history_parser.messages
- receiver: adapter.messages
  sender: agent.messages
- receiver: answer_builder.replies
  sender: adapter.output
- sender: agent.documents # this is because the Agent has `documents` defined in its state_schema
  receiver: answer_builder.documents

inputs:
  query:
  - answer_builder.query
  - history_parser.history_and_query

outputs:
  answers: answer_builder.answers

  documents: agent.documents

pipeline_output_type: chat

max_runs_per_component: 100

metadata: {}

Adding a Pipeline as a Tool

This is an example of an Agent with two tools: an internal search and a weather forecaster tool. Both are pipelines wrapped in SuperComponent. Note that the "weather_forecaster" tool also has parameters to define the JSON structure illustrating the inputs the tool expects.

components:
  agent:
    type: haystack.components.agents.agent.Agent
    init_parameters:
      chat_generator:
        init_parameters: # here you configure the ChatGenerator
          api_key:
            env_vars:
            - ANTHROPIC_API_KEY
            strict: false
            type: env_var
          generation_kwargs:
            max_tokens: 8000
          ignore_tools_thinking_messages: true
          model: claude-3-7-sonnet-latest
        type: haystack_integrations.components.generators.anthropic.chat.chat_generator.AnthropicChatGenerator
      exit_conditions: ['text'] # this tells the Agent to stop once it receives text from the LLM, without tool calls
      max_agent_steps: 100
      raise_on_tool_invocation_failure: false
      streaming_callback: deepset_cloud_custom_nodes.callbacks.streaming.streaming_callback # enables streaming for the Agent
      system_prompt: |-
        You are a professional trip planner.
  	You perform comprehensive research to help users plan their travels.
  	Use the 'travel_guide_search' tool to find reliable information and advice about the 		destination.
  	Use the 'weather_tool' to check the current weather forecast for the city.
  	Research different aspects of the question (culture, safety, transport, events, weather).
  	Use markdown to format your response.
  	When you use information from the travel guide results, cite your sources using markdown links.
  	It is important that you cite accurately.
      state_schema: # define the data the components will have access to
        documents: # here, we're giving the tools access to the documents
          type: typing.List[haystack.dataclasses.Document]
      tools:
      - type: haystack.tools.component_tool.ComponentTool # we wrap the SuperComponent in ComponentTool
        data: # this is a necessary object always added for ComponentTool
          component: # we indicate this is a component
            init_parameters: #we're configuring the component
              input_mapping: # here we list the components that will receive query and filters as input together with their input connections
                query:
                - query_embedder.text
                - OpenSearchBM25Retriever.query
                - ranker.query
                filters:
                - OpenSearchBM25Retriever.filters
                - OpenSearchEmbeddingRetriever.filters
              output_mapping: # here we're saying the ranker's documents output will have the label documents
                ranker.documents: documents
              pipeline: # this is the pipeline configuration
                components:
                  query_embedder:
                    init_parameters:
                      model: intfloat/e5-base-v2
                      truncate: END
                    type: deepset_cloud_custom_nodes.embedders.nvidia.text_embedder.DeepsetNvidiaTextEmbedder
                  OpenSearchBM25Retriever:
                    init_parameters:
                      document_store:
                        type: haystack_integrations.document_stores.opensearch.document_store.OpenSearchDocumentStore
                        init_parameters:
                          hosts:
                          index: default_index
                          embedding_dim: 768
                          return_embedding: false
                          max_chunk_bytes: 104857600
                          create_index: true
                      filters:
                      fuzziness: AUTO
                      top_k: 20
                    type: haystack_integrations.components.retrievers.opensearch.bm25_retriever.OpenSearchBM25Retriever
                  OpenSearchEmbeddingRetriever:
                    init_parameters:
                      document_store:
                        type: haystack_integrations.document_stores.opensearch.document_store.OpenSearchDocumentStore
                        init_parameters:
                          hosts:
                          index: default_index
                          embedding_dim: 768
                          return_embedding: false
                          max_chunk_bytes: 104857600
                          create_index: true
                      filters:
                      top_k: 20
                      efficient_filtering: false
                    type: haystack_integrations.components.retrievers.opensearch.embedding_retriever.OpenSearchEmbeddingRetriever
                  document_joiner:
                    init_parameters:
                      join_mode: concatenate
                    type: haystack.components.joiners.document_joiner.DocumentJoiner
                  ranker:
                    init_parameters:
                      model: intfloat/simlm-msmarco-reranker
                      top_k: 2
                    type: deepset_cloud_custom_nodes.rankers.nvidia.ranker.DeepsetNvidiaRanker
                connection_type_validation: true
                connections:
                - receiver: OpenSearchEmbeddingRetriever.query_embedding
                  sender: query_embedder.embedding
                - receiver: document_joiner.documents
                  sender: OpenSearchBM25Retriever.documents
                - receiver: document_joiner.documents
                  sender: OpenSearchEmbeddingRetriever.documents
                - receiver: ranker.documents
                  sender: document_joiner.documents
                max_runs_per_component: 100
                metadata: {}
            type: haystack.core.super_component.super_component.SuperComponent # this indicates the pipeline is wrapped in a SuperComponent
          description: A tool to search travel guides, tips, and advice for specific destinations or travel topics.
          outputs_to_state: # here we're listing the outputs of the tool to be added to the Agent's state
            documents:
              source: documents
          name: travel_guide_search
          parameters: # this gives the LLM a schema of the inputs the tool expects: it must receive the query of type string, no additional properties are allowed.
            type: object
            properties:
              query:
                type: string
                description: The search query
            required:
            - query
            additionalProperties: false
     - type: haystack.tools.component_tool.ComponentTool
       data:
         component:
           init_parameters:
             input_mapping:
               city:
               - weather_retriever.city
             output_mapping:
               weather_formatter.prompt: result
             pipeline:
               components:
                 weather_retriever:
                   init_parameters:
                     api_url: https://api.weatherapi.com/v1/current.json
                     lang: en
                     timeout: 10
                   type: dc_custom_component.components.retrievers.weather_data_retriever.DeepsetCurrentWeatherRetriever
                 weather_formatter:
                   init_parameters:
                     template: "This is the weather information for the named location:\n{{ weather_data }}\nUse these weather conditions when answering."
                   type: haystack.components.builders.prompt_builder.PromptBuilder
                connection_type_validation: true
                connections:
                - receiver: weather_formatter.weather_data
                  sender: weather_retriever.weather
                max_runs_per_component: 100
                metadata: {}
            type: haystack.core.super_component.super_component.SuperComponent
          description: A tool to get the weather at the specified location. It takes a city name as input and returns the current weather for that city as a formatted string in English.
          name: weather_tool
          parameters:
            type: object
            properties:
              city:
                type: string
                description: The city name to get the weather for.
            required:
            - city
            additionalProperties: false
            

Passing a Query to the Agent

The Agent expects a list of messages as input. However, the Query component outputs plain text. To bridge this gap, you can use the DeepsetChatHistoryParser component.

DeepsetChatHistoryParser takes the text from Query and converts it into a list of ChatMessage objects. Simply connect Query to DeepsetChatHistoryParser, and then connect its output to the Agent.

Agent receiving the query through deepsetchathistoryparser

Displaying the Agent Results

The Agent returns a list of ChatMessages, but in most cases, you only need the last message as the final output of your pipeline. To extract just the last message, use the OutputAdapter component. Configure it to:

  • Take the Agent's output (a list of ChatMessages)
  • Convert only the last message into a list of strings

This format is compatible with downstream components like the AnswerBuilder. Simply connect the Agent to the OutputAdapter, and then connect the adapter's output to the AnswerBuilder.

Agent sending its output messages to an OutputAdapter which converts them into a list of strings and sends to AnswerBuilder

This is how to configure OutputAdapter for this scenario:

  adapter:
    init_parameters:
      output_type: List[str] # this is the output type an AnswerBuilder accepts
      template: '{{ [(messages|last).text] }}' # here you're pointing to the last message the Agent returned
    type: haystack.components.converters.output_adapter.OutputAdapter

Adding Sources to Agent Results

To show the sources or documents the Agent used to generate it answer, configure the Agent to output those documents. You do this by adding documents to the Agent's state_schema:

      state_schema: 
        documents: # this becomes the name of the output connection
          type: List[haystack.Document] # here you define what's sent there
The state schema configuration window in builder

The Agent then outputs the documents through its output connection called documents. You can connect an AnswerBuilder to the Agent's documents to add documents to the final answer:

connections:
- receiver: agent.messages
  sender: history_parser.messages
- receiver: adapter.messages
  sender: agent.messages
- receiver: answer_builder.replies
  sender: adapter.output
- sender: agent.documents # we're sending the documents to DeepsetAnswerBuilder
  receiver: answer_builder.documents

inputs:
  query:
  - answer_builder.query
  - history_parser.history_and_query

outputs:
  answers: answer_builder.answers 

  documents: agent.documents # the final output also includes the Agent's documents

Agent Parameters

Init Parameters

These are the parameters you can configure in Pipeline Builder:

ParameterTypePossible ValuesDescription
chat_generatorOpenAIChatGenerator,
AnthropicChatGenerator (check usage examples for details)
The chat generator that the agent will use. Currently, OpenAIChatGenerator and AnthropicChatGenerator are supported. You configure the generator by passing its init parameters and type to the Agent. Check the Usage Example section for details.
Required.
toolsList of Tool objectsDefault: NoneThe external tools that the agent can invoke.
Optional
system_promptString System-level prompt to guide the agent's behavior.
Optional.
exit_conditionsList os stringsDefault:None Defines when the agent stops processing messages. Pass text to stop the Agent when it generates a message without tool calls.
Pass the name of a tool to stop the Agent after it runs this tool.
Required.
state_schemaDictionaryDefault: NoneOptional schema for managing the runtime state used by tools. It defines extra information—such as documents or context—that tools can read from or write to during execution. You can use this schema to pass parameters that tools can both produce and consume during a call. This means that when a pipeline runs, tools can read from the Agent's state (for example, the current set of retrieved documents) and write into or update this state as they run.
Optional
max_agent_stepsIntegerDefault: 100Maximum number of execution cycles per component. The Agent raises an exception if a component exceeds the maximum number of runs.
Required.
raise_on_tool_invocation_failureBooleanTrue or False
Default: False
Whether to raise an error when a tool call fails. If set to False, the exception is turned into a chat message and passed to the LLM.
Required.
streaming_callbackdeepset_cloud_custom_nodes.callbacks.streaming.streaming_callback
Default: None
Function invoked for streaming responses. To enable streaming, set streaming_callback to deepset_cloud_custom_nodes.callbacks.streaming.streaming_callback.
To learn more about streaming, see Enable Streaming.
Optional.

Run Method Parameters

These are the parameters you can configure for the component's run() method. This means you can pass these parameters at query time through the API, in Playground, or when running a job. For details, see Modify Pipeline Parameters at Query Time.

Run() method parameters take precedence over initialization parameters.

ParameterTypePossible ValuesDescription
messagesList of ChatMessage objectsThe conversation history to process.
Required.
streaming_callbackSyncStreamingCallbackDefault: NoneFunction to handle streamed responses.
Optional.
kwargsDictionaryAdditional parameters to pass to the Agent's state_schema. The keys must match the schema defined in the Agent's state_schema.
Required.

ComponentTool Parameters

Init Parameters

These are the parameters you can configure in Pipeline Builder:

ParameterTypePossible ValuesDescription
componentComponentThe pipeline component to wrap as a tool. Provide the component type and init parameters. See the Usage Examples for examples and the format to use.
Required.
nameStringDefault: NoneThe name of the tool. Helps the Agent to decide which tool to use. You can also refer to it in the prompt.
Optional.
descriptionStringDefault: NoneTool description. Helps the Agent decide when to use the tool.
Optional.
parametersDictionary of string and anyDefault: NoneA JSON schema defining the parameters the tool expects. If not provided, relies on the parameters defined in the component's run() method.
Use the following format:
parameters: type: object properties: input_field_name: type: input_field_type description: field_description required: - input_field_name additionalProperties: false

For examples, see the Usage Examples section with examples for using pipelines as tools.

Optional.
outputs_to_stringDictionaryDefault: NoneDefines how a tool's outputs should be converted into a string. If the source is provided, only the specified output key is sent to the handler.
If the source is omitted, the whole tool result is sent to the handler.
Example:
outputs_to_string: source: docs handler: format_documents
Note: You must upload the handler function as a custom component.
Optional.
inputs_from_stateDictionaryDefault: NoneMaps state keys to tool parameter names to indicate which parameters should be filled in by items stored in the Agent's state.
Example:
inputs_from_state: repository: repo
This means the tool's repo parameter will be filled in by the state's repository.
Optional.
outputs_to_stateDictionaryDefault: NoneMaps tool's outputs to keys in the Agent's state. This determines how the tool results are stored in the state.
Example:
outputs_to_state: retrieved_documents: source: documents
This means the tool's documents output will be stored under the key retrieved_documents in the Agent state. If you skip source, the entire output of the tool is stored under the specified key in the state.
Optional.