Estado

El estado es aquello sobre lo que Sonoe decide: un mensaje de soporte, una búsqueda, un registro de tu base de datos, la situación actual de tu app. Todas las preguntas de una solicitud se responden sobre el mismo estado.

Formas

state puede ser texto, un objeto o una lista.

{ "state": "Me cobraron dos veces el pedido 4417 y necesito el dinero hoy." }

{
  "state": {
    "canal": "chat",
    "plan": "pro",
    "mensaje": "Me cobraron dos veces el pedido 4417."
  }
}

{
  "state": [
    "Cliente: mi pedido no ha llegado",
    "Agente: déjame revisar el número de rastreo",
    "Cliente: dice entregado pero no está aquí"
  ]
}

Los objetos se leen como líneas clave: valor, y los objetos anidados van con sangría bajo su clave. Las listas se leen como una lista, un elemento por línea. Así, el objeto de arriba le llega al modelo como:

canal: chat
plan: pro
mensaje: Me cobraron dos veces el pedido 4417.

Cuánto lee Sonoe

Sonoe lee hasta 256 tokens por cada par (estado + pregunta, opción). Son unas 150 a 200 palabras, compartidas entre el estado, la pregunta y una opción. Lo que pase de ahí se corta al final, así que:

• Pon primero lo que importa.
• Manda el mensaje, no toda la conversación, cuando decides sobre el último mensaje.
• Deja fuera los campos que las preguntas no necesitan (ids, fechas, banderas internas).

Dale hechos, no cuentas

Sonoe decide; no calcula. Si una pregunta depende de un número, calcúlalo en tu código y pon el resultado en el estado:

{
  "state": {
    "tienda": "Farmacia Central",
    "distancia": "5 minutos a pie",
    "abierta_ahora": "sí"
  }
}

«5 minutos a pie» funciona mejor que unas coordenadas, y «abierta_ahora: sí» mejor que el horario y la hora actual.

Sí o no sobre un estado estructurado

Cuando el estado es un objeto con valores cortos y haces una pregunta de sí o no, Sonoe primero busca el campo del que trata la pregunta y luego responde solo con ese campo. «¿Puedo ir con mi perro?» sobre un registro con acepta_mascotas: no lee solo esa línea. No tienes que hacer nada para que pase; solo usa nombres de campo claros.

Idioma

Sonoe es multilingüe. El estado, la pregunta y las opciones pueden estar en idiomas distintos: un mensaje en español con opciones en inglés funciona. Mira Modelos para saber qué tan bien le va en cada idioma.