Os agentes são aplicações para o Microsoft 365

Quando cria um agente, também está a criar uma aplicação para o Microsoft 365. As aplicações para o Microsoft 365 partilham um esquema de manifesto comum e formato de empacotamento, bem como processos e ferramentas de gestão e distribuição unificados. O resultado final é que as suas aplicações e agentes atingem a audiência mais ampla possível e aparecem contextualmente no fluxo de trabalho dos seus utilizadores.

Este artigo descreve as partes principais do modelo de aplicações do Microsoft 365 que se aplicam ao desenvolvimento de agentes.

Pacote do aplicativo

O pacote de aplicação para o Microsoft 365, incluindo agentes, é um ficheiro zip que contém um ou mais ficheiros de configuração (manifesto) e os ícones da sua aplicação. A lógica da aplicação e o armazenamento de dados são alojados noutro local e acedidos pela aplicação anfitriã do Microsoft 365 através de HTTPS. Irá submeter o pacote de aplicação ao seu administrador para publicar na sua organização ou no Centro de Parceiros para publicar no Microsoft AppSource.

No mínimo, um pacote de aplicação contém:

• O manifesto da aplicação (manifest.json), que descreve a configuração da aplicação, as capacidades, os recursos necessários e os atributos importantes
• Um ícone de cor grande (color.png), um ícone de cor completa 92x92 para apresentar o agente na IU Microsoft Copilot e armazenar
• Um pequeno ícone de destaque (outline.png), um ícone 32x32 com fundo transparente (não atualmente utilizado em Copilot, mas necessário para passar a validação)

O pacote de aplicações também pode conter definições declarativas do agente e do plug-in da API, bem como ficheiros de localização para outros idiomas suportados.

Ícones do aplicativo

O pacote de aplicação tem de incluir uma versão de cor e destaque do ícone da sua aplicação, como .png ficheiros. Estes ícones têm requisitos de tamanho específicos para passar a validação do arquivo.

Para obter orientações de estrutura para ícones de cores e destaques para o pacote de aplicações do Microsoft 365, consulte Ícones de aplicações para a Loja Teams e a barra de aplicações.

Ícone de cor

O ícone de cor representa o seu agente nas lojas de aplicações Microsoft Copilot IU e no produto (Teams, Outlook, Microsoft 365).

Ícone de contorno

O ícone de destaque é utilizado para representar aplicações afixadas e/ou ativas na barra de aplicações do Teams. Não é atualmente utilizado para agentes, mas ainda é necessário para que o pacote de aplicações passe na validação.

Manifesto do aplicativo

O manifesto da aplicação para o Microsoft 365 é um ficheiro JSON que descreve a funcionalidade e as características da sua aplicação. Na sua essência, o manifesto da aplicação para o Microsoft 365 é o esquema para a criação de aplicações do Teams; No entanto, a partir da versão 1.13, suporta aplicações que são executadas em anfitriões do Microsoft 365, além do Teams.

Se estiver a utilizar Copilot Studio para criar um agente declarativo, o manifesto da aplicação é gerado automaticamente com base nas informações que fornecer durante o processo de criação.

Cada manifesto de aplicação tem de incluir os seguintes campos.

O exemplo seguinte mostra um manifesto de aplicação com secções de marcador de posição no final para a extensão de mensagens e as capacidades da aplicação declarativa do agente.

{
    "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.18/MicrosoftTeams.schema.json",
    "manifestVersion": "1.18",
    "version": "1.0.0",
    "id": "00000000-0000-0000-0000-000000000000",
    "developer": {
        "name": "Northwind Traders",
        "websiteUrl": "https://www.example.com",
        "privacyUrl": "https://www.example.com/termofuse",
        "termsOfUseUrl": "https://www.example.com/privacy"
    },
    "icons": {
        "color": "Northwind-Logo-196.png",
        "outline": "Northwind-Logo-32.png"
    },
    "name": {
        "short": "Northwind Inventory",
        "full": "Northwind Inventory App"
    },
    "description": {
        "short": "App allows you to find and update product inventory information",
        "full": "Northwind Inventory is the ultimate tool for managing your product inventory. With its intuitive interface and powerful features, you'll be able to easily find your products by name, category, inventory status, and supplier city. You can also update inventory information with the app."
    },
    "accentColor": "#3690E9",
    "composeExtensions": {
        ...
    },
    "copilotAgents": {
        ...
    }
}

Para saber mais, veja Manifesto da aplicação.

copilotAgents definições

Os agentes declarativos e os plug-ins de API têm cada um os seus próprios esquemas de definição. O ficheiro de definição de um agente declarativo é referenciado a copilotAgents partir do objeto do manifesto da aplicação.

O exemplo seguinte mostra como referenciar um agente declarativo:

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

A definição de um plug-in de API é referenciada (em actions) a partir da definição do agente declarativo.

Observe o seguinte:

• Atualmente, só é suportada uma definição declarativa de agente por manifesto de aplicação.

• Quando utiliza Copilot Studio para criar agentes, é gerado um exclusivo id para cada um, como parte da geração geral de manifestos de aplicação. Ao criar agentes com o Teams Toolkit ou o seu próprio IDE, atribui-o a si próprio, de acordo com as id suas próprias convenções ou nome amigável.

Manifesto do agente declarativo

O manifesto do agente declarativo inclui instruções para respostas copilot, pedidos de exemplo de arranque de conversação, origens de dados utilizadas para a base e uma lista de ações (competências de plug-in da API) que o agente consegue executar.

Para saber mais, veja Esquema de manifesto do agente declarativo para Microsoft 365 Copilot.

Manifesto do plug-in da API

O manifesto do plug-in da API descreve as capacidades do plug-in, incluindo as APIs que suporta e as operações que pode realizar. Também inclui metadados como nome, descrição, versão e uma referência à definição openAPI das APIs REST com as quais interage. Os plug-ins de API podem ser referenciados a partir de um manifesto de agente declarativo para serem utilizados na experiência declarativa do agente.

Para saber mais, veja Esquema de manifesto de plug-in da API para Microsoft 365 Copilot.

Conteúdo relacionado

• Localizar o agente
• Gerir a extensibilidade do Microsoft 365 Copilot
• Publicar agentes para Microsoft 365 Copilot