Intent Specification 0.2

Cómo una IA decide usar OniPin

El usuario dice "agenda una cita" — no "usa OniPin". Esta spec define el flujo que cualquier asistente puede implementar.

Flujo en 5 pasos

1. Descubrir — ¿El negocio publica OniPin? (/v1/discover, meta onipin, llms.txt)
2. Handshake — Anunciar agente + intención (POST /v1/handshake/{pin})
3. Enviar mensaje — POST /v1/chat/{pin}
4. Recibir respuesta — Texto + conversationId
5. Acción — Cita/pedido en Agenda (data.bookingId / orderId)

Descubrir desde URL

curl "https://onnivers.store/v1/discover?url=https://onnivers.store/probar-chat/"

Handshake

curl -X POST https://onnivers.store/v1/handshake/onp_vuzadcjv3xw7 \
  -H "Content-Type: application/json" \
  -d '{"agent":{"name":"MyBot","version":"1.0"},"intent":"appointment.create"}'

Chat con intent

curl -X POST https://onnivers.store/v1/chat/onp_vuzadcjv3xw7 \
  -H "Content-Type: application/json" \
  -H "X-Caller-Type: ai-agent" \
  -d '{"message":"Quiero demo el viernes","agent":{"name":"MyBot"},"intent":"appointment.create"}'

Intenciones

• business.chat — conversación general
• appointment.create — cita / demo
• order.create — pedido
• product.price — precio
• catalog.browse — catálogo
• payment.info — pago

← Documentación completa · Pin demo:onp_vuzadcjv3xw7