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
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_herestring
obrigatório
Application JSON. Formato:
application/jsonCorpo da requisição
string
obrigatório
Nova base de conhecimento do agente (texto ou URL).
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.
object
obrigatório
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
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