Catálogo y capacidades
Explora las capacidades descubiertas y afina cada una: su descripción, permisos, riesgo y más.
El catálogo es la lista de todo lo que el asistente puede hacer, descubierto a partir de tu API. Aquí lo revisas y ajustas cada capacidad.
Explorar el catálogo
Las capacidades se agrupan por dominio, cada una con su método HTTP, su efecto y una marca de interno cuando corresponde. Busca por nombre y filtra por método, por efecto o para ocultar las internas.
Activar y ajustar una capacidad, paso a paso
Una capacidad debe revisarse y activarse antes de que el asistente la use. Este es el ciclo completo:
- Abre la capacidadEncuéntrala en el catálogo —búscala por nombre o fíltrala por método— y ábrela para mostrar sus pestañas de edición.
- Dale una descripción claraEn la pestaña General, define un nombre visible sencillo y una descripción de lo que hace. Una buena indicación de «cuándo usar esto» en la pestaña Prompt ayuda al asistente a elegirla en el momento adecuado.
- Define su riesgoEn la pestaña Risk, confirma o anula la clase de efecto secundario (Read, Write o Destructive) y fija un nivel de riesgo (de Low a Critical). esto decide si la acción se ejecuta automáticamente, pide confirmación o queda bloqueada. Los cambios aquí se guardan automáticamente.
- Actívala en la página de GovernanceLas capacidades recién descubiertas empiezan desactivadas. Abre la página de Governance y pon la capacidad en Enabled para que el asistente pueda usarla; y, si quieres, activa Require approval. Hasta que no esté habilitada, el asistente no puede verla ni llamarla.
Editar una capacidad
Abre una capacidad para editarla en varias pestañas:
- General: el nombre visible, la descripción y si la capacidad es interna o externa.
- Permisos: los permisos descubiertos que necesita un usuario, más un mapa para renombrarlos.
- Esquema: las formas de solicitud y respuesta, en modo de solo lectura.
- Prompt: una indicación de «cuándo usar esto» que guía al asistente.
- Riesgo: anula el efecto y define un nivel de riesgo, de bajo a crítico.
- Auditoría: el historial completo de cambios, con un diff y reversión con un clic.
Guardado automático e historial
Tus cambios se guardan automáticamente a medida que los haces. Si otra persona modifica la misma capacidad, un aviso te permite recargar en lugar de sobrescribir su trabajo, y la pestaña Auditoría conserva el historial completo para que siempre puedas mirar atrás o revertir.