Personalizar Microsoft 365 Copilot com um agente

Microsoft 365 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 365 Copilot.

Este artigo descreve os tipos de agentes que você pode criar para Microsoft 365 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 Microsoft 365 Copilot visão geral dos agentes.
• Crie um agente declarativo para Microsoft 365 Copilot ou um agente de mecanismo personalizado para Microsoft 365.
• Use Microsoft Copilot Studio para conectar e configurar um agente no Teams e no Microsoft 365 para que ele fique disponível no Microsoft 365 Copilot.
• Examine as diretrizes sobre como escolher entre Microsoft 365 Copilot e Copilot Studio para criar seu agente.

Uma maneira de criar um agente declarativo para um aplicativo controlado por modelo é ativar Microsoft 365 Copilot diretamente em seu aplicativo. Para obter mais informações, consulte Habilitar seu aplicativo para Microsoft 365 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 de Microsoft 365 Copilot personalizada que é aberta para os usuários e as APIs criam a conexão bidirecional entre seu aplicativo e Microsoft 365 Copilot.

Definir um agente padrão

Se você criar um agente personalizado como um complementar ao 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 Microsoft 365 Copilot abrirem. 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 orientações específicos do aplicativo ficam prontos assim que o Microsoft 365 Copilot é iniciado.

Um agente padrão é especialmente útil para agentes voltados para cenários específicos que ampliam a experiência central do aplicativo e atuam como a porta de entrada para a experiência específica do aplicativo no Microsoft 365 Copilot que você deseja que os usuários tenham.

Xrm.APIs do Copilot

As Xrm.Copilot.* APIs de cliente permitem que os desenvolvedores integrem Microsoft 365 Copilot diretamente em experiências de aplicativo orientadas por modelos. Com essas APIs, seu aplicativo pode interagir diretamente com o painel lateral do Microsoft 365 Copilot e responder a ações orientadas pelo Microsoft 365 Copilot, para que você possa criar cenários agênticos mais ricos, de ponta a ponta.

Usadas junto com um agente padrão, essas APIs completam o padrão de modo de agente: seu agente é o ponto de partida, seu aplicativo pode enviar prompts e contexto para Microsoft 365 Copilot e Microsoft 365 Copilot pode invocar ações de volta dentro de 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 365 Copilot. Use sendPromptToM365Copilot para iniciar uma interação com o Microsoft 365 Copilot a partir do seu aplicativo.
• Abra e controle o painel lateral Microsoft 365 Copilot. Use openM365CopilotPanel para verificar se o painel Microsoft 365 Copilot está visível quando necessário.
• Passe o contexto do aplicativo para Microsoft 365 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.
• Manipule Microsoft 365 Copilot ações em seu aplicativo. Use addActionHandler para registrar manipuladores personalizados que processam ações enviadas nas respostas do Microsoft 365 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 365 Copilot com addActionHandler

Use a addActionHandler API quando seu aplicativo precisar lidar com ações estruturadas que Microsoft 365 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 365 Copilot podem incluir Cartões Adaptáveis com botões Action.Submit que enviam mensagens de ação para o host 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"
            }
          }
        }
      ]
    }
  ]
}

Aplicativos 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 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 365 Copilot para usuários de aplicativos em aplicativos baseados em modelo
• Usar o Microsoft 365 Copilot em aplicativos baseados em modelos
• Adicionar o Microsoft 365 Copilot para usuários do aplicativo em aplicativos de tela (versão preliminar)
• Use o Microsoft 365 Copilot em aplicativos Canvas (versão prévia)
• Personalizar o Microsoft 365 Copilot com um agente em aplicativos de tela (versão preliminar)