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 Copilot direttamente nell'app. Per altre informazioni, vedere Abilitare l'app per Copilot.

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 con Copilot e rispondere alle azioni guidate da Copilot, così puoi creare scenari agentici end-to-end più ricchi.

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 Copilot. Usa sendPromptToM365Copilot per avviare un'interazione Copilot dalla tua app.
• Aprire e controllare il riquadro laterale Copilot. Usare openM365CopilotPanel per assicurarsi che il riquadro Copilot sia visibile quando necessario.
• Passare il contesto dell'app a 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 Copilot nell'app. Usa addActionHandler per registrare handler personalizzati che elaborano le azioni inviate nelle risposte di Copilot.

Insieme, queste API collegano le risposte di Copilot alla logica dell'applicazione, in modo che gli agenti possano pilotare gli aggiornamenti dell'interfaccia utente, attivare i flussi di lavoro o eseguire una logica aziendale personalizzata.

Gestire le azioni Copilot con addActionHandler

Usa l'API addActionHandler quando l'app deve gestire azioni strutturate che Copilot emette.

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.
• Usare 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 Copilot possono includere Schede adattive con pulsanti Action.Submit che inviano messaggi d'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 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>

Impostare un agente predefinito

Se si crea un agente personalizzato come supporto per l'app basata su modello, è possibile impostarlo come agente predefinito in modo che venga caricato automaticamente all'apertura dell'app e del riquadro laterale di Copilot.

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

Un agente predefinito è particolarmente utile per gli agenti incentrati sullo scenario che estendono l'esperienza principale dell'app.

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