Skip to content

Clarify Vector Database project guidance - #8092

Draft
kosabogi wants to merge 5 commits into
mainfrom
vector-database-project-context
Draft

Clarify Vector Database project guidance#8092
kosabogi wants to merge 5 commits into
mainfrom
vector-database-project-context

Conversation

@kosabogi

@kosabogi kosabogi commented Aug 26, 2026

Copy link
Copy Markdown
Member

Summary

  • Add the Vector Database project type and exact value to cross-project search tag guidance.
  • Clarify the Elasticsearch and Vector Database project choices in the Search getting-started flow.
  • Distinguish Elasticsearch Serverless API profiles from the dedicated Vector Database project type using tabs.
  • Recommend the Vector Database project type for embedding-driven workloads on the vector search landing page.

This draft follows the project positioning introduced in #7961. Open product questions are listed in a separate PR comment.

Distinguish the dedicated project type from Elasticsearch profiles and surface it where users select projects or route cross-project searches.

Co-authored-by: Cursor <cursoragent@cursor.com>
@kosabogi

kosabogi commented Aug 26, 2026

Copy link
Copy Markdown
Member Author

Questions to confirm

@alexmarhaba @dustincoates Before finalizing the content, could you please confirm the following?

  1. Project selection: Is this the intended recommendation: use Vector Database when embeddings and similarity search are central to the workload, and use the Elasticsearch project type for general-purpose or mixed lexical, time series, and analytics workloads?
  2. Agent Builder: I can see Agent Builder in a Vector Database project in QA, and the current Kibana configuration also enables it and includes it in the Vector Database navigation. However, PR #7961 currently tells users to choose the Elasticsearch project type when they need Agent Builder. Is that guidance outdated? Should Agent Builder be removed from that Elasticsearch-specific recommendation, and should we document a Vector Database-specific access path?

@github-actions

Copy link
Copy Markdown
Contributor

Elastic Docs AI PR menu

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

  • Review docs changes (docs-review). Status: not started.

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

@github-actions

github-actions Bot commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

@github-actions

Copy link
Copy Markdown
Contributor

✅ Elastic Docs Style Checker (Vale)

No issues found on modified lines!


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.

Use the API values readers need when filtering or routing by the predefined project type tag.

Co-authored-by: Cursor <cursoragent@cursor.com>
Separate Elasticsearch profiles from the Vector Database index mode so readers can select the correct configuration for their project type.

Co-authored-by: Cursor <cursoragent@cursor.com>
kosabogi and others added 2 commits August 26, 2026 11:41
Surface the separate project type and its automatic vector index mode where readers first learn about vector search.

Co-authored-by: Cursor <cursoragent@cursor.com>
Recommend the Vector Database project for embedding-driven Serverless workloads without duplicating lower-level configuration details.

Co-authored-by: Cursor <cursoragent@cursor.com>
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.

1 participant