Crear complementos de API con una nueva API para Microsoft 365 Copilot

Importante

Los complementos MCP y API se admiten como acciones dentro de los agentes declarativos. No están habilitadas como experiencias independientes en Microsoft 365 Copilot.

Los complementos de API conectan una API REST a Microsoft 365 Copilot. Puede usar el kit de herramientas de agentes de Microsoft 365 para generar rápidamente un complemento y una API REST correspondiente que puede usar como punto de partida para el desarrollo del complemento.

Crear el complemento 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.

  1. Abrir 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.

  2. Seleccione el icono del Kit de herramientas de agentes de Microsoft 365 en la barra de actividades izquierda.

  3. Seleccione Crear un nuevo agente o aplicación en el panel de tareas Kit de herramientas de agentes.

    Captura de pantalla de la interfaz del kit de herramientas de agentes

  4. Seleccione Agente declarativo.

  5. Seleccione Agregar una acción y, a continuación, seleccione Iniciar con una nueva API.

  6. Seleccione OAuth para el tipo de autenticación.

  7. Seleccione su lenguaje de programación preferido: JavaScript o TypeScript. En esta guía se asume TypeScript.

  8. Elige una ubicación para el proyecto del complemento de API.

  9. Introdúcelo Repairs Agent como nombre para el proyecto de complemento.

Una vez completados estos pasos, Agents Toolkit genera los archivos necesarios para el complemento y abre una nueva ventana de Visual Studio Code con el proyecto de complemento cargado. Para obtener más información sobre el proyecto, consulte el archivo README.md del directorio raíz del proyecto generado.

Ejecutar el complemento

  1. En la ventana de Visual Studio Code con el proyecto del complemento cargado, seleccione el icono del Kit de herramientas de agentes de Microsoft 365 en la barra de actividades de la izquierda.

  2. En el panel Cuentas , seleccione Iniciar sesión en Microsoft 365. (Si ya has iniciado sesión, continúa con el paso siguiente).

  3. 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.

  4. Seleccione el icono Ejecutar y depurar en la barra de actividades de la izquierda.

  5. 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 el paquete de complementos y lo transfiere localmente para su cuenta de usuario. Una vez hecho esto, se abrirá una nueva ventana del explorador en la aplicación Microsoft Teams.

Probar el complemento

  1. En Microsoft Teams en el explorador, seleccione Copilot.

  2. 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.

  3. Enviar un mensaje a Copilot sobre las reparaciones. Por ejemplo, prueba Which repairs are assigned to Karin?.

En este momento, el complemento se ejecuta localmente en el equipo de desarrollo sin autenticación. Para agregar autenticación, implemente la solución en Azure.

Implementar en Azure y habilitar la autenticación

  1. Seleccione el icono del Kit de herramientas de agentes de Microsoft 365 en la barra de actividades izquierda.

  2. En el panel Ciclo de vida , seleccione Aprovisionar.

  3. Cuando se le pida un nombre de grupo de recursos, acepte el valor predeterminado o cámbielo según lo desee y presione Entrar.

  4. Seleccione una ubicación para el grupo de recursos.

  5. Revise el mensaje en el cuadro de diálogo. Si todo parece correcto, selecciona Aprovisionar para continuar.

  6. 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, el complemento se implementa como una función de Azure con autenticación.

Probar el complemento con la autenticación

  1. En Microsoft Teams en el explorador, seleccione Copilot.

  2. Seleccione Repairs Agentdev en la lista Agentes en el lado derecho.

  3. Enviar un mensaje a Copilot sobre las reparaciones. Por ejemplo, prueba Which repairs are assigned to Issac?.

  • Se actualizó por última vez el