Personalize o Microsoft 365 Copilot com um agente

O Microsoft 365 Copilot no Power Apps permite aos utilizadores interagir com agentes personalizados que expandem o que o Copilot pode fazer. Ao personalizar um agente, pode criar experiências personalizadas que se adequam aos processos e dados de negócio da sua organização. Para mais informações, consulte Agentes de uso no Microsoft 365 Copilot.

Este artigo descreve os tipos de agentes que pode construir para o Microsoft 365 Copilot no Power Apps e ajuda-o a escolher a abordagem certa para o seu cenário.

Escolha um tipo de agente

A tabela seguinte compara os tipos de agentes que pode construir.

Para encontrar a melhor opção para a sua organização, utilize estes recursos:

• Obtenha uma visão geral e orientação sobre como escolher que tipo de agente construir na visão geral dos agentes do Microsoft 365 Copilot.
• Crie um agente declarativo para o Microsoft 365 Copilot ou um agente de motor personalizado para o Microsoft 365.
• Use o Microsoft Copilot Studio para ligar e configurar um agente para o Teams e o Microsoft 365 para que esteja disponível no Microsoft 365 Copilot.
• Consulte as orientações sobre como escolher entre Microsoft 365 Copilot e Copilot Studio para construir o seu agente.

Uma forma de criar um agente declarativo para uma aplicação orientada a modelos é ativar o Microsoft 365 Copilot diretamente na sua aplicação. Para mais informações, consulte Ativar a sua aplicação para Microsoft 365 Copilot.

Pode criar o seu próprio modo agente específico para aplicação no Power Apps combinando um agente predefinido com as Xrm.Copilot.* APIs. O agente padrão define a experiência personalizada do Microsoft 365 Copilot que se abre aos utilizadores, e as APIs criam a ligação bidirecional entre a sua aplicação e o Microsoft 365 Copilot.

Definir um agente predefinido

Se criares um agente personalizado como complemento à tua aplicação orientada a modelos, podes defini-lo como agente predefinido para carregar automaticamente quando a aplicação e o painel lateral do Microsoft 365 Copilot se abrirem. Isto faz do seu agente o ponto de partida da experiência e constitui a primeira etapa para criar o seu próprio modo de agente.

Quando defines um agente por defeito:

• O seu agente é selecionado sem qualquer ação do utilizador.
• Os utilizadores vão diretamente à experiência personalizada que desenhou para a aplicação.
• Os fluxos de trabalho e a orientação específicos das aplicações ficam disponíveis assim que o Microsoft 365 Copilot é aberto.

Um agente predefinido é especialmente útil para agentes orientados para cenários específicos que expandem a experiência principal da aplicação e servem de porta de entrada para a experiência do Microsoft 365 Copilot específica da aplicação que pretende proporcionar aos utilizadores.

Xrm.APIs do Copilot

As Xrm.Copilot.* APIs do cliente permitem aos programadores integrar o Microsoft 365 Copilot diretamente nas experiências de aplicações orientadas a modelos. Com estas APIs, a sua aplicação pode interagir diretamente com o painel lateral do Microsoft 365 Copilot e responder a ações impulsionadas pelo Microsoft 365 Copilot, para poder criar cenários agênticos mais ricos e de ponta a ponta.

Usadas em conjunto com um agente predefinido, estas APIs completam o padrão de modo agente: o seu agente é o ponto de partida, a sua aplicação pode enviar prompts e contexto para o Microsoft 365 Copilot, e o Microsoft 365 Copilot pode invocar ações de volta dentro da sua aplicação.

Para a superfície completa da API, veja Xrm.Copilot (Referência à API do cliente) em aplicações orientadas a modelos.

Estas APIs permitem-lhe:

• Envie pedidos ao Microsoft 365 Copilot. Use sendPromptToM365Copilot para iniciar uma interação com o Microsoft 365 Copilot a partir da sua aplicação.
• Abra e controle o painel lateral do Microsoft 365 Copilot. Uso openM365CopilotPanel para garantir que o painel do Microsoft 365 Copilot está visível quando necessário.
• Passa o contexto da aplicação para o Microsoft 365 Copilot. Utilize updateContext (pré-visualização) para enviar sinais de fundamentação adicionais a partir da sua aplicação.
• Trabalhe com agentes. Use getCurrentAgent para verificar qual agente está ativo.
• Gere ações do Microsoft 365 Copilot na sua aplicação. Utilize addActionHandler para registar processadores personalizados que processam ações enviadas nas respostas do Microsoft 365 Copilot.

Juntas, estas APIs criam uma verdadeira experiência bidirecional entre a interface da aplicação e o agente, permitindo que os agentes promovam atualizações da interface, ativassem fluxos de trabalho ou executassem lógica de negócio personalizada.

Gerir as ações do Microsoft 365 Copilot com o addActionHandler

Use a addActionHandler API quando a sua aplicação precisar de lidar com ações estruturadas que o Microsoft 365 Copilot emite.

Quando cria o payload da ação:

• Defina type como PowerApps para ter como destino o anfitrião do Power Apps.
• Defina action (por exemplo, MyNamespace.MyMessage) como o actionId que regista em addActionHandler.
• Utilize actionData para o payload que o seu código processa e passa ao host do Power Apps.

As secções seguintes mostram dois cenários suportados.

Cartões Adaptativos

As respostas do Microsoft 365 Copilot podem incluir Cartões Adaptativos com botões Action.Submit que enviam mensagens de ação para o anfitrião do Power Apps.

Example:

{
  "type": "AdaptiveCard",
  "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
  "version": "1.5",
  "body": [
    {
      "type": "TextBlock",
      "text": "Click Go and I will send data to the host to process.",
      "wrap": true,
      "id": "txtSendMessage"
    },
    {
      "type": "ActionSet",
      "actions": [
        {
          "type": "Action.Submit",
          "title": "Go",
          "id": "btnGo",
          "data": {
            "type": "PowerApps",
            "action": "MyNamespace.MyMessage",
            "actionData": {
              "foo": "bar"
            }
          }
        }
      ]
    }
  ]
}

Aplicações MCP

As respostas do Microsoft 365 Copilot podem incluir HTML que envia mensagens de ação para o host do Power Apps.

Example:

<Button
  appearance="outline"
  icon={<ArrowLeft24Regular />}
  onClick={() => {
    try {
      const message = {
        eventName: 'powerapps.copilot.chat.action',
        action: 'MyNamespace.MyMessage',
        actionData: {
          foo: 'bar'
        },
      };
      window.parent.parent.postMessage(message, '*');
    } catch (error) {
      // eslint-disable-next-line no-console
      console.error('Error posting HOST_ACTION message to parent window:', error);
    }
  }}
>
  Test
</Button>

Limitations

• Os agentes que criar ainda não conseguem utilizar o contexto de utilizador na aplicação para personalizar as suas respostas.
• Ao pré-definir um agente, os pedidos de início do agente não são compostos.

Informações relacionadas

• Adicionar Microsoft 365 Copilot para utilizadores de apps em aplicações baseadas em modelos
• Usa Microsoft 365 Copilot em aplicações orientadas a modelos
• Adicionar o Microsoft 365 Copilot para utilizadores de aplicações em aplicações de tela (pré-visualização)
• Utilizar o Microsoft 365 Copilot em aplicações de tela (pré-visualização)
• Personalizar o Microsoft 365 Copilot com um agente em aplicações de tela