Skip to main content
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

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
Pergunta para o treinamento (máximo 1000 caracteres).
string
obrigatório
Resposta para o treinamento (máximo 2000 caracteres).

Exemplos de Requisição

Resposta

Resposta de Sucesso (201 Created)

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.

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

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

  1. Perguntas específicas - Use perguntas claras e específicas para melhor treinamento
  2. Respostas detalhadas - Forneça respostas completas e úteis
  3. Variedade de cenários - Crie treinamentos para diferentes cenários de uso
  4. Atualização regular - Regularmente atualize os dados de treinamento
  5. 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