Skip to main content
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_here

Exemplos 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

  1. Use para edição - Use este endpoint para obter dados completos antes de editar um agente
  2. Verifique status - Confirme o status do agente antes de fazer alterações
  3. Analise configurações - Revise todas as configurações antes de publicar
  4. Monitore atualizações - Use updated_at para acompanhar mudanças
  5. 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}