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.
Importante
Los complementos MCP y API proporcionan acciones dentro de los agentes declarativos. No son paquetes de complementos instalables independientes: solo el agente contenedor puede acceder a sus funciones y herramientas. Para obtener información sobre la relación de paquete y manifiesto de acción, consulte Complementos y acciones de agente declarativo.
Recomendación
Recomendado: Comience con las herramientas de desarrollo de Work IQ para escenarios de complemento y agente declarativo de código profesional compatibles. Consulte el inicio rápido de WIQD. Las instrucciones basadas en el kit de herramientas siguen estando disponibles para los proyectos existentes y los flujos de trabajo que las requieren. Compruebe la compatibilidad con la capacidad y la experiencia de destino antes de elegir una herramienta: WIQD no se dirige a agentes de motor personalizados.
Los complementos de API permiten que un agente declarativo llame a una API REST. Use el kit de herramientas de agentes de Microsoft 365 para generar un proyecto de agente, un manifiesto de complemento de API y una implementación de API REST como punto de partida.
- Requisitos especificados en Requisitos para las opciones de extensibilidad de Copilot
- Visual Studio Code
- Kit de herramientas de agentes de Microsoft 365
-
Node.js 20.x o 22.x. Para confirmar la versión instalada, ejecute
node --version.
Crear el agente y la API
Nota
Las capturas de pantalla y las referencias a la interfaz de usuario de este artículo usan una versión de lanzamiento del Kit de herramientas de agentes de Microsoft 365. Las versiones preliminares pueden diferir de la interfaz de usuario mostrada.
Abra Visual Studio Code. Si el Kit de herramientas de agentes aún no está instalado, consulte Instalar Kit de herramientas de agentes para ver las instrucciones de instalación.
Seleccione el icono del Kit de herramientas de agentes de Microsoft 365 en la barra de actividades izquierda.
Seleccione Crear un nuevo agente o aplicación en el panel de tareas Kit de herramientas de agentes.
Seleccione Agente declarativo.
Seleccione Agregar una acción y, a continuación, seleccione Iniciar con una nueva API.
Seleccione OAuth para el tipo de autenticación.
Seleccione su lenguaje de programación preferido: JavaScript o TypeScript. En esta guía se asume TypeScript.
Elige una ubicación para el proyecto del agente.
Introducir
Repairs Agentcomo nombre del proyecto de agente.
Al completar estos pasos, Agents Toolkit genera los archivos del proyecto del agente y de la API, incluido el manifiesto del complemento de API, y abre el proyecto en una nueva ventana de Visual Studio Code. Para obtener más información, consulte el archivo README.md del directorio raíz del proyecto generado.
Ejecutar la API y transferir localmente el agente
En la ventana de Visual Studio Code con el proyecto del agente cargado, seleccione el icono del Kit de herramientas de agentes de Microsoft 365 en la barra de actividades de la izquierda.
En el panel Cuentas , seleccione Iniciar sesión en Microsoft 365. (Si ya has iniciado sesión, continúa con el paso siguiente).
Confirme que tanto la carga de aplicaciones personalizadas habilitada como el acceso de Copilot habilitado se muestran en su cuenta de Microsoft 365. Si no lo hacen, póngase en contacto con el administrador de la organización. Consulte Requisitos para las opciones de extensibilidad de Copilot para obtener más información.
Seleccione el icono Ejecutar y depurar en la barra de actividades de la izquierda.
Seleccione Depurar en Copilot (Edge) o Depurar en Copilot (Chrome) y, a continuación, presione F5 para iniciar la depuración.
Agents Toolkit compila el proyecto, crea un paquete de aplicación que contiene el agente y su configuración de complemento de API, y transfiere localmente el agente para su cuenta de usuario. También inicia la API localmente. Se abrirá una nueva ventana del explorador en la aplicación Microsoft Teams.
Probar la acción de API del agente
En Microsoft Teams en el explorador, seleccione Copilot.
Seleccione Repairs Agentlocal en la lista Agentes en el lado derecho. Si la lista no está disponible, seleccione el icono de chats de Copilot y más en la esquina superior derecha.
Enviar un mensaje a Copilot sobre las reparaciones. Por ejemplo, prueba
Which repairs are assigned to Karin?.
En este momento, la API de REST se ejecuta localmente en el equipo de desarrollo sin autenticación. Para agregar autenticación, implemente la API en Azure.
Implementar en Azure y habilitar la autenticación
Seleccione el icono del Kit de herramientas de agentes de Microsoft 365 en la barra de actividades izquierda.
En el panel Ciclo de vida , seleccione Aprovisionar.
Cuando se le pida un nombre de grupo de recursos, acepte el valor predeterminado o cámbielo según lo desee y presione Entrar.
Seleccione una ubicación para el grupo de recursos.
Revise el mensaje en el cuadro de diálogo. Si todo parece correcto, selecciona Aprovisionar para continuar.
Espere a que finalicen los pasos de aprovisionamiento y, a continuación, seleccione Implementar en el panel deciclo de vida .
Una vez completados estos pasos, implementará la API de REST como una función de Azure con autenticación. El agente llama a la API hospedada a través de la configuración de su complemento API.
Probar el agente con la API autenticada
En Microsoft Teams en el explorador, seleccione Copilot.
Seleccione Repairs Agentdev en la lista Agentes en el lado derecho.
Enviar un mensaje a Copilot sobre las reparaciones. Por ejemplo, prueba
Which repairs are assigned to Issac?.