Type to search.

Get started with Elastic Agent Builder

Serverless

Elastic Cloud Serverless projects are autoscaled environments, fully managed by Elastic and available on Elastic Cloud.

Availability

  • Generally available

    This functionality is generally available and ready for production usage.

Serverless interfaces and procedures might differ from classic Elastic Stack deployments.

Stack GA 9.3+ …

The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats.

Availability

  • Generally available since 9.3

    This functionality is generally available and ready for production usage.

  • Preview in 9.2

    This functionality is in technical preview and is ready for evaluation. Use with caution in production; it is not recommended for mission-critical workloads. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Specific Support terms apply.

Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments.

This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

To start using Elastic Agent Builder you need to deploy Elasticsearch and Kibana.

If you don't already have an Elastic deployment, you can start a free trial or refer to Elastic deployment options > Choosing your deployment type.

Important

This feature requires the appropriate Elastic Stack subscription or Serverless project feature tier.

  1. Access Elastic Agent Builder

    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, replacing AI Assistant. You can access it from multiple entry points:

    • Select the Agent Builder card on the Elasticsearch home page.
    • Click Agents in the navigation menu.
    • Click the AI Agent button in the top-right header to start a conversation from any page.
    • Open the Agent builder API tutorial from the Kibana Getting started page, under Explore the API.
    Elastic Observability and Elastic Security solution views

    Elastic Agent Builder is enabled by default, replacing AI Assistant. You can access it from two entry points:

    • Click Agents in the navigation menu.
    • Click the AI Agent button in the top-right header to start a conversation from any page.
    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.

    You can also search for Agents in the global search field.

    Elastic Agent Builder is the default chat experience in all serverless project types.

    Elasticsearch Serverless

    You can access Elastic Agent Builder from multiple entry points in the UI:

    • Select the Elastic Agent card on the Elasticsearch home page.
    • Click Agents in the navigation menu.
    • Click the AI Agent button in the top-right header to start a conversation from any page.
    • Open the Build a chat tool with Agent Builder API tutorial from the Kibana Getting started page, under Explore the API.
    Elastic Observability Serverless and Elastic Security Serverless

    Elastic Agent Builder is enabled by default, replacing AI Assistant. Click the AI Agent button in the top-right header to start a conversation from any page.

    You can also search for Agents in the global search field.

    Stack GA 9.3+ … Previous versions

    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, replacing Search Assistant. You can access it from multiple entry points:

    • Select the Agent Builder card on the Elasticsearch home page.
    • Click Agents in the navigation menu.
    • Click the AI Agent button in the top-right header to start a conversation from any page.
    • Open the Agent builder API tutorial from the Kibana Getting started page, under Explore the API.
    Elastic Observability and Elastic Security solution views

    You must switch from AI Assistant to Agent Builder to enable the feature. Once enabled, find Agents in the navigation menu.

    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.

    You can also search for Agents in the global search field.

    2. Note

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

  2. Ingest data into Elasticsearch

    If you already have data in Elasticsearch, skip ahead to start a conversation.

    If you need to add data first, choose the path that fits:

    Use sample data

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

    Bring your own data

    If you already have data, you can:

  3. Start a conversation

    The Agent Chat UI provides a conversational interface where you can interact with agents and explore your data using natural language. The default Elastic AI Agent is ready to use immediately.

    Use chat to ask questions, request data analysis, try built-in skills, or create dashboards and visualizations. You can also invoke a specific skill with a slash command, inspect the agent's reasoning and tool calls, and confirm any proposed write actions before changes are applied.

    Learn more in Agent Chat.

  4. Enable experimental features (optional)

    Some Elastic Agent Builder features are experimental and hidden by default. Turn on the agentBuilder:experimentalFeatures advanced setting in Kibana to try them before they're generally available.

  5. Configure model (optional)

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

  6. Build skills, tools, and agents

    After you test the default Elastic AI Agent, create a custom skill for a specific workflow. Skills package task-specific instructions, context, and the tools needed to complete the workflow.

    Add tools when the skill needs to retrieve data, run queries, call APIs, or take action. Create a custom agent when you need a distinct persona, system prompt, model configuration, or set of enabled skills. You don't need a separate agent for every workflow: a single agent can use skill descriptions to choose the right skills and tools for the user's request. Note that custom agents don't include Elastic capabilities by default — enable the toggle to assign all Elastic-built tools, skills, and plugins automatically.

    To build programmatically, try the Elastic Agent Builder API tutorial or explore the Kibana APIs.

Tip

For solution-specific guidance, refer to Agent Builder for Observability and Agent Builder for Elastic Security.