Gobierno
Controla exactamente qué puede hacer tu agente y quién puede usar cada herramienta: habilitación y aprobación de capacidades, disponibilidad por usuario y las acciones que tu widget registra en la página.
El gobierno es donde decides qué tiene permitido hacer el agente. Tres superficies trabajan juntas: el gobierno de capacidades para las capacidades de tu API, la disponibilidad de herramientas para decidir quién puede usar cada una, y las habilidades para las acciones que tu widget integrado registra en tu propia página.
Gobierno de capacidades
El gobierno de capacidades (/governance) lista cada capacidad que descubrió la CLI. Cada fila lleva una marca de efecto y dos interruptores independientes.
- Habilitada: si la capacidad se anuncia al agente y este puede llamarla. Apagada significa invisible.
- Requiere aprobación: fuerza un paso de confirmación antes de que la capacidad se ejecute. Activar la aprobación nunca habilita una capacidad deshabilitada; los dos interruptores son independientes.
- Marca de efecto: lectura, escritura o destructiva, para que veas de un vistazo qué capacidades cambian datos.
Disponibilidad de herramientas
La disponibilidad de herramientas (/tool-availability) decide qué herramientas ofrecen las superficies de chat y MCP a cada usuario final. Toda herramienta está disponible por defecto y tu propia API hace cumplir los permisos; añade una regla para dirigir una herramienta a usuarios concretos. Las reglas se basan en la identidad, no en el tiempo: aquí no hay programación horaria.
- Requerir inicio de sesión: ofrece la herramienta solo a usuarios autenticados.
- Permisos requeridos: condiciona la herramienta a permisos (scopes) de OAuth, exigiendo todos o alguno.
- Comparadores de atributos: apunta a un claim de identidad o a un atributo del contexto anfitrión con un operador y un valor.
- Reglas avanzadas: para lógica que el formulario simple no puede expresar, edita la regla como JSON con expresiones and/or/not.
Habilidades
Habilidades (/abilities) gobierna las acciones que tu widget integrado registra en tu página con syncanix.registerAction: acciones del lado del cliente, como refrescar una lista. Son distintas de las capacidades del catálogo, que son tus endpoints de API.
- Interruptor de emergencia: un interruptor maestro que impide que el agente realice cualquier acción registrada, sin importar los interruptores de cada habilidad.
- Interruptor Activa por habilidad: una habilidad inactiva nunca se anuncia al agente y no puede llamarse.
- Confirmación: una habilidad puede requerir que el usuario final confirme antes de ejecutarse. También puedes declarar una habilidad antes de que el widget la registre.