Buscar na base de conhecimento
Busca trechos relevantes na base do agente e devolve uma resposta extrativa mais os trechos. Não persiste nada. Gera um embedding faturado, então um cliente bloqueado é recusado; agente inativo ou base desligada é 409 CONFLICT. Aceita Idempotency-Key (opcional).
Autorização
bearer agents:executeCredencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.
Em: header
Escopo: agents:execute
Parâmetros de caminho
Id do agente
Parâmetros de cabeçalho
Chave opcional de 1 a 255 caracteres ASCII visíveis; quando enviada, vale o mesmo contrato da §8.
Corpo da requisição
application/json
Definições TypeScript
Use o tipo request body no TypeScript.
O corpo de POST /knowledge/searches.
Corpo da resposta
application/json
application/json
curl -X POST "https://example.com/agents/string/knowledge/searches" \ -H "Idempotency-Key: b3f0c1e2-4a5b-4c6d-8e9f-0a1b2c3d4e5f" \ -H "Content-Type: application/json" \ -d '{ "query": "string" }'{ "answer": "string", "results": [ { "content": "string", "metadata": null, "score": 0.1, "source": "string" } ]}