Skip to content

Conversation

@mdbirnstiehl
Copy link
Contributor

@mdbirnstiehl mdbirnstiehl commented Feb 5, 2026

Summary

Closes #4526. This PR adds Observability specific Agent Builder content and points users to the main docs. It also reorganizes the Observability AI information to allow for multiple AI uses.

Generative AI disclosure

  1. Did you use a generative AI (GenAI) tool to assist in creating this contribution?
  • Yes
  • No

Tool(s) and model(s) used: Cursor, claude 4.5 opus

@github-actions
Copy link
Contributor

github-actions bot commented Feb 5, 2026

Vale Linting Results

Summary: 20 suggestions found

💡 Suggestions (20)
File Line Rule Message
solutions/observability/ai/agent-builder-observability.md 27 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'.
solutions/observability/ai/agent-builder-observability.md 35 Elastic.Wordiness Consider using 'remove' instead of 'Eliminate'.
solutions/observability/ai/observability-ai-assistant.md 30 Elastic.WordChoice Consider using 'run, start' instead of 'execute', unless the term is in the UI.
solutions/observability/ai/observability-ai-assistant.md 60 Elastic.WordChoice Consider using 'deactivate, deselect, hide, turn off' instead of 'disable', unless the term is in the UI.
solutions/observability/ai/observability-ai-assistant.md 77 Elastic.WordChoice Consider using 'can, might' instead of 'may', unless the term is in the UI.
solutions/observability/ai/observability-ai-assistant.md 283 Elastic.Exclamation Use exclamation points sparingly. Consider removing the exclamation point.
solutions/observability/ai/observability-ai-assistant.md 344 Elastic.WordChoice Consider using 'run, start' instead of 'execute', unless the term is in the UI.
solutions/observability/ai/observability-ai-assistant.md 365 Elastic.WordChoice Consider using 'refer to (if it's a document), view (if it's a UI element)' instead of 'see', unless the term is in the UI.
solutions/observability/ai/observability-ai-assistant.md 405 Elastic.FirstPerson Avoid first-person pronouns such as ' I '.
solutions/observability/ai/observability-ai-assistant.md 435 Elastic.WordChoice Consider using 'can, might' instead of 'may', unless the term is in the UI.
solutions/observability/ai/observability-ai-assistant.md 450 Elastic.WordChoice Consider using 'can, might' instead of 'may', unless the term is in the UI.
solutions/observability/ai/observability-ai-assistant.md 455 Elastic.WordChoice Consider using 'cannot' instead of 'unable', unless the term is in the UI.
solutions/observability/ai/observability-ai-assistant.md 487 Elastic.WordChoice Consider using 'refer to (if it's a document), view (if it's a UI element)' instead of 'See', unless the term is in the UI.
solutions/observability/ai/observability-ai-assistant.md 498 Elastic.WordChoice Consider using 'deactivated, deselected, hidden, turned off, unavailable' instead of 'disabled', unless the term is in the UI.
solutions/observability/ai/observability-ai-assistant.md 506 Elastic.Semicolons Use semicolons judiciously.
solutions/observability/ai/observability-ai-assistant.md 535 Elastic.Semicolons Use semicolons judiciously.
solutions/observability/ai/observability-ai-assistant.md 565 Elastic.WordChoice Consider using 'can, might' instead of 'may', unless the term is in the UI.
solutions/observability/ai/observability-ai-assistant.md 575 Elastic.WordChoice Consider using 'can, might' instead of 'may', unless the term is in the UI.
solutions/security/ai/ai-assistant.md 48 Elastic.WordChoice Consider using 'deactivate, deselect, hide, turn off' instead of 'disable', unless the term is in the UI.
solutions/security/ai/ai-assistant.md 398 Elastic.WordChoice Consider using 'can, might' instead of 'may', unless the term is in the UI.

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.

@mdbirnstiehl mdbirnstiehl marked this pull request as ready for review February 5, 2026 19:42
@mdbirnstiehl mdbirnstiehl requested review from a team as code owners February 5, 2026 19:42
Copy link
Collaborator

@shainaraskas shainaraskas left a comment

Choose a reason for hiding this comment

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

link updates on pages I own look fine ✅

Copy link
Contributor

@leemthompo leemthompo left a comment

Choose a reason for hiding this comment

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

Copy link
Contributor

@florent-leborgne florent-leborgne left a comment

Choose a reason for hiding this comment

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

LGTM with Liam's comment

@mdbirnstiehl mdbirnstiehl enabled auto-merge (squash) February 9, 2026 16:43
@mdbirnstiehl mdbirnstiehl disabled auto-merge February 9, 2026 17:07
@mdbirnstiehl mdbirnstiehl merged commit 673faba into elastic:main Feb 9, 2026
10 of 12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Introduce agent builder in solution docs

4 participants