Treinamentos
Criar/Atualizar Treinamento
Criar ou atualizar dados de treinamento para um agente específico
POST
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
Parâmetros de caminho
O identificador único do agente. Você pode encontrá-lo na lista de agentes.
Cabeçalhos da requisição
Token Bearer para autenticação. Formato:
Bearer talq_your_environment_token_hereApplication JSON. Formato:
application/jsonCorpo da requisição
Pergunta para o treinamento (máximo 1000 caracteres).
Resposta para o treinamento (máximo 2000 caracteres).
Exemplos de Requisição
Resposta
Resposta de Sucesso (201 Created)
Campos da Resposta
Indica se a operação foi bem-sucedida.
Mensagem de sucesso descrevendo a operação.
Dados do treinamento criado.
Respostas de erro
404 Não Encontrado
422 Erro de Validação
401 Não Autorizado
500 Erro do Servidor
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.
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