Skip to main content
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_here
string
obrigatório
Application JSON. Formato: application/json

Corpo 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.
Limites de caracteres. A base de conhecimento tem limites de caracteres que devem ser respeitados.

Melhores Práticas

  1. Backup antes de atualizar - Faça backup da base de conhecimento atual antes de substituí-la
  2. Teste em rascunho - Teste mudanças em agentes em modo rascunho antes de publicar
  3. Base de conhecimento detalhada - Forneça informações abrangentes para melhor desempenho
  4. URLs confiáveis - Use URLs confiáveis e acessíveis quando fornecer base de conhecimento via URL
  5. 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