Creación de un agente declarativo

Completado

Un agente declarativo se implementa en una aplicación de Microsoft 365.

Se crea un paquete de aplicación que contiene:

• app.manifest.json: el archivo de manifiesto de la aplicación describe cómo se configura la aplicación, incluidas sus funcionalidades.
• declarative-agent.json: el manifiesto del agente declarativo describe cómo se configura el agente declarativo.
• color.png y outline.png: un icono de color y esquema que se usa para representar el agente declarativo en la interfaz de usuario Microsoft 365 Copilot.

Manifiesto de la aplicación

El manifiesto de la aplicación describe cómo se integra la aplicación con Microsoft 365.

El siguiente fragmento de código muestra cómo configurar la aplicación con un agente declarativo e indicar a Microsoft 365 dónde encontrar su configuración:

"copilotAgents": {
  "declarativeAgents": [            
    {
      "id": "declarativeAgent",
      "file": "declarativeAgent.json"
    }
  ]
},

Manifiesto del agente declarativo

El manifiesto del agente declarativo describe cómo se configura el agente. En el manifiesto, se definen las instrucciones personalizadas, los orígenes de datos que se usan como datos de puesta a tierra, inicios de conversación y acciones personalizadas.

El siguiente fragmento de código muestra un ejemplo de un agente declarativo con instrucciones personalizadas:

{
  "$schema": "https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.3/schema.json",
  "version": "v1.3",
  "name": "da-product-support",
  "description": "Declarative agent created with Microsoft 365 Agents Toolkit",
  "instructions": "You are a declarative agent and were created with Team Toolkit. You should start every response and answer to the user with \"Thanks for using Microsoft 365 Agents Toolkit to create your declarative agent!\\n\\n\" and then answer the questions and help the user."
}

Kit de herramientas de agentes de Microsoft 365

Microsoft 365 Agents Toolkit es una extensión para Visual Studio Code que ayuda a los desarrolladores a crear agentes declarativos para Microsoft 365 Copilot.

Use plantillas predefinidas para aplicar scaffolding a proyectos de agente declarativo con compatibilidad con flujos de trabajo y variables de entorno para cargar el agente declarativo en Microsoft 365, lo que le ahorra tiempo.

Un proyecto de agente declarativo contiene los siguientes archivos y carpetas importantes:

• teamsapp.yml: este archivo contiene un flujo de trabajo usado por Microsoft 365 Agents Toolkit para compilar el paquete de aplicación y cargarlo en el inquilino de Microsoft 365.
• appPackage: esta carpeta contiene archivos de origen incluidos en el paquete de la aplicación, incluidos el manifiesto de la aplicación y el manifiesto del agente declarativo.
• env: esta carpeta contiene archivos de entorno que microsoft 365 Agents Toolkit usa para contener los valores usados en los flujos de trabajo.