---
title: Get started with Elastic Agent Builder
description: Learn how to access Elastic Agent Builder, ingest data, and start chatting with AI agents.
url: https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5867/explore-analyze/ai-features/agent-builder/get-started
products:
  - Elastic Cloud Serverless
  - Elastic Observability
  - Elastic Security
  - Elasticsearch
  - Kibana
applies_to:
  - Elastic Cloud Serverless: Generally available
  - Elastic Stack: Generally available since 9.3, Preview in 9.2
---

# Get started with Elastic Agent Builder
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](https://cloud.elastic.co/registration) or refer to [Deploy > Choosing your deployment type](/elastic/docs-content/pull/5867/deploy-manage/deploy#choosing-your-deployment-type).
<admonition title="Admonition">
  This feature requires the appropriate Elastic Stack [subscription](https://www.elastic.co/pricing) or Serverless [project feature tier](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5867/deploy-manage/deploy/elastic-cloud/project-settings).
</admonition>

<stepper>
  <step title="Enable {{agent-builder}}">
    <applies-switch>
      <applies-item title="stack: ga 9.4+" applies-to="Elastic Stack: Planned">
        On non-serverless deployments, Elastic Agent Builder availability depends on the navigation mode of your Kibana space:
        <dropdown title="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**.
        </dropdown>

        <dropdown title="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.
        </dropdown>

        <dropdown title="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](/elastic/docs-content/pull/5867/explore-analyze/ai-features/ai-chat-experiences/ai-agent-or-ai-assistant#switch-between-chat-experiences).
        </dropdown>
        You can also search for **Agents** in the [global search field](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5867/explore-analyze/find-and-organize/find-apps-and-objects).
      </applies-item>

      <applies-item title="serverless: ga" applies-to="Elastic Cloud Serverless: Generally available">
        Elastic Agent Builder is the default chat experience in all serverless project types.
        <dropdown title="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**.
        </dropdown>

        <dropdown title="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.
        </dropdown>
        You can also search for **Agents** in the [global search field](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5867/explore-analyze/find-and-organize/find-apps-and-objects).
      </applies-item>
    </applies-switch>

    <note>
      To learn about required privileges for Elastic Agent Builder, refer to [Permissions and access control](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5867/explore-analyze/ai-features/agent-builder/permissions).
    </note>

    <dropdown title="Previous versions" applies-to="Elastic Stack: Generally available since 9.3, Elastic Stack: Preview in 9.2">
      On non-serverless deployments, Elastic Agent Builder availability depends on the navigation mode of your Kibana space:
      <dropdown title="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**.
      </dropdown>

      <dropdown title="Elastic Observability and Elastic Security solution views">
        You must [switch from AI Assistant to Agent Builder](/elastic/docs-content/pull/5867/explore-analyze/ai-features/ai-chat-experiences/ai-agent-or-ai-assistant#switch-between-chat-experiences) to enable the feature. Once enabled, find **Agents** in the navigation menu.
      </dropdown>

      <dropdown title="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](/elastic/docs-content/pull/5867/explore-analyze/ai-features/ai-chat-experiences/ai-agent-or-ai-assistant#switch-between-chat-experiences).
      </dropdown>
      You can also search for **Agents** in the [global search field](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5867/explore-analyze/find-and-organize/find-apps-and-objects).
    </dropdown>
  </step>

  <step title="Ingest data into Elasticsearch">
    If you already have data in Elasticsearch, skip ahead to [start a conversation](#start-a-conversation).If you need to add data first, choose the path that fits:
    <dropdown title="Use sample data">
      If you're not ready to add your own data, you can:
      - Load [sample data](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5867/manage-data/ingest/sample-data) in Kibana.
      - Generate synthetic financial data using [this Python tool](https://github.com/jeffvestal/synthetic-financial-data?tab=readme-ov-file#synthetic-financial-data-generator-). (This requires your [Elasticsearch URL and an API key](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5867/solutions/elasticsearch-solution-project/search-connection-details)).
      - Follow the [Elastic Agent Builder API tutorial](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5867/explore-analyze/ai-features/agent-builder/agent-builder-api-tutorial), which includes sample book data.
    </dropdown>

    <dropdown title="Bring your own data">
      If you already have data, you can:
      - [Upload a file](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5867/manage-data/ingest/upload-data-files) in the Kibana UI for quick testing.
      - Learn about your [ingestion options](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5867/manage-data/ingest) if you'd like to ingest larger datasets.
    </dropdown>
  </step>

  <step title="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.Learn more in [Agent Chat](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5867/explore-analyze/ai-features/agent-builder/chat).
  </step>

  <step title="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](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5867/explore-analyze/ai-features/agent-builder/models).
  </step>

  <step title="Begin building agents and tools">
    Once you've tested [built-in agents](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5867/explore-analyze/ai-features/agent-builder/builtin-agents-reference) with [built-in Elastic tools](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5867/explore-analyze/ai-features/agent-builder/tools), you can begin [building your own agents](/elastic/docs-content/pull/5867/explore-analyze/ai-features/agent-builder/custom-agents#create-a-new-agent) with custom instructions and [creating your own tools](/elastic/docs-content/pull/5867/explore-analyze/ai-features/agent-builder/tools/custom-tools#create-custom-tools-in-the-ui) to assign them. You can also clone the default `Elastic AI Agent` as a starting point for a custom agent.To build agents and tools programmatically, try the [Elastic Agent Builder API tutorial](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5867/explore-analyze/ai-features/agent-builder/agent-builder-api-tutorial) or explore the [Kibana APIs](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5867/explore-analyze/ai-features/agent-builder/programmatic-access).
  </step>
</stepper>