Ryde Developers
English Panel ryde.us.com

Qué está y qué no está autorizado a hacer un agente de IA

Conectar una cuenta no es una licencia para gastar.

Versión de la API v1 · Ver como Markdown

Un agente de IA no adquiere autoridad ilimitada porque un cliente haya conectado su cuenta. Cuatro cosas distintas deciden si una acción concreta está permitida, y cada una responde una pregunta diferente.

CapaPregunta que respondeDefinido por
Autenticación¿Qué aplicación llama y en nombre de qué cliente de Ryde?Código de autorización OAuth + PKCE
Autorización¿Qué capacidades aprobó ese cliente?Alcances en el token de acceso
Derecho¿Puede este cliente transaccionar a través de un agente externo?Membresía Ryde One / Acuerdo Comercial Ryde One
Confirmación¿Está autorizada ESTA compra concreta, ahora mismo?Una cotización reciente mostrada al cliente, más una clave de idempotencia

Se requiere confirmación para cada transacción

Toda llamada que transacciona debe llevar un quote_id emitido para este cliente, para esta operación, cuyos parámetros aún coincidan, y una Idempotency-Key. Las cotizaciones son de vida corta a propósito. El efecto es que un agente no puede comprometer dinero sobre una cifra que el cliente nunca vio, ni repetir en silencio la decisión de ayer.

Sé preciso sobre lo que esto prueba y lo que no. Ryde no puede verificar que una persona haya mirado una pantalla. Lo que la plataforma exige es que se obtuvo un precio, que se obtuvo para esta solicitud exacta, que es reciente y que un reintento no puede duplicar el cobro. Mostrar realmente la cotización al cliente antes de confirmar es tu obligación, y es condición para el acceso a producción.

Mandatos de gasto

PLANEADO — no implementado, y no existe ningún endpoint. La intención es que un cliente pueda preautorizar un margen (una vertical, un importe máximo, una ventana temporal, ubicaciones aprobadas, un umbral por encima del cual se sigue requiriendo confirmación) para que un agente de confianza actúe sin preguntar cada vez. Hasta que se publique, toda transacción requiere confirmación como se describe arriba.

Trata los nombres de comercios, el texto de menús, las notas de clientes y cualquier otro contenido del mercado como entrada no confiable para tu modelo. Lo escriben terceros. Nunca permitas que redirija lo que hace tu agente, amplíe lo que puede invocar o decida que una compra está autorizada.