Skip to content

[Search] Onboarding agent cleanup#261410

Merged
wildemat merged 20 commits intoelastic:mainfrom
wildemat:fix/agent-builder-cleanup
Apr 9, 2026
Merged

[Search] Onboarding agent cleanup#261410
wildemat merged 20 commits intoelastic:mainfrom
wildemat:fix/agent-builder-cleanup

Conversation

@wildemat
Copy link
Copy Markdown
Contributor

@wildemat wildemat commented Apr 6, 2026

Summary

Having merged these changes:
[Search] add use-case-library skill to onboarding agent
[Search] onboarding agent page context awareness
[Search] Onboarding agent api snippet context
[Search] Consolidate vector skill for onboarding agent

This PR adds a couple cleanup items:

  • Prioritize Jina as the default EIS model
  • Replace references to keyword/semantic/hybrid search with reference to the consolidated vector-hybrid-search skill

wildemat added 19 commits April 6, 2026 13:55
Agent Builder knows which Kibana page the user is on. This adds a Page
Context section that adapts the conversation based on the current page
(Index Management, Dev Tools, Connectors, File Data Visualizer, etc.).

When the user is already on Dev Tools, skip conceptual setup and jump
straight to generating the API snippets they need.

Made-with: Cursor
Replace three separate skills (semantic-search, hybrid-search,
vector-database) with a single vector-hybrid-search skill. Mirrors the
consolidation done in the agent-skills-sandbox repo.

The new skill uses SENSE syntax for all API examples (consistent with
Kibana Dev Tools), covers semantic_text + dense_vector paths, hybrid
RRF, reranking, and production optimization.

Made-with: Cursor
…lder

Agent Builder cannot execute client code — only API calls in SENSE syntax
can run via Kibana Dev Tools. This changes the onboarding agent to:

- Output SENSE API snippets (PUT, POST) instead of Python/JS/Go code
- Replace MCP setup with a note that cluster access is already available
- Replace "what language?" with "where will you build the application?"
- Replace ingestion scripts with Kibana UI routing (File Data Visualizer,
  connectors) and POST _bulk for Dev Tools
- Add IDE handoff section for after Elasticsearch resources are set up
- Replace Code Standards with API Snippet Standards

Made-with: Cursor
Adds a use-case-library skill that maps 8 Elasticsearch use cases with
industry examples and technologies. Adapted for Agent Builder:

- Each use case includes an "In Kibana" section explaining what can be
  set up via Dev Tools before moving to the IDE
- Quick Reference table includes a "Set Up in Kibana" column
- Non-Search redirects use Kibana navigation (Management → Spaces)
  instead of abstract doc links
- No LangChain/LlamaIndex references in "What ES does" sections (those
  are IDE-only integrations)
- No routing directives (agent already has the conversation context)

AGENTS.md updated to reference use-case-library for "what can I build?"
questions.

Made-with: Cursor
- Updated signal table in AGENTS.md: semantic-search, hybrid-search,
  vector-database → vector-hybrid-search
- Updated keyword-search SKILL.md: semantic-search → vector-hybrid-search
- Updated catalog-ecommerce SKILL.md: semantic-search/hybrid-search →
  vector-hybrid-search
- Added json language tags to all SENSE code blocks in vector-hybrid-search
- Fixed MD060 table alignment in signal table (compact format)
- Regenerated all TypeScript from cleaned sources

Made-with: Cursor
The sandbox skill prioritized Jina as the default EIS embedding model
but this was lost when the kibana skills were written from scratch.

- vector-hybrid-search: Jina v3 as default dense model, Jina v5-small
  for cost-sensitive, Jina Reranker v2/v3 for reranking, EIS docs link
- rag-chatbot: EIS verification note with Jina model details

Matches the sandbox's references/vector-hybrid-search and rag-chatbot.

Made-with: Cursor
@wildemat wildemat changed the title fix/agent builder cleanup [Search] Onboarding agent cleanup Apr 9, 2026
@wildemat wildemat marked this pull request as ready for review April 9, 2026 16:38
@wildemat wildemat requested a review from a team as a code owner April 9, 2026 16:38
@wildemat wildemat added release_note:skip Skip the PR/issue when compiling release notes backport:version Backport to applied version labels v9.4.0 labels Apr 9, 2026
@wildemat wildemat enabled auto-merge (squash) April 9, 2026 17:25
@wildemat wildemat merged commit 191ac34 into elastic:main Apr 9, 2026
17 checks passed
@kibanamachine kibanamachine removed the backport:version Backport to applied version labels label Apr 9, 2026
@kibanamachine kibanamachine added the backport:skip This PR does not require backporting label Apr 9, 2026
@elasticmachine
Copy link
Copy Markdown
Contributor

💛 Build succeeded, but was flaky

Failed CI Steps

Metrics [docs]

✅ unchanged

History

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

Labels

backport:skip This PR does not require backporting release_note:skip Skip the PR/issue when compiling release notes v9.4.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants