Skip to main content
POST
/
api
/
conversations
/
{conversationId}
/
evaluate
curl -X POST https://app.horneross.com/api/conversations/conv_abc123/evaluate \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "guidelines": "Evaluar claridad, precisión y amabilidad de las respuestas"
  }'

{
  "success": true,
  "evalRun": {
    "id": "eval_xyz789",
    "type": "llm_judge",
    "status": "completed",
    "overallScore": 8.5,
    "scores": {
      "clarity": 9,
      "accuracy": 8,
      "helpfulness": 9,
      "tone": 8
    },
    "createdAt": "2024-01-21T16:00:00Z",
    "completedAt": "2024-01-21T16:00:05Z"
  }
}

​
Endpoint

POST /api/conversations/{conversationId}/evaluate
Ejecutá una evaluación completa de una conversación usando LLM-as-Judge.
Esta evaluación usa un modelo LLM para analizar toda la conversación y generar scores de calidad en múltiples dimensiones.

​
Path Parameters

​
conversationId
string
required
ID de la conversación a evaluar

​
Headers

​
Authorization
string
required
Bearer token con tu API key de organización.
​
Content-Type
string
required
Siempre application/json

​
Request Body

​
model
string
default:"gpt-4o-mini"
Modelo a usar para la evaluación. Valores: gpt-4o, gpt-4o-mini, claude-3-5-sonnet
​
guidelines
string
Guías personalizadas para la evaluación. Si no se proporciona, se usan las guías por defecto.
curl -X POST https://app.horneross.com/api/conversations/conv_abc123/evaluate \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "guidelines": "Evaluar claridad, precisión y amabilidad de las respuestas"
  }'

​
Response

​
success
boolean
required
Si la evaluación fue exitosa
​
evalRun
object
Resultado de la evaluación
​
error
string
Mensaje de error si la evaluación falló
{
  "success": true,
  "evalRun": {
    "id": "eval_xyz789",
    "type": "llm_judge",
    "status": "completed",
    "overallScore": 8.5,
    "scores": {
      "clarity": 9,
      "accuracy": 8,
      "helpfulness": 9,
      "tone": 8
    },
    "createdAt": "2024-01-21T16:00:00Z",
    "completedAt": "2024-01-21T16:00:05Z"
  }
}