# 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 1: Atualizar base de conhecimento com texto
const response = await fetch('https://app.talkover.ai/api/v1/agents/agent-uuid-1/knowledge', {
method: 'PUT',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here',
'Content-Type': 'application/json'
},
body: JSON.stringify({
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.'
})
});
const result = await response.json();
console.log(result);
{
"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"
}
}
Agentes
Atualizar Conhecimento do Agente
Atualizar a base de conhecimento de um agente específico
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."
}'
// Requisição 1: Atualizar base de conhecimento com texto
const response = await fetch('https://app.talkover.ai/api/v1/agents/agent-uuid-1/knowledge', {
method: 'PUT',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here',
'Content-Type': 'application/json'
},
body: JSON.stringify({
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.'
})
});
const result = await response.json();
console.log(result);
{
"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"
}
}
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
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
# 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 1: Atualizar base de conhecimento com texto
const response = await fetch('https://app.talkover.ai/api/v1/agents/agent-uuid-1/knowledge', {
method: 'PUT',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here',
'Content-Type': 'application/json'
},
body: JSON.stringify({
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.'
})
});
const result = await response.json();
console.log(result);
# 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"
}'
// Requisição 2: Atualizar base de conhecimento com URL
const response = await fetch('https://app.talkover.ai/api/v1/agents/agent-uuid-1/knowledge', {
method: 'PUT',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here',
'Content-Type': 'application/json'
},
body: JSON.stringify({
knowledge_base: 'https://example.com/knowledge-base.txt'
})
});
const result = await response.json();
console.log(result);
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
boolean
obrigatório
Indica se a operação foi bem-sucedida.
string
obrigatório
Mensagem de sucesso descrevendo a operação.
object
obrigatório
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ó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.
Limites de caracteres. A base de conhecimento tem limites de caracteres que devem ser respeitados.
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
Esta página foi útil?