Converta seu agente declarativo em um agente de mecanismo personalizado

O Microsoft 365 Copilot fornece um recurso de migração que permite converter agentes declarativos, incluindo extensões de mensagem que foram promovidas a agentes declarativos, em agentes de mecanismo personalizado. Ao converter seu agente declarativo em um agente de mecanismo personalizado, você tem controle total da orquestração, dos modelos de IA e das integrações de dados e pode aproveitar a funcionalidade avançada para criar fluxos de trabalho mais sofisticados.

Este artigo descreve as etapas a serem seguidas para converter um agente declarativo em um agente de mecanismo personalizado para aproveitar sua própria orquestração para atender melhor às necessidades exclusivas de sua organização.

Pré-requisitos

As etapas neste artigo exigem que você tenha os seguintes pré-requisitos:

Converta seu agente declarativo

Para converter seu agente declarativo existente em um agente de mecanismo personalizado, faça atualizações no manifesto do aplicativo e no pacote do aplicativo.

Atualizar seu manifesto do aplicativo

Para atualizar o manifesto do aplicativo:

  1. No Visual Studio Code, abra o arquivo de manifesto do aplicativo para seu agente declarativo.

  2. Adicione um nó de bots e inclua sua ID de bot no campo id . O exemplo a seguir mostra o esquema do nó de 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ó bots, consulte Objeto bots.

    Observação

    Use o esquema de manifesto do aplicativo versão 1.21 ou posterior. Os agentes de mecanismo personalizados têm suporte no manifesto versão 1.21 e versões posteriores.

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

    Nó de agentes declarativos

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

    Substituir pelo nó de agentes de mecanismo 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, consulte o objeto copilotAgents.

    Observação

    O manifesto do aplicativo pode incluir um nó de agente declarativo ou um nó de agente de mecanismo personalizado, mas não ambos.

  4. Atualize o número de versão do aplicativo para seu aplicativo na propriedade version .

  5. Certifique-se de que a propriedade id use a mesma ID que você usou no manifesto do aplicativo para o agente declarativo.

Personalizar a experiência de usuário do seu agente

Defina sua experiência de agente para os usuários. Você pode adicionar iniciadores de conversa e prompts sugeridos, implementar respostas e citações de streaming e muito mais. Observe que é necessário definir e testar os recursos do agente de mecanismo personalizado.

Para obter mais informações, consulte Recursos de experiência do usuário do agente do mecanismo personalizado.

Atualizar e enviar seu pacote do aplicativo

Depois de atualizar o manifesto do agente, reempacote seu aplicativo:

  1. Adicione seu manifesto de agente atualizado, ícone do aplicativo e outros ativos a um novo arquivo .zip.

  2. Envie o novo pacote para atualizar seu aplicativo existente. Se o seu agente for interno da sua organização, use o Centro de administração do Microsoft 365 (requer permissões de administrador de locatário).

    Observação

    Você pode enviar agentes de mecanismo personalizados que você converteu de um agente declarativo para o Partner Center. Os usuários do agente são solicitados a consentir em atualizar seu agente. Para obter mais informações, consulte a próxima seção.

Os agentes de mecanismo personalizados que são convertidos de agentes declarativos podem ser enviados ao Partner Center para distribuição, sujeitos à validação de marketplace aplicável e às políticas de locatário.

Quando um agente convertido introduz alterações que afetam recursos ou permissões, o agente não é atualizado automaticamente para os usuários existentes. Os usuários são solicitados a revisar e consentir com a versão atualizada antes de usá-la.

Os usuários veem um prompt de atualização no Copilot e no Teams e devem aprovar explicitamente a atualização. Se a aprovação adicional do administrador é necessária depende das permissões solicitadas e da configuração de consentimento do locatário.

Para obter detalhes, consulte Condições quando uma atualização de aplicativo requer consentimento.

Experiência do usuário

A transição de um agente declarativo para um agente de mecanismo personalizado é perfeita para o usuário. Se o nome e o logotipo usados no pacote do aplicativo forem iguais, os usuários não verão nenhuma alteração visível.

Se os usuários fixaram o agente, eles precisam fixar o agente novamente depois que você publicar a atualização.

Conteúdo relacionado

  • Last updated on