Search Agent Knowledge Bases (M2M)
Search the knowledge bases attached to an agent, scoped server-side from AgentKnowledgeBase - never from a caller-supplied list of knowledge base ids. Authenticated with a BundleAccessToken; agent_id is cross-checked against the token's own scope before any search runs. Search policy (result cap, candidate pool, reranker) comes from the search_knowledge_base binding of the snapshot named by config_ref; an absent or null reference uses the latest published version, or defaults for a never-published agent. Vector and lexical candidates are fused by reciprocal rank and optionally reranked; a reranker failure keeps the fused order.
Authorization
BundleAccessToken In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Body of POST /v1/bundler/knowledge/search. agent_id is resolved and deployment-scoped server-side against the caller's own BundleAccessToken - never trusted as sufficient authorization on its own.
Response Body
application/json
application/json
curl -X POST "https://example.com/v1/bundler/knowledge/search" \ -H "Content-Type: application/json" \ -d '{ "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978", "query": "string" }'{ "results": [ { "chunk_id": "55e808e1-8ddc-49f1-92c9-6bbdcdff1c83", "document_id": "b792e8ae-2cb4-4209-85b9-32be4c2fcdd6", "title": "string", "source_url": "string", "filename": "string", "score": 0, "score_kind": "rrf", "text": "string" } ]}{ "detail": [ { "loc": [ "string" ], "msg": "string", "type": "string" } ]}