Skip to main content
DELETE

Excluir Agente

Excluir um agente específico permanentemente. Esta operação não pode ser desfeita e remove todos os dados associados ao agente.

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.
string
obrigatório
Mensagem de sucesso descrevendo a operação.

Respostas de erro

404 Não Encontrado

409 Conflito

401 Não Autorizado

500 Erro do Servidor

Códigos de erro

Notas Importantes

Operação irreversível. Esta operação exclui permanentemente o agente e todos os dados associados.
Verificação de uso. Agentes em uso ativo não podem ser excluídos.
Dados associados. Todos os dados do agente, incluindo treinamentos e ações, são removidos.
Confirmação necessária. Certifique-se de que deseja excluir o agente antes de executar esta operação.

Melhores Práticas

  1. Confirme a exclusão - Certifique-se de que deseja excluir o agente permanentemente
  2. Verifique uso ativo - Confirme que o agente não está sendo usado em chamadas ativas
  3. Faça backup - Considere fazer backup dos dados importantes antes da exclusão
  4. Teste em ambiente de desenvolvimento - Teste a exclusão em ambiente de desenvolvimento primeiro
  5. Monitore dependências - Verifique se há outras partes do sistema que dependem do agente

Endpoints relacionados

  • Listar Agentes: GET /api/v1/agents
  • Obter Agente: GET /api/v1/agents/{agent_id}
  • Criar Agente: POST /api/v1/agents
  • Atualizar Conhecimento do Agente: PUT /api/v1/agents/{agent_id}/knowledge