Inferência de Agente
POST/v1/agents/:agentId/inference
Execute inferência usando um agente específico sem autenticação de usuário.
Este é um endpoint público que permite interação direta com agentes de IA usando seus tokens de acesso.
Uso:
- Primeira mensagem: Envie sem
sessionId - Mensagens subsequentes: Inclua o
sessionIdretornado da primeira resposta
Exemplo cURL:
curl --location --request POST 'https://api.ko-ia.com/v1/agents/:agentId/inference' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer SEU_TOKEN_DO_AGENTE' \
--data '{
"message": "Olá! Como você pode me ajudar hoje?"
}'
Exemplo com sessão:
curl --location --request POST 'https://api.ko-ia.com/v1/agents/:agentId/inference' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer SEU_TOKEN_DO_AGENTE' \
--data '{
"sessionId": "session_abc123def456",
"message": "Continue nossa conversa anterior"
}'
Requisição
Responses
- 200
- 400
- 401
- 403
- 404
- 429
- 500
Resposta de inferência bem-sucedida
Erro de validação - Formato de solicitação inválido ou campos obrigatórios ausentes
Erro de autenticação - Token de autorização inválido ou ausente
Erro de autorização - Usuário não está autorizado a acessar este recurso
Agente não encontrado - O ID do agente especificado não existe ou está inativo
Limite de taxa excedido
Erro interno do servidor