Skip to content

Update Agent Builder landing page and get-started#5669

Open
charlotte-hoblik wants to merge 3 commits intomainfrom
agent-builder/pm-feedback-landing-get-started
Open

Update Agent Builder landing page and get-started#5669
charlotte-hoblik wants to merge 3 commits intomainfrom
agent-builder/pm-feedback-landing-get-started

Conversation

@charlotte-hoblik
Copy link
Copy Markdown
Contributor

This PR:

  • Rewrites the landing page opening paragraph
  • Name the default Elastic AI Agent in the get-started
  • Add a tip about cloning the default agent as a starting point for custom agents

Context

These changes are the result of reviewing PM feedback on the Agent Builder
landing page (elastic-agent-builder.md) and get-started page (get-started.md).

Connected to: https://github.com/elastic/docs-content-internal/issues/855

@charlotte-hoblik charlotte-hoblik self-assigned this Mar 30, 2026
@charlotte-hoblik charlotte-hoblik added the documentation Improvements or additions to documentation label Mar 30, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 30, 2026

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 30, 2026

Vale Linting Results

Summary: 1 warning, 1 suggestion found

⚠️ Warnings (1)
File Line Rule Message
explore-analyze/ai-features/agent-builder/get-started.md 43 Elastic.QuotesPunctuation Place punctuation inside closing quotation marks.
💡 Suggestions (1)
File Line Rule Message
explore-analyze/ai-features/agent-builder/get-started.md 115 Elastic.Clone Use clone only when referring to cloning a GitHub repository or creating a copy that is linked to the original. Often confused with 'copy' and 'duplicate'.

The Vale linter checks documentation changes against the Elastic Docs style guide.

To use Vale locally or report issues, refer to Elastic style guide for Vale.

@charlotte-hoblik charlotte-hoblik marked this pull request as ready for review March 30, 2026 12:32
@charlotte-hoblik charlotte-hoblik requested review from a team as code owners March 30, 2026 12:32
@@ -80,7 +89,7 @@ For a broader overview of ingestion options, go to [](/manage-data/ingest.md).

:::{tip}
If you're not ready to add your own data, you can:
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@charlotte-hoblik as we discussed with Deepti, let's refactor here and remove the tip:

Something like this with a quick ejector seat for people who already have data in ES.

Then 2 broad buckets:

  • Use sample data
  • BYO data
If you already have data in Elasticsearch, skip ahead to [next step](link).

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

**Use sample or synthetic data**
- Load [sample data](link) in Kibana.
- Generate synthetic financial data using this [Python tool](link)
  (requires your Elasticsearch URL and an API key).
- Follow the [Elastic Agent Builder API tutorial](link), which includes
  sample book data.

**Bring your own data**
- [Upload a file](link) through Kibana.
- For search-specific guidance, see [Ingest for search use cases](link).
- For a broader overview, see [Ingest: Bring your data to Elastic](link).

Make sure to link to the specific docs pages for the file upload and sample data, for example.

BTW it doesn't make sense to talk about the "Kibana home page" because this page must cater of all solution/project types and we can't assume users are in the ES UI.

:::{tip}
If you're not ready to add your own data, you can:
- Use the Elastic [sample data](/manage-data/ingest/sample-data.md).
- From the {{kib}} home page, select **Add data** to upload a file, load [sample data](/manage-data/ingest/sample-data.md), or create an empty index.
Copy link
Copy Markdown
Member

@leemthompo leemthompo Mar 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's not talk about the "Kibana home page", it's too confusing on many levels

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants