Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
El orquestador de Microsoft 365 Copilot coordina el modelo de lenguaje, el contexto disponible y las funcionalidades que usa para responder a una solicitud del usuario. Para los agentes declarativos, esas capacidades pueden incluir la recuperación de conocimientos, capacidades integradas y acciones proporcionadas por complementos MCP o API.
Este artículo se centra en cómo la configuración de tu agente influye en la selección e invocación de acciones. Usted proporciona instrucciones, definiciones de herramientas y servicios externos; Microsoft administra el entorno de ejecución conversacional. Para obtener una división más amplia de responsabilidades, consulte Arquitectura de agente declarativo.
Orquestador de Copilot
El orquestador usa la configuración del agente y el contexto disponible para determinar si se debe responder directamente, recuperar conocimiento o invocar una herramienta. No todas las solicitudes requieren una acción externa.
Por ejemplo, un usuario podría preguntar: "¿Qué tickets tengo asignados en este momento?". Un agente con una acción de tickets adecuada puede recuperar información actual del servicio de tickets en lugar de confiar en el conocimiento del modelo.
El siguiente diagrama ilustra una interacción API-acción. Es una vista conceptual, no una secuencia de ejecución fija o una garantía de que cada solicitud usa Microsoft Graph o una API externa.
- Interpretar la solicitud. Copilot usa la indicación, las instrucciones del agente, el historial de conversaciones y el contexto de la aplicación disponible para identificar la tarea del usuario. Las comprobaciones de directiva y seguridad de la plataforma pueden afectar a si la solicitud procede y cómo procede.
- Seleccionar funcionalidades relevantes. Copilot determina si los conocimientos o herramientas configurados pueden ayudar. Para una acción externa, las descripciones de complementos y herramientas ayudan a identificar una operación adecuada.
- Determine las entradas e invoque la herramienta. Copilot asigna la información disponible a los parámetros de la herramienta. Las instrucciones deben guiarlo para que solicite la información requerida faltante en lugar de inventar valores. Las llamadas externas usan el comportamiento de autenticación y confirmación configurado.
- Interpretar el resultado. Copilot usa los datos devueltos o el error para determinar el siguiente paso. La interacción puede incluir otra llamada, una solicitud de aclaración o una respuesta al usuario.
- Responder al usuario. Copilot genera una respuesta utilizando el contexto y los resultados disponibles. La respuesta debe reflejar lo que el servicio devolvió o cambió realmente.
Los agentes declarativos admiten el encadenamiento de llamadas de función, incluido el paso de la salida de una llamada de API a otra y la combinación de acciones de API con conocimiento de SharePoint o intérprete de código. Diseñe y pruebe las interacciones requeridas en lugar de asumir un número fijo de llamadas siempre completadas en un turno. Sigue las limitaciones actuales de los complementos y los límites de los servicios externos.
Las protecciones de la plataforma y las confirmaciones de usuario no sustituyen a las comprobaciones de autorizaciones o reglas de negocio en el servicio externo. Si el flujo de trabajo requiere un orden de ejecución, transacciones o recuperación exactos, implemente esos requisitos en el servicio en lugar de confiar en las instrucciones del modelo.
Cómo el orquestador de Copilot hace coincidir las acciones con las consultas de los usuarios
La selección de complementos y la invocación de herramientas individuales son decisiones diferentes. La descripción de un complemento ayuda a Copilot a identificar el servicio o dominio relevante. Las herramientas disponibles en ese complemento describen las operaciones que Copilot puede invocar y las entradas que requieren.
Cuando la selección de complementos utiliza la coincidencia semántica, la coincidencia se basa en la descripción del complemento, no en las descripciones de las funciones individuales. Un complemento emparejado pone a disposición sus funciones o herramientas; No es una lista fija de cinco funciones. Para conocer el comportamiento de selección actual y las restricciones de contexto, consulte Limitaciones del complemento MCP y API.
Proporcione descripciones útiles en cada nivel:
| Configuración | Qué describir |
|---|---|
| Descripción del complemento | El propósito del servicio, las tareas de usuario admitidas y el dominio. Haz que la descripción sea lo suficientemente específica como para distinguirla de otros plugins. |
| Definición de función o herramienta | El propósito de la operación, cuándo usarla y si recupera o cambia los datos. Para complementos de API, asigne el nombre de la función a OpenAPI operationId. |
| Parámetros | Entradas, tipos, formatos y ejemplos significativos necesarios. Distingue identificadores de nombres para mostrar y deja claro el comportamiento opcional. |
| Resultados y errores | Los datos devueltos, lo que significa una operación correcta y cómo se representan los errores. Mantener las cargas útiles relevantes para la tarea. |
Para complementos de API, siga Crear descripciones de OpenAPI efectivas. En el caso de los complementos de MCP, compruebe si las definiciones de herramientas se detectan dinámicamente o se anclan en el manifiesto del complemento. Con la detección dinámica, los cambios en las definiciones de herramientas del servidor pueden afectar a la selección sin volver a publicar el agente.
Mejorar y evaluar la selección de acciones
Las descripciones y las instrucciones influyen en la selección. No garantizan que se invoque una herramienta determinada para cada redacción de una solicitud.
- Clarificar las operaciones superpuestas. Si varias herramientas parecen adecuadas, explique sus diferentes propósitos y las entradas requeridas. Distinga entre las operaciones de lectura y las operaciones que cambian los datos.
- Conecte las tareas a las herramientas en las instrucciones. Explicar cuándo usar las herramientas configuradas, cómo recopilar la información que falta y cómo usar los resultados anteriores en las solicitudes de seguimiento. Consulte Instrucciones para agentes con complementos de API.
- Mantén las herramientas disponibles enfocadas. Exponga las operaciones necesarias para las tareas del agente. Más definiciones de herramientas y cargas útiles más grandes consumen contexto y pueden reducir la calidad de la respuesta.
- Pruebe las selecciones y los resultados reales. Incluya indicaciones parafraseadas, solicitudes ambiguas, entradas que faltan, tareas de varios pasos, confirmaciones canceladas y errores de servicio. Verifique las operaciones y parámetros que recibió el servicio, no solo la redacción final.
- Repita las pruebas cuando cambien las definiciones. Vuelva a ejecutar casos representativos después de cambios en las descripciones de los complementos, las definiciones de las herramientas, las instrucciones o la plataforma. Incluya actualizaciones del servidor MCP al usar la detección dinámica.
Importante
Una respuesta conversacional faltante o incompleta no establece si se completó una operación externa. Compruebe el resultado del servicio antes de volver a intentar una operación que cambie los datos y diseñe el servicio para controlar las solicitudes repetidas de forma segura.
Para obtener recomendaciones de diseño más amplias, consulte Prácticas recomendadas para agentes declarativos. Para casos de prueba y afirmaciones repetibles, consulte Descripción general de la evaluación del agente.