> For the complete documentation index, see [llms.txt](https://docs.cloud.deepset.ai/llms.txt)

Last modified: 2026-10-13

# Building AI Agents

Design, build, and deploy secure and efficient AI agents using Haystack Enterprise Platform.

* * *

## About This Task

In Haystack Enterprise Platform, you can build AI agents using the `Agent` component incorporated into a pipeline. The `Agent` is a pipeline component that uses an LLM to call tools and reason about its actions. You can include multiple Agents in a pipeline and connect them to other components to build complex systems.

### When to Use an Agent

Building an AI Agent makes sense for the following use cases:

-   Multi-step tasks that require reasoning and decision-making. Cases when you can't predict the exact sequence of steps and the tools to use at each step. Examples:
    -   Debugging code where the Agent needs to make hypotheses and try different solutions based on what it discovers.
-   Tool orchestration where tasks require coordinating multiple tools or APIs. Examples:
    -   An Agent deciding whether to query a database, search the web, or call an API based on the user's question.
-   Dynamic planning when the path to the solution varies based on the user's input. Examples:
    -   Customer support Agents that need to check the order status, process returns, or answer questions about the product based on the user's input.

### When an Agent Might Be Too Complex

An Agent is a powerful tool but for some use cases it might be an overkill. Consider using a simpler alternative if:

-   The workflow is predictable. You can map out the logic and steps in advance.
-   Your application must be fast. Agents require multiple LLM calls which increases the response time.
-   Your application must be predictable and highly reliable. Agents are less predictable and may be harder to control and debug.

For these use cases, a pipeline with tool calling or conditional routing may be a better fit. For approaches alternative to Agents, see [Agentic Pipelines](https://docs.cloud.deepset.ai/docs/agentic-pipelines.md).

# Build an Agent

1.  [Build a minimal Agent pipeline.](https://docs.cloud.deepset.ai/docs/creating-minimal-agent.md)
2.  [Configure the Agent's model, prompt, and tools.](https://docs.cloud.deepset.ai/docs/configuring-agent.md)
3.  [Configure the Agent's Advanced Settings](https://docs.cloud.deepset.ai/docs/configuring-agent-advanced.md)
4.  [Add skills to an Agent.](https://docs.cloud.deepset.ai/docs/add-skills-to-an-agent.md#add-a-skill)

## Tutorials

-   [Building a Deal Desk Agent with Search and Custom Code](https://docs.cloud.deepset.ai/docs/tutorial-building-an-agent-with-tools.md) — Build an agent that searches pricing policy documents and applies discount approval rules with a custom code tool.
-   [Building an IT Helpdesk Agent with Multiple Knowledge Bases](https://docs.cloud.deepset.ai/docs/tutorial-building-helpdesk-agent.md) — Build an agent that routes employee questions to the right knowledge base using two document search pipeline tools.
