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 cosas trabajan juntas, y todas viven en el Catálogo de herramientas (/tools): 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, en el Catálogo de herramientas (/tools), lista cada capacidad que encontró el descubrimiento. 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.
La barra **Aplicar a todas** actúa sobre todas las capacidades cargadas en la página a la vez: Habilitar todas, Deshabilitar todas, Requerir aprobación para todas o Quitar aprobación de todas. Cada acción pide confirmación e indica cuántas capacidades cambiará; las que ya coinciden se dejan sin tocar. Si aún quedan capacidades sin cargar, solo se ven afectadas las cargadas.
Disponibilidad de herramientas
La disponibilidad de herramientas, también en el Catálogo de herramientas (/tools), 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
Las habilidades, la tercera área del Catálogo de herramientas (/tools), gobiernan 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.