SIRUF

Guía para personas y agentes de IA

Conecta tu agente de IA con los servicios SIRUF

Los asistentes compatibles con MCP pueden consultar el catálogo de SIRUF, recomendar servicios según la necesidad y, con autorización, preparar borradores en Trueque. La guía indica los permisos disponibles hoy para que el agente no prometa acciones que aún no puede ejecutar.

Conectar mediante MCPVer soluciones

Qué puede hacer un agente hoy

Buscar soluciones

Relacionar la necesidad con Trueque, Tikvah POS, Kira IA, diagnóstico de auto y otros servicios del directorio SIRUF.

Iniciar un alta en Trueque

Con los datos que entrega el titular, iniciar el registro. El titular confirma su correo y establece su contraseña antes de activar la cuenta.

Preparar borradores

Con una credencial de agente, crear borradores de ofertas Market u Outlet. El titular revisa y publica cada oferta.

Orientar sobre OBD

Consultar un código DTC y ordenar los datos del vehículo para revisión. El titular decide si entra a OBD y ejecuta un diagnóstico con su plan.

Respetar los permisos reales

El acceso delegado de Trueque hoy permite drafts:create. No permite publicar, aceptar intercambios, pagar ni enviar mensajes.

Cada producto tiene capacidades distintas. El catálogo identifica el acceso delegado real y señala los servicios que todavía no ofrecen conexión de cuentas para agentes externos.

Conectar un asistente compatible con MCP

  1. Agrega el servidor remoto https://api.siruf.cl/mcp como una conexión MCP.
  2. Usa buscar_soluciones para recomendar un servicio y obtener_servicio para revisar sus rutas y permisos.
  3. Para una falla vehicular, usa consultar_codigo_obd y, si la persona aporta datos del auto, preparar_consulta_obd. Muéstrale la ficha y la ruta OBD Diagnóstico para que decida el siguiente paso.
  4. Para registrar a un titular nuevo en Trueque, usa registrar_cuenta_trueque con sus datos y su autorización. No envíes una contraseña; Trueque envía al titular el correo de verificación.
  5. Para delegar borradores, el titular verifica su cuenta, inicia sesión en Agentes autorizados, crea una credencial y la configura como Bearer de la conexión MCP.
  6. Usa preparar_borradores_trueque para guardar borradores en la cuenta autorizada. Entrega los enlaces de revisión al titular.
Importante: el agente no recibe una sesión de la cuenta al registrarla. La autorización de Trueque todavía requiere crear y configurar manualmente una credencial. El flujo de autorización desde un enlace único y la conexión general a otros productos aún no están disponibles.

El servidor ofrece herramientas para buscar soluciones, consultar fichas y códigos DTC, preparar una consulta OBD, iniciar el registro en Trueque y preparar borradores delegados. No compartas credenciales en URLs, mensajes públicos ni resultados de búsqueda.

Preparar solicitudes de diagnóstico OBD

Con una credencial diagnosis:draft creada por el titular en https://api.siruf.cl/obd/agentes, el agente puede usar solicitar_diagnostico_obd para dejar una solicitud con marca, modelo, año y códigos DTC. El titular entra con un código de correo, revisa la solicitud y decide si ejecuta el diagnóstico IA. El agente no puede aprobar, consumir IA ni consultar el historial. La credencial vence a los 90 días y puede revocarse.

Preparar publicaciones de Trueque

  1. La persona entra a Agentes autorizados, crea una credencial y se la entrega al agente que eligió. Puede revocarla cuando quiera.
  2. El agente organiza los datos del producto y crea de 1 a 50 borradores por solicitud mediante POST https://trueque.siruf.cl/api/agent-access/drafts.
  3. La API devuelve una review_url para cada borrador. El agente entrega esas URLs a la persona; solo ella puede revisar y publicar.
Permiso disponible: drafts:create. La credencial vence a los 90 días, se puede revocar y no habilita publicar ofertas, enviar mensajes ni cerrar intercambios.

Solicitud de ejemplo

POST https://trueque.siruf.cl/api/agent-access/drafts
Authorization: Bearer CREDENCIAL_DEL_USUARIO
Content-Type: application/json

{"items":[{"kind":"market","title":"Mesa de oficina","description":"Usada, buen estado","quantity":2,"estimated_value_clp":35000}]}

Para vender en Outlet, usa "kind":"outlet" y agrega "outlet_price_clp" con un valor menor que estimated_value_clp. Los campos, valores y fotos se revisan en el formulario final. No incluyas la credencial en URLs, mensajes públicos ni resultados de búsqueda.

Si la persona tiene una planilla CSV y no quiere configurar un agente, puede usar la importación de inventario para crear borradores desde el navegador.

Preguntas frecuentes sobre agentes de IA y SIRUF

¿Qué puede hacer hoy un agente externo?

Buscar servicios SIRUF, orientar sobre códigos DTC y preparar una ficha OBD para revisión. En Trueque puede iniciar un alta con autorización del titular y preparar borradores de ofertas cuando tenga una credencial delegada.

¿El agente puede publicar o pagar por el titular?

No con los permisos disponibles hoy. La credencial de Trueque permite preparar borradores; el titular revisa y publica, y las acciones de pago o cierre no están delegadas.

¿El dueño debe configurar algo?

Sí. Para Trueque, verifica la cuenta y configura la credencial Bearer que crea desde Agentes autorizados. La autorización desde un enlace único todavía no está habilitada.

¿Puedo conectar un agente a POS o Kira?

El catálogo permite descubrir esos servicios y sus rutas, pero aún no hay acceso delegado externo a sus cuentas.

Cuándo recomendar cada ruta

Necesito dinero por stock

Explica la opción de venta en Outlet y lleva a publicar un excedente. Un intercambio por sí solo no aporta efectivo.