AI agents

Qué es un AI agent

• Un AI agent pertenece a un tenant y lista: instrucciones personalizadas para el asistente de IA (hasta 4000 caracteres), los roles MCP a los que hace referencia, las skills que permite por área y las tools que permite.
• Las instrucciones son un punto de partida para la conversación — contexto extra, tono o procedimiento que el administrador del tenant quiere que el asistente de IA siga — no una forma de conceder un acceso que un rol no permita ya.
• Un administrador del tenant crea, edita y publica AI agents en el Admin Center. Un usuario cuyo rol MCP incluya AI agents: Write también puede proponer desde un cliente de IA un agente nuevo o un cambio; la propuesta se guarda como borrador y no hace nada hasta que un administrador la publica en Agent Studio.

Tres capas, una sola regla

La regla es siempre la misma: el acceso efectivo es la intersección entre el acceso del usuario y el del AI agent. Si el AI agent no menciona un rol, una skill o una tool que el usuario tiene, ese rol, skill o tool simplemente no se ofrece mientras el AI agent está seleccionado — nunca se añade encima de lo que el usuario ya tiene. Un AI agent con una lista vacía para algo (sin roles listados, sin skills restringidas) significa que hereda el acceso completo del usuario para esa capa en lugar de acotarlo.

Crear uno

En el Admin Center, entra en AI & MCP → AI agents y pulsa New AI agent: dale un nombre, escribe sus instrucciones y elige los roles MCP, las secciones de Business Central y las tools a las que debe acotar la conexión. Un administrador del tenant puede hacerlo directamente — consulta Roles MCP para ver cómo se crean y asignan los propios roles. Los usuarios sin derechos de administrador solo pueden proponer un agente, como se describe a continuación.

Proponer agentes desde un cliente de IA

Un cliente de IA conectado al servidor de Business Central o de Dynamics 365 CRM puede ayudar a un usuario a diseñar un AI agent o un subagente, y una skill que lo acompañe, sin abrir el Admin Center. Todo lo que crea es un borrador.

Permisos. Añade las líneas AI agents y Skills, cada una con Read o Write, a un rol MCP del destino Business Central y asígnalo al usuario. Read permite al cliente de IA consultar las definiciones existentes y el catálogo; Write le permite proponer borradores. Las líneas también aplican en el servidor de Dynamics 365 CRM: una sesión de CRM sigue necesitando un rol de Business Central que las incluya. Write en una línea no concede Write en la otra.

Pasos.

1. El cliente de IA lee el catálogo de lo que el usuario puede usar: límites, política de revisión, agentes existentes, tools, skills y los roles que se pueden asignar.
2. Propone un agente nuevo (opcionalmente como subagente de uno existente) o un cambio en un agente existente y, cuando el agente lo necesita, una skill nueva o modificada. El usuario puede pedir ajustes hasta que el borrador quede bien.
3. Cuando el usuario lo confirma, el cliente de IA envía el borrador a revisión.
4. Un administrador del tenant lo revisa y lo publica en Agent Studio; una skill se publica en Skills → Proposed changes. Consulta Agent studio.

Hasta entonces, el agente publicado y la skill publicada siguen funcionando exactamente como antes.

Tools. Nueve tools plure_* cubren estos pasos:

Conviene saber.

• Un agente nuevo no se puede usar hasta su primera publicación: aparece como Awaiting first publication y select_agent no lo encuentra. Un subagente no se puede publicar antes que su padre.
• Los roles añadidos a una propuesta nunca pueden conceder más que los roles del propio usuario.
• Una propuesta solo puede usar las tools y skills que permite su agente padre, y un agente gestionado por Plur-e no se puede cambiar de esta forma.
• Las propuestas no se ofrecen en ejecuciones autónomas, y un cliente de IA no puede publicar, habilitar ni borrar un agente.
• La guía agent-authoring, que el cliente de IA lee antes de proponer nada, explica el modelo: instrucciones, tools, skills, roles, versiones y los errores que puede encontrar.

Elegirlo al conectar

• Pantalla de consentimiento: los usuarios del tenant que ven la pantalla de consentimiento OAuth al conectar obtienen un desplegable AI agent con los AI agents del tenant, más "None". Elegir uno lo fija para esa conexión.
• select_agent: cualquier cliente puede llamar a select_agent con el nombre exacto del agente, o con "none" para quitar el que ya estaba seleccionado, en cualquier momento de la conversación.
• Cabecera X-Plure-Agent: los clientes sin estado que envían una cabecera en cada petición pueden enviar X-Plure-Agent con el nombre del agente en cada llamada; enviar X-Plure-Agent: none lo quita.

Dos tools de solo lectura ayudan a un cliente a descubrir qué hay disponible: plure_list_agents (los AI agents del tenant, nombre y descripción) y plure_current_agent (el seleccionado para esta conexión, si lo hay).

Qué cambia

• Las instrucciones elegidas en la pantalla de consentimiento o mediante la cabecera X-Plure-Agent se inyectan en initialize, así que el asistente de IA las ve desde el primer mensaje.
• Las instrucciones elegidas a mitad de conversación con select_agent vuelven en el resultado de esa tool — un cliente solo las ve al llamarla — y están disponibles después desde el recurso MCP plure-bc://agent (Business Central) o plure-crm://agent (Dynamics 365 CRM).

La granularidad de Business Central es la sección

Un AI agent acota el acceso a Business Central al nivel de sección — las mismas 16 secciones (bc_wms_receipts, bc_sales, …) a las que se mapean las áreas de los roles MCP — no al nivel de un método individual dentro de una sección.

Subagentes y delegación

Un AI agent puede tener subagentes: AI agents más pequeños, cada uno centrado en un área, a los que un AI agent padre encarga trabajo. El asistente de IA habla con el padre; el padre delega cada petición en el subagente que la gestiona y resume la respuesta.

Un árbol de agentes

Un AI agent puede tener un padre, y el árbol puede llegar a 3 niveles por debajo de la raíz. Por ejemplo, un árbol de operaciones móviles para Business Central:

Mobile
├── Sales
├── Purchases
├── Payments
└── WMS
    ├── WMS Basic
    └── WMS Advanced

Los árboles existen dentro de un tenant. Los AI agents de plataforma de Plur-e no tienen subagentes, y las tools de delegación de más abajo no están disponibles en el endpoint de plataforma.

Un subagente solo puede acotar

Un subagente nunca obtiene más que su padre. Su acceso efectivo es el acceso del usuario intersectado con cada nivel de su cadena, tanto para roles como para skills y tools:

• Una lista vacía en un nivel significa que ese nivel hereda lo que permite el nivel superior.
• Desactivar un AI agent desactiva también a sus subagentes.
• Seleccionar un subagente directamente (pantalla de consentimiento, select_agent o X-Plure-Agent) y delegar en él desde su padre dan exactamente el mismo límite.
• Un cambio hecho en un ancestro puede tardar hasta 1 minuto en aplicarse a sus subagentes.

Crear el árbol

En el Admin Center, entra en AI & MCP → AI agents:

• Elige un Parent agent al crear un AI agent, o más tarde en su pestaña General. Déjalo vacío para un AI agent raíz.
• La pestaña Sub-agents de un AI agent lista sus hijos directos y permite añadir uno.
• En las pestañas Roles, Skills y Tools de un subagente, todo lo que su padre no permite aparece deshabilitado con Not allowed by parent.
• Un AI agent que tiene subagentes no se puede borrar hasta que sus subagentes se muevan o se borren.
• Al clonar un AI agent desde el área de plataforma puedes incluir sus subagentes.

Plur-e ofrece por sí misma la jerarquía Mobile anterior, como AI agents de sistema: ves los 7 en AI & MCP → AI agents y los personalizas sin copiarlos (consulta Agentes de sistema y personalización). Cada uno ya trae las secciones de Business Central que necesita:

Delegar desde tu cliente de IA

Con un AI agent seleccionado que tenga subagentes habilitados, plure_list_agents los muestra y el asistente de IA puede llamar a:

plure_delegate(agent, task, allowWrites?, waitSeconds?)

• El subagente trabaja en el servidor de Plur-e con el modelo de IA configurado para él. Ve solo el texto de la tarea, no la conversación, así que la tarea debe llevar todos los detalles que necesita. Responde con un informe.
• Solo puedes delegar en hijos directos del AI agent seleccionado que estén habilitados. El informe se trata como dato no confiable, nunca como instrucciones.
• plure_delegate espera hasta unos 150 segundos. Si el subagente no ha terminado, la respuesta incluye un runId: llama a plure_delegation_result(runId) para obtener el informe.
• Si el cliente se desconecta, el subagente sigue trabajando y puedes obtener el resultado más tarde con plure_delegation_result.
• allowWrites es false por defecto: el subagente puede leer pero no modificar datos. Ponlo en true solo en una sesión interactiva cuando la tarea deba escribir; el cliente MCP te pide confirmación.
• Cada usuario puede tener como máximo 3 delegaciones en curso a la vez.

En ejecuciones autónomas

Una ejecución autónoma también puede delegar en subagentes:

• Los subagentes de una ejecución autónoma nunca escriben, sea cual sea lo que la propia ejecución tenga permitido.
• Lo que gastan los subagentes cuenta contra el mismo presupuesto que la ejecución del AI agent raíz.
• Cancelar una ejecución cancela también las de sus subagentes.

Desactivación por Plur-e

Plur-e puede desactivar un AI agent para todos los usuarios de un tenant desde el servidor /super o el área de plataforma del Admin Center, sea cual sea la configuración del tenant. Un AI agent desactivado no se puede seleccionar en la pantalla de consentimiento, con select_agent ni con la cabecera X-Plure-Agent hasta que Plur-e lo reactive.

Para personalizar los AI agents de sistema de Plur-e sin copiarlos, observar tus AI agents en vivo, revisar sus ejecuciones, pausarlos y revisar versiones, consulta el Agent studio.

Relacionado: Roles MCP · Conecta tu cliente de IA · Flujos móviles de Business Central