[DOCS][ML UI][9.x & Serverless] Host Elastic documentation for AI assistant by nastasha-solomon · Pull Request #5613 · elastic/docs-content

nastasha-solomon · 2026-03-25T04:34:11Z

Summary

This PR fixes #5519 and continues work started in elastic/kibana#259418. More details are below in the section requesting reviews.

Generative AI disclosure

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

Yes
No

Cursor + Composer 2

Reviews needed

This PR needs an editorial, technical, and code owner review. Instructions for each are below.

📋 What this PR does

This PR adds Host a knowledge base artifact repo for AI assistants (a new page) to the AI chat experiences section. It ports and reorganizes procedural content that previously lived in the Kibana AI Assistant settings reference, and adds net-new content (generated with AI assistance) covering three hosting options for air-gapped or restricted network deployments: S3-compatible bucket, CDN, and local file path.

Several other files have minor updates to replace or add cross-references pointing to the new page.

📁 Files changed

File	Change
`explore-analyze/ai-features/ai-chat-experiences/ai-assistant-host-doc-artifacts.md`	New file — primary content (266 lines)
`explore-analyze/toc.yml`	New TOC entry for the page above
`deploy-manage/deploy/self-managed/air-gapped-install.md`	`applies_to` tag changed from `stack` to `self`; updated cross-reference
`explore-analyze/ai-features/llm-guides/connect-to-lmstudio-observability.md`	Updated cross-reference
`solutions/observability/ai/observability-ai-assistant.md`	Updated cross-reference
`solutions/security/ai/ai-assistant-knowledge-base.md`	Updated cross-reference

✏️ Editorial reviewer

Please review the new page and the updated cross-references for:

Clarity and flow: Does the intro clearly explain the problem being solved? Is the "Choose a hosting option" section easy to scan?
Consistency: Do the three tab sections (S3, CDN, local files) follow a parallel structure? Are steps labeled and ordered consistently across tabs?
Style guide compliance: There's an open Vale warning flagging via on line 10 of the new file — please confirm the fix. Check for any other style issues (tone, active voice, second person, etc.).
Cross-references: Do the updated link labels in the existing files read naturally in context?
Frontmatter: Does the page description accurately reflect the content?

🔧 Technical reviewer

Please review the new page for technical accuracy. The net-new content especially needs validation. Focus on:

ZIP file names and versioning: Are the file name patterns (kb-product-doc-{product}-{major}.{minor}.zip) accurate? Are the example filenames for 9.0 correct and complete? (Note: The tech reviewer has flagged that in 9.4, a new kb-product-doc-openapi-9.4.zip will be added. This will be doc'd in a separate PR once the implementation PR adding that zip file is merged.)
S3-compatible bucket instructions: Is the guidance about bucket listing behavior (S3-style ListObjects response, object key requirements) accurate? Are there missing edge cases or gotchas?
CDN instructions: Is the bucket listing XML template correct? Are the instructions for serving it as a directory index accurate across common CDN setups?
Local file path instructions: Is the file:// URI approach described correctly? Are the permissions guidance and constraints accurate?
xpack.productDocBase.artifactRepositoryUrl: Are the configuration examples and constraints correct?

Related Kibana PR for context: elastic/kibana#259418

👤 Area/Code owner reviewers

Please review only the files listed for you below and confirm that the changes to your area are correct, don't introduce inaccuracies, and don't conflict with anything in progress or recently merged.

@mdbirnstiehl please review:

solutions/observability/ai/observability-ai-assistant.md and explore-analyze/ai-features/llm-guides/connect-to-lmstudio-observability.md: Updated cross-references

@benironside please review:

solutions/security/ai/ai-assistant-knowledge-base.md: Updated cross-reference
Is the change technically correct?
Does it accurately represent the behavior/feature in your area?
Does it conflict with anything in progress or recently merged?
Are there missing details or anything that could mislead users?

Adjusts changes that were made in #5521

explore-analyze/ai-features/ai-chat-experiences/ai-assistant-host-doc-artifacts.md

…ost-doc-artifacts.md

qn895 · 2026-03-25T15:18:43Z

explore-analyze/ai-features/ai-chat-experiences/ai-assistant-host-doc-artifacts.md

+
+   For example, when {{kib}} is 9.0, the four ZIP files are:
+
+   * `kb-product-doc-elasticsearch-9.0.zip`


Just a heads up, in 9.4, we are adding a new zip file called kb-product-doc-openapi-9.4.zip which will be installed at the same time as these 4 files. The zip file will support elastic/kibana#255717, which dynamically generates elasticsearch tools for the agent builder. So customer should also install that for 9.4+ version after the PR is merged.

github-actions · 2026-03-25T16:37:49Z

🔍 Preview links for changed docs

github-actions · 2026-03-25T16:38:18Z

Vale Linting Results

Summary: 2 warnings, 1 suggestion found

⚠️ Warnings (2)

File	Line	Rule	Message
explore-analyze/ai-features/ai-chat-experiences/ai-assistant.md	48	Elastic.QuotesPunctuation	Place punctuation inside closing quotation marks.
explore-analyze/ai-features/ai-chat-experiences/ai-assistant.md	48	Elastic.DontUse	Don't use 'just'.

💡 Suggestions (1)

File	Line	Rule	Message
explore-analyze/ai-features/ai-chat-experiences/ai-assistant.md	48	Elastic.FirstPerson	Use caution when using first-person pronouns such as 'me.'

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.

deploy-manage/deploy/self-managed/air-gapped-install.md

yetanothertw

The Admin docs-related changes look good, thanks!

Approving to unblock, but left a suggestion to simplify that last paragraph.

florent-leborgne

Really nice, leaving a suggestion regarding the "titles inside of tabs" issue that I think we should fix

explore-analyze/ai-features/ai-chat-experiences/ai-assistant-host-doc-artifacts.md

nastasha-solomon · 2026-03-26T16:42:42Z

Thanks for the early feedback @yetanothertw and @florent-leborgne . I'm actually still working on this PR, which is why I reverted it back to draft mode.

qn895

LGTM

mdbirnstiehl

LGTM! I had a couple of little things that may or may not make sense.

mdbirnstiehl · 2026-03-27T19:43:29Z

explore-analyze/toc.yml

        children:
          - file: ai-features/ai-chat-experiences/ai-agent-or-ai-assistant.md
          - file: ai-features/ai-chat-experiences/ai-assistant.md
+          - file: ai-features/ai-chat-experiences/ai-assistant-host-doc-artifacts.md


Would it make sense for this to be nested under AI assistants?

I think either could work. Moving this page under "AI assistants in Kibana" makese sense from a TOC hierarchy perspective. But there's also a chance it could be misinterpreted as being "the next step" in setting up the assistant, when it's really just an option for certain users (folks on air-gapped or restricted networks). Keeping it on the same level as "AI assistants in Kibana" fosters a stronger relationship with the top level title "AI chat experiences", which might be more relevant. I'm really not sure tho - you and @benironside are the experts here, so I'll defer to you. : )

explore-analyze/ai-features/ai-chat-experiences/ai-assistant-host-doc-artifacts.md

…ost-doc-artifacts.md Co-authored-by: Mike Birnstiehl <114418652+mdbirnstiehl@users.noreply.github.com>

…Assistant settings (#259418) ## Summary This PR docs the new `xpack.productDocBase.artifactRepositoryProxyUrl` setting and refocuses the scope of the page to only cover Kibana settings for configuring the knowledge base artifact repo URL. ### Major changes - **Procedural content removed**: Step-by-step guidance for tasks such as mirroring artifacts to S3 or a CDN, bucket listings, restart flows, and similar has been removed from the page since it doesn't fit the page's content type. The content is being re-added to the docs as a new page within the [AI chat experiences](https://www.elastic.co/docs/explore-analyze/ai-features/ai-chat-experiences) section via elastic/docs-content#5613. - **Title and framing updated**: The page title and navigation label now describe knowledge base artifact settings for the AI assistants. The former title (“AI Assistant settings”) was a tad too broad in scope. - **Setting descriptions expanded**: Both settings are documented to show how they should be used for internet-connected deployments or restricted/isolated setups. ### Related - Companion docs-content PR: ~elastic/docs-content#5521~ elastic/docs-content#5613 - Docs issue: elastic/docs-content#5519 - Implementation PR: #250771 - Scoping issue: #244738 ### Checklist - [x] [Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html) was added for features that require explanation or tutorials ### Release note Document `xpack.productDocBase.artifactRepositoryProxyUrl` setting for configuring HTTP proxy access to the AI Assistant knowledge base artifact repository. Made with [Cursor](https://cursor.com) --------- Co-authored-by: florent-leborgne <florent.leborgne@elastic.co>

explore-analyze/ai-features/ai-chat-experiences/ai-assistant-host-doc-artifacts.md

…ost-doc-artifacts.md

florent-leborgne

LGTM, thanks!

explore-analyze/ai-features/ai-chat-experiences/ai-assistant-host-doc-artifacts.md

…Assistant settings (elastic#259418) ## Summary This PR docs the new `xpack.productDocBase.artifactRepositoryProxyUrl` setting and refocuses the scope of the page to only cover Kibana settings for configuring the knowledge base artifact repo URL. ### Major changes - **Procedural content removed**: Step-by-step guidance for tasks such as mirroring artifacts to S3 or a CDN, bucket listings, restart flows, and similar has been removed from the page since it doesn't fit the page's content type. The content is being re-added to the docs as a new page within the [AI chat experiences](https://www.elastic.co/docs/explore-analyze/ai-features/ai-chat-experiences) section via elastic/docs-content#5613. - **Title and framing updated**: The page title and navigation label now describe knowledge base artifact settings for the AI assistants. The former title (“AI Assistant settings”) was a tad too broad in scope. - **Setting descriptions expanded**: Both settings are documented to show how they should be used for internet-connected deployments or restricted/isolated setups. ### Related - Companion docs-content PR: ~elastic/docs-content#5521~ elastic/docs-content#5613 - Docs issue: elastic/docs-content#5519 - Implementation PR: elastic#250771 - Scoping issue: elastic#244738 ### Checklist - [x] [Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html) was added for features that require explanation or tutorials ### Release note Document `xpack.productDocBase.artifactRepositoryProxyUrl` setting for configuring HTTP proxy access to the AI Assistant knowledge base artifact repository. Made with [Cursor](https://cursor.com) --------- Co-authored-by: florent-leborgne <florent.leborgne@elastic.co>

…tings - PT 2 (#260113) ## Summary This PR is a continuation of #259418. It uncomments the reference to the "Host a knowledge base artifact repo for AI assistants" page, which is being added to the narrative docs in [a separate PR](elastic/docs-content#5613). **Note:** Must merge elastic/docs-content#5613 for the CI checks in this PR to go green.

…Assistant settings (elastic#259418) ## Summary This PR docs the new `xpack.productDocBase.artifactRepositoryProxyUrl` setting and refocuses the scope of the page to only cover Kibana settings for configuring the knowledge base artifact repo URL. ### Major changes - **Procedural content removed**: Step-by-step guidance for tasks such as mirroring artifacts to S3 or a CDN, bucket listings, restart flows, and similar has been removed from the page since it doesn't fit the page's content type. The content is being re-added to the docs as a new page within the [AI chat experiences](https://www.elastic.co/docs/explore-analyze/ai-features/ai-chat-experiences) section via elastic/docs-content#5613. - **Title and framing updated**: The page title and navigation label now describe knowledge base artifact settings for the AI assistants. The former title (“AI Assistant settings”) was a tad too broad in scope. - **Setting descriptions expanded**: Both settings are documented to show how they should be used for internet-connected deployments or restricted/isolated setups. ### Related - Companion docs-content PR: ~elastic/docs-content#5521~ elastic/docs-content#5613 - Docs issue: elastic/docs-content#5519 - Implementation PR: elastic#250771 - Scoping issue: elastic#244738 ### Checklist - [x] [Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html) was added for features that require explanation or tutorials ### Release note Document `xpack.productDocBase.artifactRepositoryProxyUrl` setting for configuring HTTP proxy access to the AI Assistant knowledge base artifact repository. Made with [Cursor](https://cursor.com) --------- Co-authored-by: florent-leborgne <florent.leborgne@elastic.co>

…tings - PT 2 (elastic#260113) ## Summary This PR is a continuation of elastic#259418. It uncomments the reference to the "Host a knowledge base artifact repo for AI assistants" page, which is being added to the narrative docs in [a separate PR](elastic/docs-content#5613). **Note:** Must merge elastic/docs-content#5613 for the CI checks in this PR to go green.

…Assistant settings (elastic#259418) ## Summary This PR docs the new `xpack.productDocBase.artifactRepositoryProxyUrl` setting and refocuses the scope of the page to only cover Kibana settings for configuring the knowledge base artifact repo URL. ### Major changes - **Procedural content removed**: Step-by-step guidance for tasks such as mirroring artifacts to S3 or a CDN, bucket listings, restart flows, and similar has been removed from the page since it doesn't fit the page's content type. The content is being re-added to the docs as a new page within the [AI chat experiences](https://www.elastic.co/docs/explore-analyze/ai-features/ai-chat-experiences) section via elastic/docs-content#5613. - **Title and framing updated**: The page title and navigation label now describe knowledge base artifact settings for the AI assistants. The former title (“AI Assistant settings”) was a tad too broad in scope. - **Setting descriptions expanded**: Both settings are documented to show how they should be used for internet-connected deployments or restricted/isolated setups. ### Related - Companion docs-content PR: ~elastic/docs-content#5521~ elastic/docs-content#5613 - Docs issue: elastic/docs-content#5519 - Implementation PR: elastic#250771 - Scoping issue: elastic#244738 ### Checklist - [x] [Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html) was added for features that require explanation or tutorials ### Release note Document `xpack.productDocBase.artifactRepositoryProxyUrl` setting for configuring HTTP proxy access to the AI Assistant knowledge base artifact repository. Made with [Cursor](https://cursor.com) --------- Co-authored-by: florent-leborgne <florent.leborgne@elastic.co>

…tings - PT 2 (elastic#260113) ## Summary This PR is a continuation of elastic#259418. It uncomments the reference to the "Host a knowledge base artifact repo for AI assistants" page, which is being added to the narrative docs in [a separate PR](elastic/docs-content#5613). **Note:** Must merge elastic/docs-content#5613 for the CI checks in this PR to go green.

nastasha-solomon added 2 commits March 25, 2026 00:26

First draft

a916054

Link fixes

c8a21ce

nastasha-solomon self-assigned this Mar 25, 2026

nastasha-solomon mentioned this pull request Mar 25, 2026

[DOCS][ML UI][9.4 & Serverless] Doc artifactRepositoryProxyUrl to AI Assistant settings elastic/kibana#259418

Merged

1 task

nastasha-solomon added 3 commits March 25, 2026 00:51

Remove uneeded anchor

5676399

applies to tags

85be9b5

adjusts changes from previous PR

625d4ae

Adjusts changes that were made in #5521

nastasha-solomon commented Mar 25, 2026

View reviewed changes

explore-analyze/ai-features/ai-chat-experiences/ai-assistant-host-doc-artifacts.md Outdated Show resolved Hide resolved

Update explore-analyze/ai-features/ai-chat-experiences/ai-assistant-h…

9fe1111

…ost-doc-artifacts.md

qn895 reviewed Mar 25, 2026

View reviewed changes

Merge branch 'main' into issue-5519-add-new-page

98badcb

nastasha-solomon and others added 3 commits March 26, 2026 00:56

Revise main page

f9bd766

remove numbers

797f0be

Merge branch 'main' into issue-5519-add-new-page

76098c1

nastasha-solomon marked this pull request as ready for review March 26, 2026 05:13

nastasha-solomon requested review from a team as code owners March 26, 2026 05:13

nastasha-solomon requested a review from qn895 March 26, 2026 05:13

yetanothertw reviewed Mar 26, 2026

View reviewed changes

deploy-manage/deploy/self-managed/air-gapped-install.md Outdated Show resolved Hide resolved

yetanothertw approved these changes Mar 26, 2026

View reviewed changes

florent-leborgne requested changes Mar 26, 2026

View reviewed changes

nastasha-solomon marked this pull request as draft March 26, 2026 16:41

nastasha-solomon added 4 commits March 26, 2026 13:02

more changes

36c0348

tags

97df5f9

extra colon

56d6d23

ga

b777f22

nastasha-solomon and others added 3 commits March 26, 2026 15:38

Merge branch 'main' into issue-5519-add-new-page

c67f974

modify ref

9521013

alignment

4d6248f

nastasha-solomon marked this pull request as ready for review March 26, 2026 20:49

nastasha-solomon requested review from benironside and mdbirnstiehl March 26, 2026 20:49

qn895 approved these changes Mar 27, 2026

View reviewed changes

mdbirnstiehl approved these changes Mar 27, 2026

View reviewed changes

nastasha-solomon and others added 3 commits March 27, 2026 16:45

Update explore-analyze/ai-features/ai-chat-experiences/ai-assistant-h…

b39aa79

…ost-doc-artifacts.md Co-authored-by: Mike Birnstiehl <114418652+mdbirnstiehl@users.noreply.github.com>

Merge branch 'main' into issue-5519-add-new-page

41e03d8

Added more cross-linking

71a6a2f

nastasha-solomon requested a review from florent-leborgne March 27, 2026 21:07

nastasha-solomon commented Mar 27, 2026

View reviewed changes

explore-analyze/ai-features/ai-chat-experiences/ai-assistant-host-doc-artifacts.md Outdated Show resolved Hide resolved

nastasha-solomon mentioned this pull request Mar 27, 2026

[DOCS][ML UI][9.4] Doc artifactRepositoryProxyUrl to AI Assistant settings - PT 2 elastic/kibana#260113

Merged

nastasha-solomon added 2 commits March 27, 2026 17:25

Update explore-analyze/ai-features/ai-chat-experiences/ai-assistant-h…

e69afef

…ost-doc-artifacts.md

Merge branch 'main' into issue-5519-add-new-page

7693762

florent-leborgne approved these changes Mar 30, 2026

View reviewed changes

explore-analyze/ai-features/ai-chat-experiences/ai-assistant-host-doc-artifacts.md Show resolved Hide resolved

Merge branch 'main' into issue-5519-add-new-page

1b8f47f

nastasha-solomon enabled auto-merge (squash) March 30, 2026 14:51

nastasha-solomon merged commit 344ad73 into main Mar 30, 2026
6 checks passed

nastasha-solomon deleted the issue-5519-add-new-page branch March 30, 2026 14:52

github-actions bot deployed to docs-preview March 30, 2026 14:55 View deployment


		For example, when {{kib}} is 9.0, the four ZIP files are:

		* `kb-product-doc-elasticsearch-9.0.zip`

Conversation

nastasha-solomon commented Mar 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Generative AI disclosure

Reviews needed

📋 What this PR does

📁 Files changed

✏️ Editorial reviewer

🔧 Technical reviewer

👤 Area/Code owner reviewers

Uh oh!

Uh oh!

qn895 Mar 25, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Mar 25, 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 Mar 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Vale Linting Results

Uh oh!

Uh oh!

yetanothertw left a comment

Choose a reason for hiding this comment

Uh oh!

florent-leborgne left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

nastasha-solomon commented Mar 26, 2026

Uh oh!

qn895 left a comment

Choose a reason for hiding this comment

Uh oh!

mdbirnstiehl left a comment

Choose a reason for hiding this comment

Uh oh!

mdbirnstiehl Mar 27, 2026

Choose a reason for hiding this comment

Uh oh!

nastasha-solomon Mar 27, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

florent-leborgne left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

nastasha-solomon commented Mar 25, 2026 •

edited

Loading

github-actions bot commented Mar 25, 2026 •

edited

Loading

github-actions bot commented Mar 25, 2026 •

edited

Loading