Add Agent Builder glossary by charlotte-hoblik · Pull Request #6175 · elastic/docs-content

charlotte-hoblik · 2026-04-28T06:48:18Z

Adds a new glossary.md page under explore-analyze/ai-features/agent-builder/ covering the terminology used across the Agent Builder docs. Entries are alphabetical, in definition-list format, with inline applies_to badges for terms scoped to specific versions.

URL preview: https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/6175/explore-analyze/ai-features/agent-builder/glossary

Closes https://github.com/elastic/docs-content-internal/issues/1059

Generative AI disclosure

Did you use a generative AI (GenAI) tool to assist in creating this contribution?

Yes
No

If you answered "Yes" to the previous question, please specify the tool(s) and model(s) used (e.g., Google Gemini, OpenAI ChatGPT-4, etc.).

Tool(s) and model(s) used:
Opus 4.7

github-actions · 2026-04-28T06:48:42Z

Elastic Docs AI PR menu

Check the box to run an AI review for this pull request.

Review docs changes (docs-review). Status: queued.

Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team.

github-actions · 2026-04-28T06:50:10Z

🔍 Preview links for changed docs

github-actions · 2026-04-28T06:50:17Z

Vale Linting Results

Summary: 1 warning, 1 suggestion found

⚠️ Warnings (1)

File	Line	Rule	Message
explore-analyze/ai-features/agent-builder/glossary.md	223	Elastic.Latinisms	Latin terms and abbreviations are a common source of confusion. Use 'versus' instead of 'VS'.

💡 Suggestions (1)

File	Line	Rule	Message
explore-analyze/ai-features/agent-builder/glossary.md	49	Elastic.Semicolons	Use semicolons judiciously.

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.

github-actions

Docs review summary

Focus areas

Style and clarity: Two issues — a subjectless sentence fragment in the A2A server definition (line 31) and "LLM" used without expansion on first use (line 34). All other entries are clear and well-structured.
Jargon: "GenAI" appears throughout as the Kibana feature name (GenAI connector, GenAI Settings), which is acceptable as it matches the product UI. All other acronyms used in definition terms (RAG, MCP, A2A) are expanded within their own entries.
Frontmatter and applies_to: Frontmatter is present and complete — applies_to, products, description, and navigation_title all pass. Inline applies_to badges are used extensively; two placement issues flagged inline (lines 46 and 234) where badges precede rather than follow the content they scope.
Content type fit: Glossary is not one of the five standard Elastic content types (overview, how-to, tutorial, troubleshooting, changelog), so no type field is expected or required. Structure and formatting are appropriate for a reference glossary.
Parent issue satisfaction: Closes elastic/docs-content-internal#1059 (private). Based on the PR description, the ask was a terminology glossary for Agent Builder docs. The page covers the feature comprehensively and alphabetically with version badges — appears satisfied.

Nits

description (line 3): Starts with a noun phrase ("Definitions of the key terms...") rather than a verb. Suggest: "Defines the key terms used throughout the Elastic Agent Builder documentation." — a minor style-guide-based preference.

Notes

Vale is not installed in this environment; manual review was performed against the Elastic style guide rules.
The toc.yml change is out of scope for this markdown review.

Docs automation | From workflow: Docs review agent

React with 👍 if helpful, 👎 if not.

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

charlotte-hoblik · 2026-05-05T10:07:03Z

Thank you @akm-esco for the review 🙂

pgayvallet

(Feel free to ignore part or all of the comments)

pgayvallet · 2026-05-05T10:19:04Z

+GenAI Settings {applies_to}`stack: ga 9.4+`
+:   The {{kib}} settings page where you configure the default model and other generative-AI options that affect {{agent-builder}}. See [Models](models.md).
+
+## I


An entry for Inference endpoint (which are "replacing" AI connectors we're deprecating) maybe?

Looked into this: the term isn't actually used in the AB docs yet. It only appears in mcp-server.md as a cluster-privilege footnote, and models.md/connectors.md still speak in connectors. Per the glossary's scope ("terms used throughout the AB documentation"), I'd hold off until those pages are rewritten around the AI Connector / inference endpoint model. Happy to add it then. What do you think?

I'd hold off until those pages are rewritten around the AI Connector / inference endpoint model

@charlotte-hoblik can you create a ticket for that and assign it to yourself for this new sprint

you can chat to Lisa about this, as she worked on the ES solution updates around inference endpoints :)

pgayvallet

And a couple more

pgayvallet · 2026-05-05T11:06:37Z

+Slash command {applies_to}`stack: ga 9.4+`
+:   The chat shortcut for explicitly invoking a skill. Type `/` followed by the skill name to bypass automatic skill selection. See [Skills](skills.md).


Is that the naming we ended up with? At some point we were naming those "Chat commands"

Good question. I went and double-checked the docs. "Slash command" is the term in use inskills.md

charlotte-hoblik · 2026-05-05T13:32:04Z

Thank you for the review @pgayvallet 🙂

leemthompo

Lots of similar feedback here, links should be targeted or removed.

We should add anchors to all of these too

Co-authored-by: Liam Thompson <leemthompo@gmail.com>

…k text

leemthompo

🚀

Co-authored-by: Liam Thompson <leemthompo@gmail.com>

charlotte-hoblik added 2 commits April 28, 2026 08:35

Add glossary

bc8722b

fix broken linking

b932a23

charlotte-hoblik requested a review from leemthompo April 28, 2026 06:48

charlotte-hoblik self-assigned this Apr 28, 2026

charlotte-hoblik requested a review from a team as a code owner April 28, 2026 06:48

charlotte-hoblik added the documentation Improvements or additions to documentation label Apr 28, 2026

charlotte-hoblik requested a review from a team as a code owner April 28, 2026 06:48

Fix linter suggestions

0642328

github-actions Bot reviewed Apr 28, 2026

View reviewed changes

charlotte-hoblik and others added 4 commits April 28, 2026 14:10

Update explore-analyze/ai-features/agent-builder/glossary.md

a9dbe04

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Apply change based on automatic feedback

2769f14

Merge branch 'main' into charlotte-glossary-1059

1a60e18

Apply feedback

9b8a127

akm-esco reviewed May 4, 2026

View reviewed changes

Comment thread explore-analyze/ai-features/agent-builder/glossary.md Outdated

akm-esco reviewed May 4, 2026

View reviewed changes

Comment thread explore-analyze/ai-features/agent-builder/glossary.md Outdated

akm-esco reviewed May 4, 2026

View reviewed changes

Comment thread explore-analyze/ai-features/agent-builder/glossary.md

akm-esco reviewed May 4, 2026

View reviewed changes

Comment thread explore-analyze/ai-features/agent-builder/glossary.md

charlotte-hoblik and others added 2 commits May 5, 2026 11:57

update entries based on feedback and add links to pages

ee83665

Merge branch 'main' into charlotte-glossary-1059

c853321

pgayvallet reviewed May 5, 2026

View reviewed changes

charlotte-hoblik and others added 2 commits May 5, 2026 14:58

Apply feedback

baa68ed

Merge branch 'main' into charlotte-glossary-1059

af3fdac

charlotte-hoblik requested a review from akm-esco May 5, 2026 13:31

charlotte-hoblik requested a review from pgayvallet May 5, 2026 13:32

leemthompo reviewed May 5, 2026

View reviewed changes

charlotte-hoblik mentioned this pull request May 5, 2026

Update Agent Builder docs for 9.4+ inference apps #6295

Open

charlotte-hoblik and others added 18 commits May 5, 2026 18:54

Update explore-analyze/ai-features/agent-builder/glossary.md

b8336b2

Co-authored-by: Liam Thompson <leemthompo@gmail.com>

Update explore-analyze/ai-features/agent-builder/glossary.md

34d54d4

Co-authored-by: Liam Thompson <leemthompo@gmail.com>

Update explore-analyze/ai-features/agent-builder/glossary.md

1033942

Co-authored-by: Liam Thompson <leemthompo@gmail.com>

Update explore-analyze/ai-features/agent-builder/glossary.md

e08595b

Co-authored-by: Liam Thompson <leemthompo@gmail.com>

Update explore-analyze/ai-features/agent-builder/glossary.md

e0e937c

Co-authored-by: Liam Thompson <leemthompo@gmail.com>

Update explore-analyze/ai-features/agent-builder/glossary.md

ac29f57

Co-authored-by: Liam Thompson <leemthompo@gmail.com>

Update explore-analyze/ai-features/agent-builder/glossary.md

8a1e32d

Co-authored-by: Liam Thompson <leemthompo@gmail.com>

Update explore-analyze/ai-features/agent-builder/glossary.md

66d7fed

Co-authored-by: Liam Thompson <leemthompo@gmail.com>

Update explore-analyze/ai-features/agent-builder/glossary.md

9da556b

Co-authored-by: Liam Thompson <leemthompo@gmail.com>

Update explore-analyze/ai-features/agent-builder/glossary.md

6274cba

Co-authored-by: Liam Thompson <leemthompo@gmail.com>

Update explore-analyze/ai-features/agent-builder/glossary.md

354cb68

Co-authored-by: Liam Thompson <leemthompo@gmail.com>

Update explore-analyze/ai-features/agent-builder/glossary.md

ace4d48

Co-authored-by: Liam Thompson <leemthompo@gmail.com>

add inline anchor IDs to glossary entries

c87ade5

replace link to targeted links and to rely on auto auto-generated lin…

794d3a5

…k text

remove entries

20cf863

clean up applies_to tags and links

55395f6

fiix broken link

85cded7

Merge branch 'main' into charlotte-glossary-1059

dda2533

charlotte-hoblik requested a review from leemthompo May 7, 2026 10:08

leemthompo approved these changes May 7, 2026

View reviewed changes

Comment thread explore-analyze/ai-features/agent-builder/glossary.md Outdated

charlotte-hoblik and others added 2 commits May 7, 2026 17:14

Update explore-analyze/ai-features/agent-builder/glossary.md

cc9deda

Co-authored-by: Liam Thompson <leemthompo@gmail.com>

Merge branch 'main' into charlotte-glossary-1059

92b03c4

charlotte-hoblik enabled auto-merge (squash) May 7, 2026 15:14

charlotte-hoblik merged commit 8224e6f into main May 7, 2026
11 of 12 checks passed

charlotte-hoblik deleted the charlotte-glossary-1059 branch May 7, 2026 15:16

github-actions Bot deployed to docs-preview May 7, 2026 15:19 View deployment

charlotte-hoblik mentioned this pull request May 7, 2026

[agent builder] Update models docs for 9.4 model management UI #6355

Open

		Slash command {applies_to}`stack: ga 9.4+`
		: The chat shortcut for explicitly invoking a skill. Type `/` followed by the skill name to bypass automatic skill selection. See [Skills](skills.md).

Conversation

charlotte-hoblik commented Apr 28, 2026 • edited by leemthompo Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

URL preview: https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/6175/explore-analyze/ai-features/agent-builder/glossary

Generative AI disclosure

Uh oh!

github-actions Bot commented Apr 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Elastic Docs AI PR menu

Uh oh!

github-actions Bot commented Apr 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔍 Preview links for changed docs

Uh oh!

github-actions Bot commented Apr 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Vale Linting Results

Uh oh!

github-actions Bot left a comment

Choose a reason for hiding this comment

Docs review summary

Focus areas

Nits

Notes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

charlotte-hoblik commented May 5, 2026

Uh oh!

pgayvallet left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

pgayvallet May 5, 2026

Choose a reason for hiding this comment

Uh oh!

charlotte-hoblik May 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

leemthompo May 5, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

pgayvallet left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

pgayvallet May 5, 2026

Choose a reason for hiding this comment

Uh oh!

charlotte-hoblik May 5, 2026

Choose a reason for hiding this comment

Uh oh!

charlotte-hoblik commented May 5, 2026

Uh oh!

leemthompo left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

charlotte-hoblik commented Apr 28, 2026 •

edited by leemthompo

Loading

github-actions Bot commented Apr 28, 2026 •

edited

Loading

github-actions Bot commented Apr 28, 2026 •

edited

Loading

github-actions Bot commented Apr 28, 2026 •

edited

Loading

charlotte-hoblik May 5, 2026 •

edited

Loading

leemthompo left a comment •

edited

Loading