Saltar al contenido principal
Las políticas MAIP le permiten aplicar barreras al comportamiento del agente de IA en tiempo de ejecución. Cuando un agente solicita acceso a un recurso con ámbito, todas las políticas activas se evalúan antes de que la acción continúe. Si alguna política deniega la solicitud, la acción se bloquea.
Las políticas MAIP son diferentes de las políticas de emisión. Las políticas de emisión rigen la acuñación y verificación de credenciales para usuarios e emisores humanos. Las políticas MAIP rigen el comportamiento del agente de máquina en tiempo de ejecución, controlando lo que los agentes pueden hacer basándose en puntuaciones de confianza, profundidad de delegación, alcances y tipo de agente.

Cuándo usar políticas MAIP

Use las políticas de MAIP cuando necesite:
  • Bloquear agentes con puntuaciones de confianza bajas para que no realicen operaciones sensibles
  • Requerir aprobación humana cuando un agente está inmerso en una cadena de delegación
  • Restringir tipos de agentes específicos (por ejemplo, llm o worker) para que no accedan a ciertos ámbitos
  • Aplicar diferentes reglas para diferentes niveles de riesgo sin cambiar el código del agente
  • Añadir barreras de seguridad en tiempo de ejecución a los flujos de trabajo de orquestación multiagente
Si no crea ninguna política de MAIP, el acceso del agente se controla solo mediante asignaciones de alcance y el estado del agente.

Cómo funcionan las políticas

Cada política MAIP contiene una o más reglas. Cada regla tiene:
  • Condiciones — comprobaciones a nivel de campo evaluadas contra el contexto del agente solicitante
  • Efecto — allow, deny, o require_approval
  • requires_approval — bandera opcional que activa un flujo de trabajo de aprobación humana
Las reglas dentro de una política se evalúan de forma independiente. Si cualquier regla con un efecto deny coincide, la acción se bloquea independientemente de cualquier regla allow. Este es un modelo de denegar-anula.

Orden de evaluación

  1. Estado del agente: el agente debe estar active. Los agentes suspendidos o revocados siempre son denegados.
  2. Verificación de alcance: el alcance solicitado debe estar en los alcances concedidos del agente. Los alcances denegados explícitamente (con el prefijo !) siempre bloquean el acceso.
  3. Reglas de política — todas las políticas de inquilino activas se evalúan en orden de prioridad (los números más bajos primero). Las condiciones de cada regla se unen con AND.

Campos de condición

Operadores

Efectos

Creación de una política

Todas las nuevas políticas se crean con status: "active" y entran en vigor inmediatamente.

Categorías de políticas

Prioridad

El campo priority controla el orden de evaluación. Los números más bajos se evalúan primero. Rango: 1–1000. Predeterminado: 100. Si varias políticas comparten la misma prioridad, se evalúan en orden de creación.

Evaluación de políticas en tiempo de ejecución

Llame al endpoint de evaluación antes de que su agente realice una operación sensible. La respuesta le indicará si la acción está permitida, denegada o requiere aprobación humana.
Respuesta permitida:
Respuesta denegada:
Requiere respuesta de aprobación:
Cuando requires_approval es true, su aplicación debe enrutar la acción a través de un flujo de trabajo de aprobación humana antes de continuar.

Listado de políticas

Devuelve todas las políticas MAIP para su inquilino, incluidas sus reglas, prioridad y estado.

Patrones comunes

Bloquear agentes no confiables para que no escriban datos

Denegar a cualquier agente con una puntuación de confianza inferior a 0.5 el acceso a ámbitos de escritura.

Requerir aprobación para cadenas de delegación profunda

Los agentes con más de tres niveles de profundidad en una cadena de delegación deben obtener aprobación humana para cualquier acción.

Restringir a los agentes LLM la ejecución de herramientas

Evitar que los agentes de tipo LLM invoquen ámbitos de ejecución de herramientas mientras se permiten otros tipos de agentes.

Bloquear múltiples tipos de agentes de un ámbito

Utilice el operador in para hacer coincidir una lista de valores en lugar de escribir reglas separadas para cada tipo de agente.

Denegar todos los ámbitos de escritura con una sola regla

Utilice el operador contains para hacer coincidir cualquier ámbito que incluya una subcadena, en lugar de listar cada ámbito de escritura individualmente.

Combinar múltiples reglas en una política

Una sola política puede contener múltiples reglas para una aplicación en capas:
Esta política bloquea directamente a los agentes con puntuaciones de confianza inferiores a 0.3 y requiere aprobación humana para las operaciones de escritura de agentes con puntuaciones entre 0.3 y 0.7.

Políticas MAIP vs. políticas RBAC

Relacionado

Referencia de la API de políticas MAIP

Cree, liste y evalúe políticas MAIP a través de la API REST.

Puntuaciones de confianza

Comprenda el sistema de puntuación de confianza que alimenta las condiciones de la política.

Autorización del agente

Autorización basada en alcance y gestión de sesiones para agentes.

Identidad de máquina

Descripción general completa del Protocolo de Identidad del Agente de Máquina.