Personalize o Microsoft Copilot com um agente

Microsoft Copilot no Power Apps permite que os usuários interajam com agentes personalizados que estendem o que Copilot pode fazer. Ao personalizar um agente, você pode criar experiências personalizadas que se ajustem aos dados e processos de negócios da sua organização. Para obter mais informações, consulte Usar agentes no Microsoft Copilot.

Este artigo descreve os tipos de agentes que você pode criar para Microsoft Copilot em Power Apps e ajuda você a escolher a abordagem certa para seu cenário.

Escolher um tipo de agente

A tabela a seguir compara os tipos de agente que você pode criar.

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

• Obtenha uma visão geral e diretrizes sobre como escolher que tipo de agente criar em visão geral dos agentes no Microsoft Copilot.
• Crie um agente declarativo para Microsoft Copilot ou um agente de mecanismo personalizado para Microsoft 365.
• Use Microsoft Copilot Studio para se conectar e configurar um agente para o Teams e Microsoft 365 para que ele esteja disponível em Microsoft Copilot.
• Examine as diretrizes sobre como escolher entre Microsoft Copilot e Copilot Studio para criar seu agente.

Uma maneira de criar um agente declarativo para um aplicativo baseado em modelo é ativar Microsoft Copilot diretamente em seu aplicativo. Para obter mais informações, consulte Habilitar seu aplicativo para Microsoft Copilot.

Você pode criar seu próprio modo de agente específico do aplicativo em Power Apps combinando um agente padrão com as Xrm.Copilot.* APIs. O agente padrão define a experiência personalizada do Microsoft Copilot que se abre para os usuários, e as APIs criam a conexão bidirecional entre seu aplicativo e o Microsoft Copilot.

Definir um agente padrão

Se você criar um agente personalizado como complemento do seu aplicativo controlado por modelos, poderá defini-lo como o agente padrão para que ele seja carregado automaticamente quando o aplicativo e o painel lateral do Microsoft Copilot forem abertos. Isso torna seu agente o ponto de partida para a experiência e é a primeira parte da criação do seu próprio modo de agente.

Quando você define um agente padrão:

• Seu agente é selecionado sem nenhuma ação do usuário.
• Os usuários vão direto para a experiência personalizada que você projetou para o aplicativo.
• Os fluxos de trabalho e as diretrizes específicos do aplicativo estão prontos assim que o Microsoft Copilot é aberto.

Um agente padrão é especialmente útil para agentes focados em cenários que estendem a experiência principal do aplicativo e atuam como a porta da frente para a experiência de Microsoft Copilot específica do aplicativo que você deseja que os usuários tenham.

Xrm.APIs do Copilot

As APIs de cliente Xrm.Copilot.* permitem que os desenvolvedores integrem o Microsoft Copilot diretamente às experiências de aplicativos orientados por modelos. Com essas APIs, seu aplicativo pode interagir diretamente com o painel lateral do Microsoft Copilot e responder a ações controladas pelo Microsoft Copilot, para que você possa criar cenários com agentes mais avançados e de ponta a ponta.

Quando você usa essas APIs com um agente padrão, elas completam o padrão do modo de agente: seu agente é o ponto de partida, seu aplicativo pode enviar prompts e contexto para o Microsoft Copilot, e o Microsoft Copilot pode invocar ações no seu aplicativo.

Para obter a superfície de API completa, consulte Xrm.Copilot (referência de API do cliente) em aplicativos controlados por modelos.

Essas APIs permitem que você:

• Enviar prompts para Microsoft Copilot. Use sendPromptToM365Copilot para iniciar uma interação do Microsoft Copilot no seu aplicativo.
• Abra e controle o painel lateral Microsoft Copilot. Use openM365CopilotPanel para verificar se o painel Microsoft Copilot está visível quando necessário.
• Passe o contexto do aplicativo para Microsoft Copilot. Use updateContext (versão preliminar) para enviar sinais de aterramento extras do seu aplicativo.
• Trabalhe com agentes. Use getCurrentAgent para verificar qual agente está ativo.
• Lide com as ações do Microsoft Copilot no seu aplicativo. Use addActionHandler para registrar manipuladores personalizados que processam ações enviadas nas respostas do Microsoft Copilot.

Juntas, essas APIs criam uma verdadeira experiência bidirecional entre a interface do usuário do aplicativo e o agente, para que os agentes possam conduzir atualizações de interface do usuário, disparar fluxos de trabalho ou executar lógica de negócios personalizada.

Manipular ações de Microsoft Copilot com addActionHandler

Use a addActionHandler API quando seu aplicativo precisar lidar com ações estruturadas que o Microsoft Copilot emite.

Quando você cria o conteúdo da ação:

• Defina type como PowerApps para direcionar o host Power Apps.
• Defina action (por exemplo, MyNamespace.MyMessage) como o actionId que você registra em addActionHandler.
• Use actionData para o conteúdo que seu código processa e passa para o host Power Apps.

As seções a seguir mostram dois cenários com suporte.

Cartões Adaptáveis

As respostas do Microsoft Copilot podem incluir Cartões Adaptáveis com botões Action.Submit que enviam mensagens de ação para o host 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"
            }
          }
        }
      ]
    }
  ]
}

Aplicativos MCP

As respostas do Microsoft Copilot podem incluir HTML que envia mensagens de ação para o host 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 você cria ainda não podem usar o contexto do usuário no aplicativo para adaptar suas respostas.
• Ao definir um agente padrão, os prompts iniciais do agente não são exibidos.

Informações relacionadas

• Adicionar Microsoft Copilot para usuários de aplicativos em aplicativos baseados em modelo
• Usar Microsoft Copilot em aplicativos controlados por modelos
• Adicionar o Microsoft Copilot para usuários de aplicativos em aplicativos baseados em tela (versão prévia)
• Usar Microsoft Copilot em aplicativos de tela (versão prévia)
• Personalizar Microsoft Copilot com um agente em aplicativos de tela