Arquitectura de agente declarativo

Los agentes declarativos se ejecutan en la infraestructura de orquestación administrada y modelo de lenguaje de Microsoft 365 Copilot. Configure las instrucciones del agente, las fuentes de conocimiento y las funcionalidades compatibles en lugar de implementar y hospedar su propio tiempo de ejecución conversacional.

Un agente puede usar los orígenes de conocimiento de Microsoft 365, funcionalidades integradas como intérprete de código, aptitudes personalizadas (versión preliminar) y acciones proporcionadas por los servidores MCP o las API de REST. También puede delegar tareas a agentes conectados. La disponibilidad depende de la herramienta de creación, la versión del manifiesto, la experiencia de destino, las licencias y las directivas organizativas.

Utilice este artículo para comprender el límite entre la plataforma administrada y los componentes que configura o opera. Para obtener una comparación con una arquitectura que le proporciona control sobre la orquestación y el hospedaje de modelos, consulte Comparación entre agentes de motor declarativos y personalizados.

Componentes de arquitectura

Microsoft 365 Copilot proporciona el tiempo de ejecución que interpreta las solicitudes de usuario, recupera el contexto relevante, selecciona funcionalidades y genera respuestas. Su configuración y los servicios externos determinan qué puede usar el agente para completar una tarea.

Diagrama de la arquitectura de un agente declarativo.

Componente Plataforma administrada Responsabilidades del desarrollador
Cliente Hospeda conversaciones en experiencias compatibles de Microsoft 365. Elija las experiencias de destino y pruebe sus interacciones admitidas, el contexto del documento y los formatos de respuesta.
Infraestructura Hospeda la orquestación de Copilot y el tiempo de ejecución del modelo. Configure el agente y aloje las API externas, los servidores MCP u otros servicios que use.
Catálogo y distribución Proporciona experiencias de adquisición, publicación y administración compatibles. Seleccione el paquete y la ruta de distribución admitidos, mantenga las versiones y trabaje con los administradores en el acceso y la implementación.
Seguridad y cumplimiento Aplica las protecciones de identidad, acceso a datos y plataforma de Microsoft 365. Configure los permisos y la autenticación, evalúe los flujos de datos y aplique la autorización y la protección de datos en los servicios externos.
Orquestador y modelo de lenguaje Selecciona e invoca funcionalidades y genera respuestas. Escriba instrucciones y descripciones de herramientas, configure los ajustes de comportamiento admitidos y evalúe el comportamiento resultante. No debe reemplazar el orquestador administrado por código de tiempo de ejecución personalizado.
Conocimientos y capacidades Recupera el conocimiento admitido y ejecuta funcionalidades integradas habilitadas. Seleccione los orígenes y funcionalidades relevantes, confirme el acceso del usuario y pruebe la calidad de la recuperación.
Llamada a herramientas Invoca acciones de MCP o API configuradas a través de la integración admitida. Defina las entradas y salidas de la herramienta, configure la autenticación y las confirmaciones e implemente un comportamiento de servicio confiable.

Los ajustes de configuración admitidos influyen en el tiempo de ejecución administrado; no le dan un control total sobre su implementación. Por ejemplo, el manifiesto admite un modo de respuesta predeterminado, que los usuarios pueden invalidar. Siga el esquema de manifiesto seleccionado y la herramienta de creación para ver la configuración disponible.

Nota

El contenido recuperado y las respuestas de herramientas pueden contener instrucciones que no son de confianza. Las protecciones de la plataforma no reemplazan las comprobaciones de autorización en los servicios ni la evaluación del comportamiento del agente. Planifique los requisitos aplicables de datos, privacidad y seguridad.

Flujo de datos del agente declarativo

El siguiente flujo conceptual describe cómo un agente usa su configuración y sus capacidades. No es una secuencia de ejecución fija ni una garantía de cuántas recuperaciones o llamadas a herramientas se producen.

  1. Recibir una solicitud. El usuario envía una indicación en una experiencia compatible. El historial de conversaciones y el contexto de la aplicación disponible pueden contribuir a la solicitud.
  2. Seleccione el contexto y las funcionalidades relevantes. Copilot usa las instrucciones del agente, la configuración de conocimientos y las descripciones de herramientas para determinar cómo atender la solicitud.
  3. Recuperar información o invocar acciones. Copilot recupera el conocimiento disponible o llama a una funcionalidad habilitada. Las acciones externas usan el comportamiento de autenticación y confirmación configurado. Los servicios externos aplican su propia autorización y reglas de negocio.
  4. Generar una respuesta. Copilot usa el contexto disponible y los resultados de la capacidad para responder. Dependiendo de la tarea, la interacción puede incluir más llamadas, solicitudes de entrada de usuario o delegación a un agente conectado.

Los agentes declarativos pueden encadenar llamadas API, usar la salida de una llamada como entrada de otra llamada y combinar el conocimiento de SharePoint o el intérprete de código con acciones API. Para obtener patrones y ejemplos admitidos, consulte Encadenamiento de llamadas a funciones en complementos de API.

Las instrucciones guían el comportamiento del modelo; No son un sustituto de la lógica de la aplicación que necesita aplicar una transacción, un orden de ejecución exacto o un procedimiento de recuperación. Implemente esos requisitos en una API o un servicio de flujo de trabajo, o evalúe una arquitectura de motor personalizada cuando necesite poseer la orquestación.

Diseño para límites específicos de la capacidad

Compruebe los límites de las instrucciones para cada funcionalidad e integración. El límite de caracteres de un campo de manifiesto, un límite de configuración de origen de conocimiento y un límite de contexto de tiempo de ejecución describen diferentes restricciones.

Área Consideración sobre el diseño Pauta
Configuración del agente Use las propiedades y funcionalidades compatibles con la versión del esquema y la herramienta de creación seleccionadas. Referencia de manifiesto de agente declarativo
Recuperación de conocimiento Seleccione los orígenes relevantes y siga los requisitos específicos del archivo, ámbito, acceso e indexación de la fuente. Una respuesta no incluye necesariamente todos los elementos de un origen. Orígenes de conocimiento y optimización de la recuperación de contenido
Definiciones y cargas útiles de herramientas Mantenga las herramientas enfocadas y las entradas y salidas relevantes. Las entradas y salidas de complementos grandes se pueden truncar, y los límites de contexto efectivos pueden cambiar con los modelos y la sobrecarga del sistema. Limitaciones de los complementos de MCP y API
Contexto del documento Sigue las interacciones de documentos y los formatos de contenido admitidos de la aplicación host en lugar de asumir que todo el contenido del documento se representa de forma idéntica. Interactuar con documentos
Latencia y comportamiento del servicio Pruebe los tiempos de respuesta, los errores de autenticación, los errores de servicio y los límites de sus servidores MCP o API externos. Integrar y probar componentes

Para conjuntos de datos grandes, diseñe API para filtrar, agregar o devolver el subconjunto relevante en lugar de enviar todos los registros a una conversación. Cuando un escenario necesita contenido de documento, pruebe la experiencia de host admitida: los agentes declarativos pueden acceder a todo el documento abierto en Word y PowerPoint, sujeto a consideraciones de formato de documento.

Ventajas y limitaciones

Las ventajas clave y las limitaciones principales de los agentes declarativos ayudan a determinar cuándo esta arquitectura es adecuada para casos de uso específicos.

Ventajas clave

Los agentes declarativos proporcionan ventajas significativas para las organizaciones que desean implementar soluciones de IA en entornos de Microsoft 365 existentes:

  • Entorno de ejecución conversacional administrado: Microsoft hospeda el orquestador y modela la infraestructura, por lo que no es necesario implementar ese tiempo de ejecución.
  • Acceso a capacidades de Microsoft: los agentes pueden usar fuentes de conocimiento compatibles y funcionalidades integradas junto con herramientas externas.
  • Personalización basada en la configuración: las instrucciones, las funcionalidades y las acciones adaptan la experiencia sin necesidad de un motor conversacional personalizado. Las integraciones externas pueden seguir requiriendo código y alojamiento.

Limitaciones principales

El enfoque declarativo también introduce restricciones que pueden limitar ciertos casos de uso:

  • Orquestación administrada: se influye en el comportamiento a través de la configuración compatible en lugar de controlar cada decisión en tiempo de ejecución. Evalúe tareas representativas en lugar de tratar las instrucciones como un motor de flujo de trabajo determinista.
  • Dependencias de plataforma y host: las funcionalidades, la presentación de respuestas, las licencias y la administración dependen de la experiencia de Microsoft 365 seleccionada. Confirme la compatibilidad en cada host de destino.
  • Limitaciones de contexto y recuperación: La recuperación del conocimiento y los resultados de la herramienta deben ajustarse al contexto disponible. Las fuentes o cargas útiles grandes no garantizan una cobertura completa en una respuesta.
  • Consideraciones sobre el contenido web dinámico: la búsqueda web limitada usa contenido indexado por Bing en lugar de consultar directamente el origen de datos subyacente. El contenido generado dinámicamente puede estar incompleto o obsoleto. Use una integración de API compatible cuando la tarea requiera acceso directo a datos estructurados actuales. Consulta Fundamentación de búsqueda web y contenido dinámico.
  • Evaluación continua: las actualizaciones de la plataforma y el modelo pueden cambiar el comportamiento. Pruebe las instrucciones, la recuperación y el uso de herramientas a medida que evolucionan el agente y sus dependencias.

Alineación de casos de uso

Elija la arquitectura en función del control que requiera la solución, no simplemente de si la tarea tiene varios pasos.

Escenarios óptimos

Los agentes declarativos son óptimos para:

  • Recuperación de información: agentes que principalmente necesitan buscar y resumir información de Microsoft 365 o fuentes externas.
  • Acciones asistidas: agentes que combinan conocimientos y acciones API o MCP compatibles para ayudar a los usuarios a completar una tarea.
  • Asistencia y análisis de documentos: agentes que trabajan con contexto de documento compatible o usan funcionalidades como el intérprete de código.
  • Mejora de la productividad: tareas que se benefician de una experiencia conversacional administrada en Microsoft 365.

Escenarios no adecuados

Considere la posibilidad de usar un agente de motor personalizado o un flujo de trabajo implementado por separado cuando sus requisitos incluyan los siguientes:

  • Control de tiempo de ejecución personalizado: debe implementar su propia orquestación, hospedaje de modelos o interfaz de usuario en lugar de usar el tiempo de ejecución de Copilot administrado.
  • Procesos empresariales duraderos: el sistema debe aplicar el orden exacto de ejecución, los límites de transacción, los reintentos, o la recuperación independientemente de una conversación.
  • Procesamiento de datos a gran escala: la tarea requiere el procesamiento exhaustivo de un conjunto de datos en lugar de la recuperación o el análisis del contexto conversacional relevante. Realice ese procesamiento en un servicio y exponga el resultado adecuado al agente.
  • Acceso directo a orígenes dinámicos: la tarea requiere resultados actuales y ordenados de un origen que no está representado adecuadamente en la búsqueda web. Proporcione una API compatible o integración de MCP en lugar de depender solo de la búsqueda web enfocada.

Estos requisitos no siempre excluyen a un agente declarativo como interfaz conversacional. Un servicio puede ser dueño del proceso de negocio mientras el agente recopila entradas, invoca una acción compatible y presenta el resultado.