Agentes
Obter Agente
Recuperar detalhes de um agente específico por ID
GET
Obter Agente
Recuperar detalhes completos de um agente específico, incluindo configurações, base de conhecimento e status atual.Endpoint
Parâmetros de caminho
string
obrigatório
O identificador único do agente. Você pode encontrá-lo na lista de agentes.
Cabeçalhos da requisição
string
obrigatório
Token Bearer para autenticação. Formato:
Bearer talq_your_environment_token_hereExemplos de Requisição
Resposta
Resposta de Sucesso (200 OK)
Campos da Resposta
boolean
obrigatório
Indica se a operação foi bem-sucedida.
object
obrigatório
Dados completos do agente.
Respostas de erro
404 Não Encontrado
401 Não Autorizado
500 Erro do Servidor
Códigos de erro
Notas Importantes
Dados completos. Este endpoint retorna todos os detalhes do agente, incluindo configurações completas.
Base de conhecimento. A base de conhecimento completa é retornada para análise e edição.
Configurações de comportamento. Inclui todas as configurações de comportamento do agente.
Melhores Práticas
- Use para edição - Use este endpoint para obter dados completos antes de editar um agente
- Verifique status - Confirme o status do agente antes de fazer alterações
- Analise configurações - Revise todas as configurações antes de publicar
- Monitore atualizações - Use
updated_atpara acompanhar mudanças - Trate erros - Implemente tratamento adequado de erros para agentes não encontrados
Endpoints relacionados
- Listar Agentes:
GET /api/v1/agents - Criar Agente:
POST /api/v1/agents - Atualizar Conhecimento do Agente:
PUT /api/v1/agents/{agent_id}/knowledge - Atualizar Voz do Agente:
PUT /api/v1/agents/{agent_id}/voice - Excluir Agente:
DELETE /api/v1/agents/{agent_id}