El catálogo de capacidades
La lista estructurada de lo que tu API puede hacer: se descubre una vez, la editas tú y la leen todas las superficies.
El catálogo de capacidades es el corazón de Syncanix. Es una descripción estructurada de todo lo que tu producto puede hacer, descubierta a partir de tu API y refinada por ti. Todas las superficies —el widget, el chat, el servidor MCP— leen de este único catálogo, de modo que lo que tu asistente puede hacer es coherente en todas partes y se edita en un solo lugar.
Qué es una capacidad
Una capacidad es una sola cosa que tu API puede hacer: un endpoint o acción, como «consultar un pedido» o «reembolsar un pago». Cada una se describe lo suficiente para que el asistente entienda qué hace, qué necesita y cuándo usarla.
Qué incluye cada capacidad
- Identificador
- Un id estable con la forma dominio.acción (por ejemplo orders.refund), usado en todos los lugares donde se referencia la capacidad.
- Método y ruta
- El método y la ruta HTTP a los que se corresponde la capacidad (por ejemplo POST /orders/{id}/refund).
- Entradas
- Los argumentos que acepta la acción, con sus nombres y tipos, nunca valores de ejemplo de tus datos.
- Descripción
- Un resumen en lenguaje claro de lo que hace la acción. Es lo que lee el asistente para decidir si la usa y cuándo.
- Efecto
- Si la acción lee, escribe o es destructiva, lo que determina cómo se confirma antes de ejecutarse.
- Riesgo
- Un nivel de riesgo que te permite tratar algunas acciones con más cautela de la que sugeriría su efecto por sí solo.
- Permisos requeridos
- Los permisos (scopes) que un usuario debe tener para que la acción siquiera se le ofrezca.
- Marca de interno
- Marca una capacidad como interna para que quede fuera del alcance del asistente sin salir de tu catálogo.
- Marcas de datos personales
- Marca las entradas o salidas que contienen datos personales, para tratarlas y redactarlas adecuadamente.
Descubierto y luego editado
El descubrimiento propone el catálogo leyendo tu código de forma estática. A partir de ahí lo editas tú: renombras capacidades, afinas descripciones, defines efectos y riesgo, marcas endpoints como internos y ajustas los permisos requeridos, todo en el panel. Tus cambios se guardan como anulaciones, de modo que sobreviven al siguiente descubrimiento.
Una única fuente de verdad
Como el widget, la superficie de chat y el servidor MCP leen del mismo catálogo, defines una sola vez lo que el asistente puede hacer. Cambia una capacidad en el panel y todas las superficies lo reflejan.