Personalize o Microsoft Copilot com um agente

O Microsoft 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 Usar agentes no Microsoft Copilot.

Este artigo descreve os tipos de agentes que pode criar para o Microsoft 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 Copilot.
• Crie um agente declarativo para o Microsoft Copilot ou um agente com motor personalizado para o Microsoft 365.
• Utilize o Microsoft Copilot Studio para ligar e configurar um agente para o Teams e o Microsoft 365 para que esteja disponível no Microsoft Copilot.
• Consulte as orientações sobre como escolher entre o Microsoft Copilot e o Copilot Studio para construir o seu agente.

Uma forma de criar um agente declarativo para uma aplicação orientada a modelos é ativar o Microsoft Copilot diretamente na sua aplicação. Para mais informações, consulte Ativar a sua aplicação para o Microsoft 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 Microsoft Copilot personalizada que se abre para os utilizadores, e as APIs criam a ligação bidirecional entre a sua aplicação e o Microsoft Copilot.

Definir um agente predefinido

Se criares um agente personalizado como complemento da 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 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 orientações específicos da aplicação estão prontos assim que o Microsoft Copilot abrir.

Um agente predefinido é especialmente útil para agentes focados em cenários que alargam a experiência base da aplicação e funcionam como a porta de entrada para a experiência Microsoft Copilot específica da aplicação que pretende que os utilizadores tenham.

Xrm.APIs do Copilot

As APIs do cliente Xrm.Copilot.* permitem aos programadores integrar o Microsoft Copilot diretamente em experiências de aplicações orientadas por modelos. Com estas APIs, a sua aplicação pode interagir diretamente com o painel lateral do Microsoft Copilot e responder a ações orientadas pelo Microsoft Copilot, para que possa criar cenários baseados em agentes mais ricos e completos.

Quando usa estas APIs com um agente por omissão, elas completam o padrão de modo de agente: o seu agente é o ponto de partida, a sua aplicação pode enviar pedidos e contexto para o Microsoft Copilot, e o Microsoft Copilot pode invocar ações na 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 prompts para o Microsoft Copilot. Utilize sendPromptToM365Copilot para iniciar uma interação com o Microsoft Copilot a partir da sua aplicação.
• Abre e controla o painel lateral do Microsoft Copilot. Utilize openM365CopilotPanel para garantir que o painel do Microsoft Copilot está visível quando necessário.
• Passar o contexto da aplicação para o Microsoft 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 as ações do Microsoft Copilot na tua aplicação. Utilize addActionHandler para registar manipuladores personalizados que processam ações provenientes de respostas do Microsoft 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 Copilot com o addActionHandler

Utilize a addActionHandler API quando a sua aplicação precisar de lidar com ações estruturadas que o Microsoft 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 Copilot podem incluir Action.Submit Cartões Adaptativos com botões 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 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 Copilot para utilizadores de aplicações em aplicações orientadas a modelos
• Use o Microsoft Copilot em aplicações orientadas a modelos
• Adicionar Microsoft Copilot para utilizadores de aplicações em aplicações canvas (pré-visualização)
• Utilize o Microsoft Copilot nas aplicações canvas (pré-visualização)
• Personalize o Microsoft Copilot com um agente nas aplicações de tela