Pular para o conteúdo principal
PUT
/
api
/
v1
/
agents
/
{agent_id}
/
knowledge
# Requisição 1: Atualizar base de conhecimento com texto
curl -X PUT "https://app.talkover.ai/api/v1/agents/agent-uuid-1/knowledge" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "knowledge_base": "Este é um agente de atendimento ao cliente atualizado. Ele pode ajudar com informações sobre produtos, serviços, preços, suporte técnico e reclamações. O agente é especializado em resolver problemas rapidamente e fornecer informações precisas."
  }'
{
  "success": true,
  "message": "Base de conhecimento atualizada com sucesso",
  "data": {
    "id": "agent-uuid-1",
    "knowledge_base": "Este é um agente de atendimento ao cliente atualizado. Ele pode ajudar com informações sobre produtos, serviços, preços, suporte técnico e reclamações. O agente é especializado em resolver problemas rapidamente e fornecer informações precisas.",
    "updated_at": "2024-01-01T00:00:00Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.talkover.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

PUT /api/v1/agents/{agent_id}/knowledge

Parâmetros de Caminho

agent
string
obrigatório
O identificador único do agente. Você pode encontrá-lo na lista de agentes.

Cabeçalhos da Requisição

Authorization
string
obrigatório
Token Bearer para autenticação. Formato: Bearer talq_your_environment_token_here
Content-Type
string
obrigatório
Application JSON. Formato: application/json

Corpo da Requisição

knowledge_base
string
obrigatório
Nova base de conhecimento do agente (texto ou URL).

Exemplos de Requisição

# Requisição 1: Atualizar base de conhecimento com texto
curl -X PUT "https://app.talkover.ai/api/v1/agents/agent-uuid-1/knowledge" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "knowledge_base": "Este é um agente de atendimento ao cliente atualizado. Ele pode ajudar com informações sobre produtos, serviços, preços, suporte técnico e reclamações. O agente é especializado em resolver problemas rapidamente e fornecer informações precisas."
  }'
# Requisição 2: Atualizar base de conhecimento com URL
curl -X PUT "https://app.talkover.ai/api/v1/agents/agent-uuid-1/knowledge" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "knowledge_base": "https://example.com/knowledge-base.txt"
  }'

Resposta

Resposta de Sucesso (200 OK)

{
  "success": true,
  "message": "Base de conhecimento atualizada com sucesso",
  "data": {
    "id": "agent-uuid-1",
    "knowledge_base": "Este é um agente de atendimento ao cliente atualizado. Ele pode ajudar com informações sobre produtos, serviços, preços, suporte técnico e reclamações. O agente é especializado em resolver problemas rapidamente e fornecer informações precisas.",
    "updated_at": "2024-01-01T00:00:00Z"
  }
}

Campos da Resposta

success
boolean
obrigatório
Indica se a operação foi bem-sucedida.
message
string
obrigatório
Mensagem de sucesso descrevendo a operação.
data
object
obrigatório
Dados da atualização.

Respostas de Erro

404 Não Encontrado

{
  "success": false,
  "message": "Agent not found"
}

422 Erro de Validação

{
  "success": false,
  "message": "The given data was invalid.",
  "errors": {
    "knowledge_base": [
      "The knowledge base field is required."
    ]
  }
}

401 Não Autorizado

{
  "success": false,
  "message": "Unauthorized"
}

500 Erro do Servidor

{
  "success": false,
  "message": "Internal server error."
}

Códigos de Erro

CódigoDescriçãoStatus HTTP
AGENT_NOT_FOUNDAgente especificado não existe404
VALIDATION_ERRORValidação da requisição falhou422
INVALID_TOKENToken de autenticação inválido ou ausente401
SERVER_ERRORErro interno do servidor ocorreu500

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