Creación de proyectos de complementos de Office con microsoft 365 Agents Toolkit

Una herramienta principal para desarrollar aplicaciones y agentes de Microsoft 365, incluidos los complementos de Office, es Microsoft 365 Agents Toolkit.

Los complementos creados con Agents Toolkit usan el manifiesto unificado para Microsoft 365.

Instale la versión más reciente del kit de herramientas de agentes en Visual Studio Code como se describe en Instalación del kit de herramientas de agentes de Microsoft 365.

Crear un proyecto de complemento de Office

1. Abra Visual Studio Code y seleccione el icono Del kit de herramientas de agentes en la barra de actividad.

   

2. Seleccione Crear una nueva aplicación.

3. Se abre el menú desplegable Nuevo proyecto . Las opciones enumeradas variarán en función de la versión de Agents Toolkit. Seleccione Complemento de Office.

   

4. Se abre el menú desplegable Características de la aplicación con un complemento de Office . Las opciones enumeradas variarán en función de la versión de Agents Toolkit. Seleccione Panel de tareas.

   

5. En el cuadro de diálogo Carpeta del área de trabajo que se abre, seleccione la carpeta donde desea crear el proyecto.

6. Asigne un nombre al proyecto (sin espacios) cuando se le solicite. Agents Toolkit creará el proyecto con archivos básicos y scaffolding. A continuación, abrirá el proyecto en una segunda ventana Visual Studio Code. Cierre la ventana de Visual Studio Code original.

   Nota:

   El proyecto generado está configurado para que se pueda instalar en Excel, Outlook, PowerPoint y Word. Puede editar el manifiesto y los archivos de origen según sea necesario para cambiar qué aplicaciones de Office se admiten.

7. En el Visual Studio Code TERMINAL, vaya a la raíz del proyecto y ejecute npm install.

8. Una vez completada la instalación, compruebe que puede transferir localmente el complemento desde Visual Studio Code. Los pasos para transferir localmente varían en función de la aplicación de Office en la que quiera probar el complemento.

Transferencia local en Excel, PowerPoint o Word

1. Seleccione Ver | ejecución en Visual Studio Code. En el menú desplegable EJECUTAR Y DEPURAR , seleccione una de estas opciones:

   • Escritorio de Excel (Chromium perimetral)
   • PowerPoint Desktop (edge Chromium)
   • Word Desktop (Chromium Perimetral)

2. Pulse F5. El proyecto se compila y se abre una ventana de servidor de desarrollo de Node. Este proceso puede tardar un par de minutos. Finalmente, se abre la versión de escritorio de la aplicación de Office que seleccionó.

   Nota:

   Si es la primera vez que ha cargado de forma local un complemento de Office en el equipo (o la primera vez en más de un mes), es posible que se le pida que elimine un certificado antiguo o que instale uno nuevo. Acepte ambas indicaciones.

3. Aparecerá una pestaña Complemento de Contoso con dos botones en la cinta inicio . Use un botón para realizar una acción en el documento abierto de Office. Use el otro para abrir el panel de tareas del complemento.

   Nota:

   Independientemente del botón que seleccione, aparecerá una solicitud Detención al cargar de WebView . Seleccione Aceptar.

   Sugerencia

   La instalación local en Office en Windows también hace que el complemento esté disponible en Office en la Web, por lo que también puede probarlo en esa plataforma. Una vez completado este paso, minimice la ventana de la aplicación Office en Windows y, en un explorador, vaya a https://excel.cloud.microsoft/, https://word.cloud.microsoft/o https://powerpoint.cloud.microsoft/, lo que sea adecuado para el complemento que esté probando. Abra un documento nuevo o existente en la aplicación de Office en la web. Los botones deben aparecer en la cinta inicio igual que en Office en Windows.

4. Para detener la depuración y desinstalar el complemento, seleccione Ejecutar | detener depuración en Visual Studio Code.

   Nota:

   Si el paso anterior parece no tener ningún efecto, desinstale el complemento abriendo un TERMINAL en Visual Studio Code y, a continuación, ejecutando el comando npm run stop. El cierre de la ventana del servidor no detiene el servidor de forma confiable y el cierre de la aplicación de Office no hace que Office desconocierte el complemento de forma confiable.

Otras formas de transferir localmente

Consulte Transferir localmente complementos de Office que usan el manifiesto unificado para Microsoft 365 para ver formas alternativas de transferir localmente un complemento de Excel, PowerPoint o Word, incluido a través de la tienda de aplicaciones de Teams.

Transferencia local en Outlook

1. Asegúrese de que su cuenta en el inquilino para desarrolladores de Microsoft 365 también sea una cuenta de correo electrónico en Outlook de escritorio. Si no es así, siga las instrucciones de Agregar una cuenta de correo electrónico a Outlook.

2. Cierre el escritorio de Outlook.

3. En Visual Studio Code, abra Agents Toolkit.

4. En la sección CUENTAS , compruebe que ha iniciado sesión en Microsoft 365.

5. Seleccione Ver | ejecución en Visual Studio Code. En el menú desplegable EJECUTAR Y DEPURAR, seleccione la opción Outlook Desktop (Edge Chromium) y, a continuación, presione F5. El proyecto se compila y se abre una ventana de servidor de desarrollo de Node. Este proceso puede tardar un par de minutos y, a continuación, se abrirá el escritorio de Outlook.

   Nota:

   Si es la primera vez que ha cargado de forma local un complemento de Office en el equipo (o la primera vez en más de un mes), es posible que se le pida que elimine un certificado antiguo o que instale uno nuevo. Acepte ambas indicaciones.

6. Abra la Bandeja de entradade la identidad de la cuenta de Microsoft 365 y abra cualquier mensaje. Aparecerá una pestaña Complemento de Contoso con dos botones en la cinta Inicio (o en la cinta Mensaje , si ha abierto el mensaje en su propia ventana).

7. Haga clic en el botón Mostrar panel de tareas y se abrirá un panel de tareas. Haga clic en el botón Realizar una acción y aparecerá una pequeña notificación cerca de la parte superior del mensaje.

   Nota:

   Independientemente del botón que seleccione, aparecerá una solicitud Detención al cargar de WebView . Seleccione Aceptar.

8. Para detener la depuración y desinstalar el complemento, seleccione Ejecutar | detener depuración en Visual Studio Code.

   Nota:

   Si el paso anterior parece no tener ningún efecto, desinstale el complemento abriendo un TERMINAL en Visual Studio Code y, a continuación, ejecutando el comando npm run stop. El cierre de la ventana del servidor no detiene el servidor de forma confiable y el cierre de la aplicación de Office no hace que Office desconocierte el complemento de forma confiable.

Desarrollo del proyecto

Ahora puede cambiar y desarrollar el proyecto. En lugares donde la guía de la documentación de complementos de Office se bifurca en función del tipo de manifiesto que se use, asegúrese de seguir las instrucciones del manifiesto unificado.