Agentes
Atualizar Conhecimento do Agente
Atualizar a base de conhecimento de um agente específico
PUT
Atualizar Conhecimento do Agente
Atualizar a base de conhecimento de um agente específico. Esta operação substitui completamente a base de conhecimento existente.Endpoint
Parâmetros de caminho
O identificador único do agente. Você pode encontrá-lo na lista de agentes.
Cabeçalhos da requisição
Token Bearer para autenticação. Formato:
Bearer talq_your_environment_token_hereApplication JSON. Formato:
application/jsonCorpo da requisição
Nova base de conhecimento do agente (texto ou URL).
Exemplos de Requisição
Resposta
Resposta de Sucesso (200 OK)
Campos da Resposta
Indica se a operação foi bem-sucedida.
Mensagem de sucesso descrevendo a operação.
Dados da atualização.
Respostas de erro
404 Não Encontrado
422 Erro de Validação
401 Não Autorizado
500 Erro do Servidor
Códigos de erro
| Código | Descrição | Status HTTP |
|---|---|---|
AGENT_NOT_FOUND | Agente especificado não existe | 404 |
VALIDATION_ERROR | Validação da requisição falhou | 422 |
INVALID_TOKEN | Token de autenticação inválido ou ausente | 401 |
SERVER_ERROR | Erro interno do servidor ocorreu | 500 |
Notas Importantes
Substituição completa. Esta operação substitui completamente a base de conhecimento existente.
Suporte a URL. A base de conhecimento pode ser fornecida como texto ou URL.
Processamento assíncrono. URLs são processadas de forma assíncrona.
Melhores Práticas
- Backup antes de atualizar - Faça backup da base de conhecimento atual antes de substituí-la
- Teste em rascunho - Teste mudanças em agentes em modo rascunho antes de publicar
- Base de conhecimento detalhada - Forneça informações abrangentes para melhor desempenho
- URLs confiáveis - Use URLs confiáveis e acessíveis quando fornecer base de conhecimento via URL
- Validação de conteúdo - Verifique se o conteúdo da base de conhecimento está correto antes de atualizar
Endpoints relacionados
- Obter Agente:
GET /api/v1/agents/{agent_id} - Atualizar Voz do Agente:
PUT /api/v1/agents/{agent_id}/voice - Publicar Agente:
POST /api/v1/agents/{agent_id}/publish - Listar Agentes:
GET /api/v1/agents