Loading

Get started with Elastic Agent Builder

To start using Elastic Agent Builder you need an Elasticsearch deployment. If you don't already have an Elasticsearch deployment, refer to Get started with search.

For Elastic Cloud Hosted deployments, make sure you are using the solution navigation instead of classic navigation. You can set up a new space to use the solution nav.

Agent Builder subscription requirements
  • Elastic Stack users: an Enterprise subscription.
  • Elastic Security Serverless users: the Security Analytics Complete or Elastic AI Soc Engine (EASE) feature tier.
  • Elastic Observability Serverless and Elasticsearch Serverless users: the Complete feature tier.

  1. Enable Elastic Agent Builder

    Elastic Agent Builder is enabled by default in serverless Elasticsearch projects.

    Find Agents in the navigation menu to begin using the feature, or search for Agents in the global search field.

    In Elastic Observability projects, you must switch from AI Assistant to Agent Builder to enable the feature.

    Once enabled, find Agents in the navigation menu to begin using the feature, or search for Agents in the global search field.

    In Elastic Security projects, you must switch from AI Assistant to Agent Builder to enable the feature.

    Once enabled, find Agents in the navigation menu to begin using the feature, or search for Agents in the global search field.

    On non-serverless deployments, Elastic Agent Builder availability depends on the navigation mode of your Kibana space:

    • Elasticsearch solution view: Elastic Agent Builder is enabled by default and appears in the side navigation. It replaces Search Assistant.
    • Elastic Observability and Elastic Security solution views: You must switch from AI Assistant to Agent Builder to enable the feature.
    • Classic view: Elastic Agent Builder appears in the side navigation under Elasticsearch. You can choose Agent Builder as your assistant through the initial selector or the chat experience switch.

    Find Agents in the navigation menu to begin using the feature, or search for Agents in the global search field.

    Note

    To learn about required privileges for Elastic Agent Builder, refer to Permissions and access control.

  2. Ingest some data

    Before you begin with agents, you need some data in Elasticsearch. Otherwise, you will be chatting to the underlying LLM without any retrieval-augmented context.

    To learn about adding data for search use cases, go to Ingest for search use cases. For a broader overview of ingestion options, go to Ingest: Bring your data to Elastic.

    Tip

    If you're not ready to add your own data, you can:

  3. Begin chatting

    The Agent Chat UI provides a conversational interface where you can interact with agents and explore your data using natural language. Elastic Agent Builder includes a default agent named Elastic AI Agent with access to all built-in tools, so you can begin chatting immediately.

    Learn more in Agent Chat.

  4. Configure model (optional)

    On Elastic Cloud Hosted and Elastic Cloud Serverless, Elastic Agent Builder comes with preconfigured models ready to use. To switch models or add your own, refer to model selection and configuration.

  5. Begin building agents and tools

    Once you've tested built-in agents with built-in Elastic tools, you can begin building your own agents with custom instructions and creating your own tools to assign them.