Pular para o conteúdo principal
GET
/
api
/
v1
/
agents
/
{agent_id}
/
trainings
# Requisição 1: Obter todos os treinamentos de um agente
curl -X GET "https://app.talkover.ai/api/v1/agents/agent-uuid-1/trainings" \
  -H "Authorization: Bearer talq_your_environment_token_here"
{
  "success": true,
  "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"
    },
    {
      "id": "training-uuid-2",
      "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.",
      "created_at": "2024-01-01T01:00:00Z",
      "updated_at": "2024-01-01T01:00:00Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "last_page": 3,
    "per_page": 20,
    "total": 50,
    "from": 1,
    "to": 20
  }
}

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.

Listar Treinamentos

Recuperar uma lista de dados de treinamento para um agente específico com suporte à paginação.

Endpoint

GET /api/v1/agents/{agent_id}/trainings

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

Parâmetros de Consulta

per_page
integer
Número de itens por página (padrão: 20, máximo: 100)
page
integer
Número da página (padrão: 1)

Exemplos de Requisição

# Requisição 1: Obter todos os treinamentos de um agente
curl -X GET "https://app.talkover.ai/api/v1/agents/agent-uuid-1/trainings" \
  -H "Authorization: Bearer talq_your_environment_token_here"
# Requisição 2: Obter treinamentos com paginação
curl -X GET "https://app.talkover.ai/api/v1/agents/agent-uuid-1/trainings?per_page=50&page=1" \
  -H "Authorization: Bearer talq_your_environment_token_here"

Resposta

Resposta de Sucesso (200 OK)

{
  "success": true,
  "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"
    },
    {
      "id": "training-uuid-2",
      "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.",
      "created_at": "2024-01-01T01:00:00Z",
      "updated_at": "2024-01-01T01:00:00Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "last_page": 3,
    "per_page": 20,
    "total": 50,
    "from": 1,
    "to": 20
  }
}

Campos da Resposta

success
boolean
obrigatório
Indica se a operação foi bem-sucedida.
data
array
obrigatório
Array de objetos de treinamento.
pagination
object
obrigatório
Metadados de paginação.

Respostas de Erro

404 Não Encontrado

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

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
INVALID_TOKENToken de autenticação inválido ou ausente401
SERVER_ERRORErro interno do servidor ocorreu500

Notas Importantes

Suporte à paginação. Use parâmetros page e per_page para navegar pelos resultados.
Dados de treinamento. Os dados de treinamento ajudam a melhorar o desempenho do agente.
Perguntas e respostas. Cada treinamento contém uma pergunta e sua resposta correspondente.

Melhores Práticas

  1. Use paginação - Sempre use paginação para grandes conjuntos de dados de treinamento
  2. Mantenha dados atualizados - Regularmente atualize os dados de treinamento para melhorar o desempenho
  3. Qualidade das perguntas - Use perguntas claras e específicas para melhor treinamento
  4. Respostas detalhadas - Forneça respostas completas e úteis
  5. Monitore desempenho - Acompanhe como os dados de treinamento afetam o desempenho do agente

Endpoints Relacionados

  • Criar/Atualizar Treinamento: POST /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