Search an agent's knowledge bases
Agents
Search an agent's knowledge bases
Run a semantic/keyword search across one or more knowledge bases linked to this agent and return the top-scoring chunks, merged and ranked by relevance. Only knowledge bases already attached to the agent may be queried; an unlinked kb_id returns 403. Use it to preview what an agent would retrieve for a given user question.
POST
Search an agent's knowledge bases
Authorizations
Dashboard JWT token from Clerk
Path Parameters
Agent identifier (Devotel agent_xxx id).
Body
application/json
Natural-language search query.
Required string length:
1 - 1000Knowledge base ids to search. Each must be linked to this agent.
Required array length:
1 - 20 elementsMaximum number of merged results to return (1–20, default 5).
Required range:
1 <= x <= 20