Los agentes son aplicaciones para Microsoft 365
Al compilar un agente, también está creando una aplicación para Microsoft 365. Las aplicaciones para Microsoft 365 comparten un esquema de manifiesto común y un formato de empaquetado, así como procesos y herramientas de administración y distribución unificados. El resultado final es que las aplicaciones y los agentes llegan a la audiencia más amplia posible y aparecen contextualmente dentro del flujo de trabajo de los usuarios.
En este artículo se describen las partes clave del modelo de aplicaciones de Microsoft 365 que se aplican al desarrollo de agentes.
Importante
- Actualmente, los complementos de API solo se admiten como acciones dentro de agentes declarativos. No se habilitan en Microsoft 365 Copilot. Para obtener un ejemplo que muestra cómo agregar un complemento de API a un agente declarativo, consulte Agregar un complemento.
- La funcionalidad está habilitada de forma predeterminada en todos los inquilinos con licencia de Microsoft 365 Copilot. Los administradores pueden deshabilitar esta funcionalidad en función del usuario y del grupo y controlar cómo se aprueban los complementos individuales para su uso y qué complementos están habilitados. Para obtener más información, consulte Administración de agentes en aplicaciones integradas.
Paquete de la aplicación
El paquete de la aplicación para Microsoft 365, incluidos los agentes, es un archivo ZIP que contiene uno o varios archivos de configuración (manifiesto) y los iconos de la aplicación. La lógica de la aplicación y el almacenamiento de datos se hospedan en otro lugar y la aplicación host de Microsoft 365 tiene acceso a ella a través de HTTPS. Enviará el paquete de la aplicación al administrador para publicarlo en su organización o en el Centro de partners para publicarlo en Microsoft AppSource.
Como mínimo, un paquete de aplicación contiene:
- Manifiesto de aplicación (
manifest.json), que describe la configuración de la aplicación, las funcionalidades, los recursos necesarios y los atributos importantes. - Un icono de color grande (
color.png), un icono de color completo de 92x92 para mostrar el agente en la interfaz de usuario y el almacén de Microsoft Copilot - Un pequeño icono de esquema (
outline.png), un icono de 32 x 32 con fondo transparente (no se usa actualmente en Copilot, pero es necesario para pasar la validación)
El paquete de la aplicación también puede contener definiciones de complementos de API y agente declarativo, así como archivos de localización para otros idiomas admitidos.
Iconos de la aplicación
El paquete de la aplicación debe incluir una versión de color y esquema del icono de la aplicación, como archivos .png. Estos iconos tienen requisitos de tamaño específicos para pasar la validación del almacén.
Nota:
Actualmente solo se usa el icono de color para representar agentes a los usuarios (tanto como su descripción de la tienda como dentro de la interfaz de usuario de Microsoft 365 Copilot), pero sigue siendo necesario un icono de esquema al enviar el paquete de aplicación a Microsoft AppSource.
Para obtener instrucciones de diseño para los iconos de color y esquema para el paquete de aplicaciones de Microsoft 365, consulta Iconos de aplicación para la Tienda Teams y la barra de aplicaciones.
Icono de color
El icono de color representa el agente en la interfaz de usuario de Microsoft Copilot y en los almacenes de aplicaciones del producto (Teams, Outlook, Microsoft 365).
Icono de color:
- Puede ser cualquier color
- Debe tener un tamaño de 192 x 192 píxeles.
- Debe contener un símbolo de 96 x 96 píxeles (para permitir 48 píxeles de relleno para escenarios de host donde se recorta)
- Debe sentarse sobre un fondo cuadrado totalmente sólido o totalmente transparente
Icono de esquema
El icono de esquema se usa para representar aplicaciones ancladas o activas en la barra de aplicaciones de Teams. Actualmente no se usa para los agentes, pero sigue siendo necesario para que el paquete de la aplicación pase la validación.
Icono de esquema:
- Debe tener 32 x 32 píxeles
- Debe ser blanco con un fondo transparente o transparente con un fondo blanco.
- No debe contener relleno adicional alrededor del símbolo
Manifiesto de la aplicación
El manifiesto de aplicación para Microsoft 365 es un archivo JSON que describe la funcionalidad y las características de la aplicación. En esencia, el manifiesto de aplicación para Microsoft 365 es el esquema para compilar aplicaciones de Teams; sin embargo, a partir de la versión 1.13, admite aplicaciones que se ejecutan en hosts de Microsoft 365, además de Teams.
Si usa Copilot Studio para crear un agente declarativo, el manifiesto de aplicación se genera automáticamente en función de la información que proporcione durante el proceso de creación.
Cada manifiesto de aplicación debe incluir los campos siguientes.
| Campo Manifiesto | Descripción |
|---|---|
| version | Número de versión de la aplicación, con el formato MAJOR. MENOR. PATCH (estándar de semver ). |
| id | Identificador único generado para esta aplicación desde el Portal de registro de aplicaciones de Microsoft (apps.dev.microsoft.com), en formato GUID. |
| desarrollador | Información sobre el desarrollador, incluido el nombre, el sitio web y los vínculos a la directiva de privacidad y los términos de uso. Para las aplicaciones enviadas a AppSource, los valores deben coincidir con el valor proporcionado en el formulario de envío de aplicaciones del Centro de partners. |
| name | Nombre de la aplicación, tal como se muestra a los usuarios finales en el host de la aplicación. |
| description | Descripciones cortas y largas de la aplicación para los usuarios. Para las aplicaciones enviadas a AppSource, estos valores deben coincidir con la información de la entrada de AppSource. |
| Iconos | Rutas de acceso relativas a los archivos de icono de color y esquema. |
| accentColor | Color que se va a usar con y como fondo para los iconos de esquema, en el valor hexadecimal RGB, por ejemplo #4464ee. |
| Definiciones de funcionalidades de aplicación específicas | Definición de cada funcionalidad de aplicación, como pestañas personales (staticTabs), extensiones de mensaje (composeExtensions) o bots. Los agentes declarativos y los complementos de API se definen en el nodo copilotAgents . |
En el ejemplo siguiente se muestra un manifiesto de aplicación con secciones de marcador de posición al final para las funcionalidades de extensión de mensaje y aplicación de agente declarativo.
{
"$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.18/MicrosoftTeams.schema.json",
"manifestVersion": "1.18",
"version": "1.0.0",
"id": "00000000-0000-0000-0000-000000000000",
"developer": {
"name": "Northwind Traders",
"websiteUrl": "https://www.example.com",
"privacyUrl": "https://www.example.com/termofuse",
"termsOfUseUrl": "https://www.example.com/privacy"
},
"icons": {
"color": "Northwind-Logo-196.png",
"outline": "Northwind-Logo-32.png"
},
"name": {
"short": "Northwind Inventory",
"full": "Northwind Inventory App"
},
"description": {
"short": "App allows you to find and update product inventory information",
"full": "Northwind Inventory is the ultimate tool for managing your product inventory. With its intuitive interface and powerful features, you'll be able to easily find your products by name, category, inventory status, and supplier city. You can also update inventory information with the app."
},
"accentColor": "#3690E9",
"composeExtensions": {
...
},
"copilotAgents": {
...
}
}
Para más información, consulte Manifiesto de aplicación.
copilotAgents Definiciones
Los agentes declarativos y los complementos de API tienen sus propios esquemas de definición. Se hace referencia al archivo de definición de un agente declarativo desde el copilotAgents objeto del manifiesto de aplicación.
En el ejemplo siguiente se muestra cómo hacer referencia a un agente declarativo:
"copilotAgents": {
"declarativeAgents": [
{
"id": "agent1",
"file": "declarativeAgent1.json"
}
]
},
Se hace referencia a la definición de un complemento de API (en actions) desde la definición del agente declarativo.
Tenga en cuenta lo siguiente:
Actualmente solo se admite una definición de agente declarativo por manifiesto de aplicación.
Cuando se usa Copilot Studio para compilar agentes, se genera un único
idpara cada uno, como parte de la generación general del manifiesto de la aplicación. Al crear agentes con Teams Toolkit o su propio IDE, se asigna ustedidmismo, según sus propias convenciones o nombre descriptivo.
Manifiesto del agente declarativo
El manifiesto del agente declarativo incluye instrucciones para las respuestas de Copilot, mensajes de ejemplo de inicio de conversación, orígenes de datos usados para la puesta en tierra y una lista de acciones (aptitudes del complemento de API) que el agente puede realizar.
Para más información, consulte Esquema de manifiesto del agente declarativo para Microsoft 365 Copilot.
Manifiesto del complemento de API
El manifiesto del complemento de API describe las funcionalidades del complemento, incluidas las API que admite y las operaciones que puede realizar. También incluye metadatos como nombre, descripción, versión y una referencia a la definición de OpenAPI de las API REST con las que interactúa. Se puede hacer referencia a los complementos de API desde un manifiesto de agente declarativo que se usará en la experiencia del agente declarativo.
Para más información, consulte Esquema de manifiesto del complemento de API para Microsoft 365 Copilot.