Enviar um documento para a base de conhecimento
Indexa um documento (multipart, campo file). Gera embeddings faturados ao cliente, então um cliente bloqueado é recusado; agente inativo ou base desligada é 409 CONFLICT. Arquivo acima do teto da base (47 MiB por padrão) responde 413 PAYLOAD_TOO_LARGE. Reenviar o mesmo conteúdo cai no documento existente (200) sem gerar embeddings de novo; um documento novo responde 201. Sendo multipart, não passa pela camada de idempotência (§8); o reenvio do mesmo arquivo não duplica o documento.
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
Corpo da requisição
multipart/form-data
multipart/form-data com o campo file
Definições TypeScript
Use o tipo request body no TypeScript.
Corpo da resposta
application/json
application/json
application/json
curl -X POST "https://<seu-servidor>/api/v3/agents/{agent_id}/knowledge/documents" \ -H "Authorization: Bearer <credencial>" \ -F "file=@./documento.pdf"{ "byte_size": 0, "chunk_count": 0, "content_type": "string", "filename": "string", "has_content": true, "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "status": "string", "uploaded_at": "string"}