API de Sonoe

Sonoe es un modelo de decisión. Mandas un estado (texto o JSON) y un conjunto de preguntas tipadas, y responde cada una con probabilidades calibradas que tu código puede usar. Nunca escribe texto libre, así que no hay nada que interpretar.

Cómo se ve una solicitud

Un estado, las preguntas que quieras, un solo viaje:

curl https://api.sonoeai.com/v1/systemone \
  -H "Authorization: Bearer $SONOE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sonoe-latest",
    "state": "Me cobraron dos veces el pedido 4417 y necesito el dinero hoy.",
    "questions": {
      "reembolso": { "type": "noul", "instructions": "¿Pide un reembolso?" },
      "equipo": {
        "type": "choice",
        "instructions": "¿Qué equipo debe atender esto?",
        "criteria": {
          "facturacion": "Pagos, cobros, reembolsos",
          "envios": "Entregas y rastreo",
          "tecnico": "Errores, la app o la página"
        }
      }
    }
  }'

{
  "model": "sonoe-1.1.0",
  "answers": {
    "reembolso": { "type": "noul", "noul": 0.9481 },
    "equipo": {
      "type": "choice",
      "choice": "facturacion",
      "probabilities": { "facturacion": 0.9797, "envios": 0.0067, "tecnico": 0.0136 },
      "confidence": 0.8978
    }
  },
  "usage": { "input_tokens": 246, "output_tokens": 0 }
}

Tu código lee answers.equipo.choice y enruta el caso. Si confidence es baja, puede preguntarle a una persona en vez de adivinar. Mira Confianza.

Por qué un modelo de decisión

• Las respuestas son datos. Una probabilidad, una opción que tú definiste o una posición en tu escala. Nada que interpretar, ningún reintento por una respuesta mal formada.
• Las probabilidades están calibradas. Un 0.9 debe acertar cerca del 90% de las veces, así que los umbrales significan algo.
• Sabe cuándo no sabe. Cada Choice y cada Score traen una confianza, y la API nativa puede abstenerse por ti.
• Pequeño y rápido. Sonoe 1.1 es un modelo multilingüe de 118M de parámetros que corre en CPU. Una solicitud con pocas preguntas tarda decenas de milisegundos.

Dos APIs, un modelo

Las dos usan el mismo modelo y se cobran igual: por los tokens que el modelo lee.

Próximos pasos