Personalizzare Microsoft 365 Copilot con un agente

Microsoft 365 Copilot in Power Apps consente agli utenti di interagire con agenti personalizzati che estendono le operazioni che Copilot possono eseguire. Personalizzando un agente, è possibile creare esperienze personalizzate che si adattino ai processi e ai dati aziendali dell'organizzazione. Per altre informazioni, vedere Usare gli agenti in Microsoft 365 Copilot.

Questo articolo descrive i tipi di agenti che è possibile compilare per Microsoft 365 Copilot in Power Apps e consente di scegliere l'approccio appropriato per lo scenario.

Scegliere un tipo di agente

Nella tabella seguente vengono confrontati i tipi di agente che è possibile compilare.

Per trovare l'opzione migliore per l'organizzazione, usare queste risorse:

• Una panoramica e indicazioni su come scegliere il tipo di agente da creare in Panoramica degli agenti di Microsoft 365 Copilot.
• Creare un agente dichiarativo per Microsoft 365 Copilot o un agente del motore personalizzato per Microsoft 365.
• Usare Microsoft Copilot Studio per connettersi e configurare un agente per Teams e Microsoft 365 in modo che sia disponibile in Microsoft 365 Copilot.
• Esamina le linee guida su come scegliere tra Microsoft 365 Copilot e Copilot Studio per creare il tuo agente.

Un modo per creare un agente dichiarativo per un'app basata su modello consiste nell'attivare Microsoft 365 Copilot direttamente nell'app. Per altre informazioni, vedere Abilitare l'app per Microsoft 365 Copilot.

È possibile creare una modalità agente specifica dell'app in Power Apps combinando un agente predefinito con le Xrm.Copilot.* API. L'agente predefinito definisce l'esperienza di Microsoft 365 Copilot personalizzata che si apre per gli utenti e le API creano la connessione bidirezionale tra l'app e Microsoft 365 Copilot.

Impostare un agente predefinito

Se crei un agente personalizzato come complemento per la tua app basata su modello, puoi impostarlo come agente predefinito in modo che venga caricato automaticamente all'apertura dell'app e del riquadro laterale di Microsoft 365 Copilot. In questo modo l'agente è il punto di partenza per l'esperienza ed è la prima parte della creazione della modalità agente personalizzata.

Quando si imposta un agente predefinito:

• L'agente viene selezionato senza alcuna azione da parte dell'utente.
• Gli utenti passano direttamente all'esperienza personalizzata progettata per l'app.
• I flussi di lavoro e le indicazioni specifici dell'app sono pronti non appena si apre Microsoft 365 Copilot.

Un agente predefinito è particolarmente utile per gli agenti incentrati sullo scenario che estendono l'esperienza principale dell'app e fungono da frontdoor per l'esperienza di Microsoft 365 Copilot specifica dell'app che si vuole che gli utenti abbiano.

Xrm.API per Copilot

Le Xrm.Copilot.* API client consentono agli sviluppatori di integrare Microsoft 365 Copilot direttamente in esperienze di app basate su modello. Con queste API, la tua app può interagire direttamente con il riquadro laterale di Microsoft 365 Copilot e rispondere alle azioni avviate da Microsoft 365 Copilot, così puoi creare scenari agentici end-to-end più avanzati.

Usate insieme a un agente predefinito, queste API completano il modello di modalità agente: l'agente è il punto di partenza, l'app può inviare richieste e contesto in Microsoft 365 Copilot e Microsoft 365 Copilot può richiamare le azioni all'interno dell'app.

Per la superficie completa dell'API, vedere Xrm.Copilot (Informazioni di riferimento sulle API client) nelle app basate su modello.

Queste API consentono di:

• Inviare richieste a Microsoft 365 Copilot. Usa sendPromptToM365Copilot per avviare un'interazione Microsoft 365 Copilot dalla tua app.
• Aprire e controllare il riquadro laterale Microsoft 365 Copilot. Usare openM365CopilotPanel per assicurarsi che il riquadro Microsoft 365 Copilot sia visibile quando necessario.
• Passare il contesto dell'app a Microsoft 365 Copilot. Usa updateContext (anteprima) per inviare segnali di grounding aggiuntivi dalla tua app.
• Lavorare con gli agenti. Usare getCurrentAgent per verificare quale agente è attivo.
• Gestire le azioni di Microsoft 365 Copilot nella tua app. Usa addActionHandler per registrare gestori personalizzati che elaborano le azioni inviate nelle risposte di Microsoft 365 Copilot.

Insieme, queste API creano un'esperienza bidirezionale reale tra l'interfaccia utente dell'app e l'agente, in modo che gli agenti possano guidare gli aggiornamenti dell'interfaccia utente, attivare flussi di lavoro o eseguire logica di business personalizzata.

Gestire le azioni Microsoft 365 Copilot con addActionHandler

Usa l'addActionHandlerAPI quando l'app deve gestire azioni strutturate che Microsoft 365 Copilot produce.

Quando crei il payload dell'azione:

• Impostare type su PowerApps per usare come destinazione l'host di Power Apps.
• Imposta action (ad esempio, MyNamespace.MyMessage) su actionId registrato in addActionHandler.
• Usa actionData per il payload che il codice elabora e passa all'host di Power Apps.

Le sezioni seguenti illustrano due scenari supportati.

Schede adattive

Le risposte di Microsoft 365 Copilot possono includere Schede adattive con pulsanti Action.Submit che inviano messaggi di azione all'host di Power Apps.

Esempio:

{
  "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"
            }
          }
        }
      ]
    }
  ]
}

App MCP

Le risposte di Microsoft 365 Copilot possono includere HTML che invia messaggi di azione all'host di Power Apps.

Esempio:

<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

• Gli agenti che crei non possono ancora usare il contesto utente nell'app per personalizzare le risposte.
• Quando si imposta un agente predefinito, i prompt iniziali dell'agente non vengono visualizzati.

Informazioni correlate

• Aggiungi Microsoft 365 Copilot per gli utenti di app basate su modelli
• Usare Microsoft 365 Copilot nelle app basate su modello
• Aggiungi Microsoft 365 Copilot per gli utenti delle app canvas (versione di anteprima)
• Usare Microsoft 365 Copilot nelle app canvas (anteprima)
• Personalizzare Microsoft 365 Copilot con un agente nelle app canvas