Criar projetos de Suplemento do Office com o Microsoft 365 Agents Toolkit

Uma ferramenta principal para o desenvolvimento de aplicativos e agentes do Microsoft 365, incluindo suplementos do Office, é o Kit de ferramentas de agentes do Microsoft 365.

Os complementos criados com o Kit de Ferramentas de Agentes usam o manifesto unificado para Microsoft 365.

Instale a versão mais recente do Kit de Ferramentas de Agentes no Visual Studio Code, conforme descrito em Instalar o Kit de Ferramentas de Agentes do Microsoft 365.

Criar um projeto de Suplemento do Office

1. Abra o Visual Studio Code e selecione o ícone do Kit de Ferramentas de Agentes na Barra de Atividades.

   

2. Selecione Criar um novo aplicativo.

3. O menu suspenso Novo Projeto é aberto. As opções listadas variam de acordo com a sua versão do Kit de ferramentas do agentes. Selecione Suplemento do Office.

   

4. O menu suspenso Recursos do aplicativo Usando um Suplemento do Office é aberto. As opções listadas variam de acordo com a sua versão do Kit de ferramentas do agentes. Selecione Painel de tarefas.

   

5. Na caixa de diálogo Pasta do Espaço de Trabalho que é aberta, selecione a pasta onde deseja criar o projeto.

6. Dê um nome ao projeto (sem espaços) quando solicitado. O Agents Toolkit criará o projeto com arquivos básicos e scaffolding. Em seguida, ele abrirá o projeto em uma segunda janela do Visual Studio Code. Feche a janela original do Visual Studio Code.

   Observação

   O projeto gerado está configurado para ser instalado no Excel, no Outlook, no PowerPoint e no Word. Você pode editar os arquivos de manifesto e de origem conforme necessário para alterar quais aplicativos do Office têm suporte.

7. No TERMINAL do Visual Studio Code, navegue até a raiz do projeto e execute npm install.

8. Após a conclusão da instalação, verifique se você pode fazer sideload do suplemento a partir do Visual Studio Code. As etapas de sideload variam dependendo do aplicativo do Office no qual você deseja testar o suplemento.

Sideload no Excel, PowerPoint ou Word

1. Selecione Exibir | Executar no Visual Studio Code. No menu suspenso EXECUTAR E DEPURAR , selecione uma destas opções:

   • Excel Desktop (Edge Chromium)
   • Área de trabalho do PowerPoint (Edge Chromium)
   • Área de trabalho do Word (Edge, Chromium)

2. Pressione F5. O projeto é compilado e uma janela do servidor de desenvolvimento do nó é aberta. Esse processo pode demorar alguns minutos. Finalmente, a versão da área de trabalho do aplicativo do Office selecionado é aberta.

   Observação

   Se esta for a primeira vez que você faz sideload de um Suplemento do Office em seu computador (ou a primeira vez em mais de um mês), você pode ser solicitado a excluir um certificado antigo e/ou instalar um novo. Concorde com os dois prompts.

3. Uma guia do Suplemento da Contoso com dois botões aparecerá na faixa de opções Página Inicial . Use um botão para executar uma ação no documento aberto do Office. Use o outro para abrir o painel de tarefas do suplemento.

   Observação

   Independentemente do botão selecionado, um prompt Parar ao Carregar do WebView será exibido. Selecione OK.

   Dica

   O sideload no Office no Windows também disponibiliza o suplemento no Office na Web, para que você também possa testá-lo nessa plataforma. Após a conclusão desta etapa, minimize a janela do aplicativo Office no Windows e, em um navegador, navegue até https://excel.cloud.microsoft/, https://word.cloud.microsoft/, ou https://powerpoint.cloud.microsoft/, o que for apropriado para o suplemento que você está testando. Abra um documento novo ou existente no aplicativo do Office na Web. Os botões devem aparecer na faixa de opções da Página Inicial da mesma forma que aparecem no Office no Windows.

4. Para interromper a depuração e desinstalar o suplemento, selecione Executar | Parar Depuração no Visual Studio Code.

   Observação

   Se a etapa anterior parecer não surtir efeito, desinstale o suplemento abrindo um TERMINAL no Visual Studio Code e executando o comando npm run stop. Fechar a janela do servidor não interrompe o servidor de forma confiável, e fechar o aplicativo do Office não faz com que o Office cancele a aquisição do suplemento de maneira confiável.

Outras maneiras de fazer sideload

Confira Fazer sideload de suplementos do Office que usam o manifesto unificado do Microsoft 365 para obter maneiras alternativas de fazer sideload de um suplemento do Excel, PowerPoint ou Word, inclusive por meio da loja de aplicativos no Teams.

Sideload no Outlook

1. Certifique-se de que sua conta em sua tenancy de desenvolvedor do Microsoft 365 também seja uma conta de email no Outlook para área de trabalho. Se não estiver, siga as instruções em Adicionar uma conta de email ao Outlook.

2. Feche o Outlook para área de trabalho.

3. No Visual Studio Code, abra o Agents Toolkit.

4. Na seção CONTAS , verifique se você está conectado ao Microsoft 365.

5. Selecione Exibir | Executar no Visual Studio Code. No menu suspenso EXECUTAR E DEPURAR, selecione a opção Outlook Desktop (Edge Chromium) e pressione F5. O projeto é compilado e uma janela do servidor de desenvolvimento do nó é aberta. Esse processo pode levar alguns minutos e então o Outlook para área de trabalho será aberto.

   Observação

   Se esta for a primeira vez que você faz sideload de um Suplemento do Office em seu computador (ou a primeira vez em mais de um mês), você pode ser solicitado a excluir um certificado antigo e/ou instalar um novo. Concorde com os dois prompts.

6. Abra a caixa de entradada identidade da sua conta do Microsoft 365 e abra qualquer mensagem. Uma guia do Suplemento Contoso com dois botões aparecerá na faixa de opções Página Inicial (ou na faixa de opções Mensagem , se você tiver aberto a mensagem em sua própria janela).

7. Clique no botão Mostrar Painel de Tarefas e um painel de tarefas será aberto. Clique no botão Executar uma ação e uma pequena notificação aparecerá perto do topo da mensagem.

   Observação

   Independentemente do botão selecionado, um prompt Parar ao Carregar do WebView será exibido. Selecione OK.

8. Para interromper a depuração e desinstalar o suplemento, selecione Executar | Parar Depuração no Visual Studio Code.

   Observação

   Se a etapa anterior parecer não surtir efeito, desinstale o suplemento abrindo um TERMINAL no Visual Studio Code e executando o comando npm run stop. Fechar a janela do servidor não interrompe o servidor de forma confiável, e fechar o aplicativo do Office não faz com que o Office cancele a aquisição do suplemento de maneira confiável.

Desenvolva seu projeto

Agora você pode alterar e desenvolver o projeto. Em locais onde as diretrizes na documentação dos suplementos do Office são ramificadas dependendo do tipo de manifesto que está sendo usado, siga as diretrizes para o manifesto unificado.