Partilhar via

Converter o agente declarativo num agente de motor personalizado

Microsoft 365 Copilot fornece uma capacidade de migração que lhe permite converter agentes declarativos, incluindo extensões de mensagens que foram promovidas a agentes declarativos, em agentes de motor personalizados. Quando converte o agente declarativo num agente de motor personalizado, tem controlo total da orquestração, dos modelos de IA e das integrações de dados e pode tirar partido das funcionalidades avançadas para criar fluxos de trabalho mais sofisticados.

Este artigo descreve os passos a seguir para converter um agente declarativo num agente de motor personalizado para tirar partido da sua própria orquestração para satisfazer melhor as necessidades exclusivas da sua organização.

Pré-requisitos

Os passos neste artigo requerem que tenha os seguintes pré-requisitos:

  • Um agente declarativo existente criado com o Toolkit de Agentes do Microsoft 365.

    Observação

    Os agentes criados com Microsoft 365 Copilot não são atualmente suportados.

  • Um bot personalizado e o ID do bot. Para obter informações sobre como criar um bot personalizado, consulte Bots e agentes.

  • Visual Studio Code com a extensão Toolkit de Agentes do Microsoft 365 instalada.

  • O SDK de Agentes do Microsoft 365 ou o SDK do Teams, se quiser implementar funcionalidades específicas do Copilot, como transmissão em fluxo ou citações.

  • Permissões para carregar manifestos de aplicações no seu ambiente.

Converter o agente declarativo

Para converter o agente declarativo existente num agente de motor personalizado, faça atualizações ao manifesto da aplicação e ao pacote de aplicação.

Atualizar seu manifesto do aplicativo

Para atualizar o manifesto da aplicação:

  1. No Visual Studio Code, abra o ficheiro de manifesto da aplicação para o agente declarativo.

  2. Adicione um nó de bots e inclua o ID do bot no campo ID . O exemplo seguinte mostra o esquema do nó bots .

        "bots": [ 
        { 
            "botId": "${{BOT_ID}}", 
            "scopes": [ 
                "copilot", 
                "personal", 
                "team" 
            ], 
            "supportsFiles": false, 
            "isNotificationOnly": false, 
            "commandLists": [ 
                { 
                    "scopes": [ 
                        "copilot", 
                        "personal" 
                    ], 
                    "commands": [ 
                        { 
                            "title": "How can you help me?", 
                            "description": "How can you help me?" 
                        } 
                    ] 
                } 
            ] 
        } 
    ],

    Para obter mais informações sobre o esquema do nó de bots, veja objeto bots.

    Observação

    Utilize a versão 1.21 ou posterior do esquema de manifesto de aplicação. Os agentes do motor personalizado são suportados na versão de manifesto 1.21 e versões posteriores.

  3. No objeto copilotAgents , altere o nó declarativeAgents para um nó customEngineAgents , conforme mostrado nos exemplos seguintes.

    Nó de agentes declarativos

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

    Substituir pelo nó de agentes do motor personalizado

    "copilotAgents": {
    "customEngineAgents": [
        {
            "type": "bot",
            "id": "${{BOT_ID}}"
        }
    ]
},
"bots": [
    { 
      "botId": "${{BOT_ID}}",
        "scopes": [
            "copilot",
            "personal",
            "team"
        ], 
        "supportsFiles": false,
        "isNotificationOnly": false,
        "commandLists": [
            {
                "scopes": [
                    "copilot",
                    "personal"
                ],
                "commands": [
                    {
                        "title": "How can you help me?",
                        "description": "How can you help me?"
                    }
                ]
            }
        ]
    }
],

    Para obter informações de referência de esquema, veja objeto copilotAgents.

    Observação

    O manifesto da aplicação pode incluir um nó de agente declarativo ou um nó do agente do motor personalizado, mas não ambos.

  4. Atualize o número da versão da aplicação na propriedade da versão .

  5. Certifique-se de que a propriedade ID utiliza o mesmo ID que utilizou no manifesto da aplicação para o agente declarativo.

Personalizar a UX do agente

Defina a sua experiência de agente para os utilizadores. Pode adicionar iniciadores de conversação e avisos sugeridos, implementar respostas e citações de transmissão em fluxo e muito mais. Tenha em atenção que tem de definir e testar as capacidades do agente do motor personalizado.

Para obter mais informações, veja Funcionalidades de experiência de utilizador do agente do motor personalizado.

Atualizar e submeter o pacote de aplicações

Depois de atualizar o manifesto do agente, volte a empacotar a sua aplicação:

  1. Adicione o manifesto do agente atualizado, o ícone da aplicação e quaisquer outros recursos a um novo ficheiro de .zip.

  2. Submeta o novo pacote para atualizar a sua aplicação existente. Se o agente for interno para a sua organização, utilize o Centro de administração do Microsoft 365 (requer permissões de administrador de inquilinos).

    Observação

    A submissão do pacote de aplicações para o marketplace comercial através do Centro de Parceiros não é atualmente suportada.

Experiência do usuário

A transição de um agente declarativo para um agente de motor personalizado é totalmente integrada para o utilizador. Se o nome e o logótipo que utiliza no pacote de aplicações forem os mesmos, os utilizadores não verão alterações visíveis.

Se os utilizadores afixaram o agente, terão de afixar novamente o agente depois de publicar a atualização.

Conteúdo relacionado

  • Last updated on