# Requisição 1: Criar novo treinamento
curl -X POST "https://app.talkover.ai/api/v1/agents/agent-uuid-1/trainings" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"question": "Como posso ajudar com informações sobre produtos?",
"answer": "Posso fornecer informações detalhadas sobre nossos produtos, incluindo especificações, preços e disponibilidade. Qual produto você gostaria de conhecer?"
}'
// Requisição 1: Criar novo treinamento
const response = await fetch('https://app.talkover.ai/api/v1/agents/agent-uuid-1/trainings', {
method: 'POST',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here',
'Content-Type': 'application/json'
},
body: JSON.stringify({
question: 'Como posso ajudar com informações sobre produtos?',
answer: 'Posso fornecer informações detalhadas sobre nossos produtos, incluindo especificações, preços e disponibilidade. Qual produto você gostaria de conhecer?'
})
});
const result = await response.json();
console.log(result);
{
"success": true,
"message": "Treinamento criado com sucesso",
"data": {
"id": "training-uuid-1",
"question": "Como posso ajudar com informações sobre produtos?",
"answer": "Posso fornecer informações detalhadas sobre nossos produtos, incluindo especificações, preços e disponibilidade. Qual produto você gostaria de conhecer?",
"created_at": "2024-01-01T00:00:00Z",
"updated_at": "2024-01-01T00:00:00Z"
}
}
Treinamentos
Criar/Atualizar Treinamento
Criar ou atualizar dados de treinamento para um agente específico
POST
/
api
/
v1
/
agents
/
{agent_id}
/
trainings
# Requisição 1: Criar novo treinamento
curl -X POST "https://app.talkover.ai/api/v1/agents/agent-uuid-1/trainings" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"question": "Como posso ajudar com informações sobre produtos?",
"answer": "Posso fornecer informações detalhadas sobre nossos produtos, incluindo especificações, preços e disponibilidade. Qual produto você gostaria de conhecer?"
}'
// Requisição 1: Criar novo treinamento
const response = await fetch('https://app.talkover.ai/api/v1/agents/agent-uuid-1/trainings', {
method: 'POST',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here',
'Content-Type': 'application/json'
},
body: JSON.stringify({
question: 'Como posso ajudar com informações sobre produtos?',
answer: 'Posso fornecer informações detalhadas sobre nossos produtos, incluindo especificações, preços e disponibilidade. Qual produto você gostaria de conhecer?'
})
});
const result = await response.json();
console.log(result);
{
"success": true,
"message": "Treinamento criado com sucesso",
"data": {
"id": "training-uuid-1",
"question": "Como posso ajudar com informações sobre produtos?",
"answer": "Posso fornecer informações detalhadas sobre nossos produtos, incluindo especificações, preços e disponibilidade. Qual produto você gostaria de conhecer?",
"created_at": "2024-01-01T00:00:00Z",
"updated_at": "2024-01-01T00:00:00Z"
}
}
Criar/Atualizar Treinamento
Criar ou atualizar dados de treinamento para um agente específico. Adiciona perguntas e respostas para melhorar o desempenho do agente.Endpoint
POST /api/v1/agents/{agent_id}/trainings
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
Pergunta para o treinamento (máximo 1000 caracteres).
string
obrigatório
Resposta para o treinamento (máximo 2000 caracteres).
Exemplos de Requisição
# Requisição 1: Criar novo treinamento
curl -X POST "https://app.talkover.ai/api/v1/agents/agent-uuid-1/trainings" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"question": "Como posso ajudar com informações sobre produtos?",
"answer": "Posso fornecer informações detalhadas sobre nossos produtos, incluindo especificações, preços e disponibilidade. Qual produto você gostaria de conhecer?"
}'
// Requisição 1: Criar novo treinamento
const response = await fetch('https://app.talkover.ai/api/v1/agents/agent-uuid-1/trainings', {
method: 'POST',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here',
'Content-Type': 'application/json'
},
body: JSON.stringify({
question: 'Como posso ajudar com informações sobre produtos?',
answer: 'Posso fornecer informações detalhadas sobre nossos produtos, incluindo especificações, preços e disponibilidade. Qual produto você gostaria de conhecer?'
})
});
const result = await response.json();
console.log(result);
# Requisição 2: Criar treinamento para suporte técnico
curl -X POST "https://app.talkover.ai/api/v1/agents/agent-uuid-1/trainings" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"question": "Qual é o processo de suporte técnico?",
"answer": "Para suporte técnico, posso ajudá-lo a identificar o problema e orientá-lo sobre os próximos passos. Posso também agendar um técnico se necessário. Qual é o problema que você está enfrentando?"
}'
// Requisição 2: Criar treinamento para suporte técnico
const response = await fetch('https://app.talkover.ai/api/v1/agents/agent-uuid-1/trainings', {
method: 'POST',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here',
'Content-Type': 'application/json'
},
body: JSON.stringify({
question: 'Qual é o processo de suporte técnico?',
answer: 'Para suporte técnico, posso ajudá-lo a identificar o problema e orientá-lo sobre os próximos passos. Posso também agendar um técnico se necessário. Qual é o problema que você está enfrentando?'
})
});
const result = await response.json();
console.log(result);
Resposta
Resposta de Sucesso (201 Created)
{
"success": true,
"message": "Treinamento criado com sucesso",
"data": {
"id": "training-uuid-1",
"question": "Como posso ajudar com informações sobre produtos?",
"answer": "Posso fornecer informações detalhadas sobre nossos produtos, incluindo especificações, preços e disponibilidade. Qual produto você gostaria de conhecer?",
"created_at": "2024-01-01T00:00:00Z",
"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
Dados do treinamento criado.
Mostrar Dados do Treinamento
Mostrar Dados do Treinamento
string
obrigatório
Identificador único do treinamento criado.
string
obrigatório
Pergunta do treinamento.
string
obrigatório
Resposta do treinamento.
string
obrigatório
Timestamp ISO 8601 quando o treinamento foi criado.
string
obrigatório
Timestamp ISO 8601 quando o treinamento foi atualizado pela última vez.
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": {
"question": [
"The question field is required."
],
"answer": [
"The answer field is required."
],
"question": [
"The question may not be greater than 1000 characters."
],
"answer": [
"The answer may not be greater than 2000 characters."
]
}
}
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
Limites de caracteres. Perguntas têm limite de 1000 caracteres e respostas de 2000 caracteres.
Melhoria de desempenho. Dados de treinamento ajudam a melhorar o desempenho do agente.
Perguntas claras. Use perguntas claras e específicas para melhor treinamento.
Respostas úteis. Forneça respostas completas e úteis para melhor experiência do usuário.
Melhores Práticas
- Perguntas específicas - Use perguntas claras e específicas para melhor treinamento
- Respostas detalhadas - Forneça respostas completas e úteis
- Variedade de cenários - Crie treinamentos para diferentes cenários de uso
- Atualização regular - Regularmente atualize os dados de treinamento
- Teste o desempenho - Monitore como os treinamentos afetam o desempenho do agente
Endpoints relacionados
- Listar Treinamentos:
GET /api/v1/agents/{agent_id}/trainings - Excluir Treinamento:
DELETE /api/v1/agents/{agent_id}/trainings/{training_id} - Obter Agente:
GET /api/v1/agents/{agent_id} - Listar Agentes:
GET /api/v1/agents
Esta página foi útil?