Personalizzare Microsoft Copilot con un agente

Microsoft Copilot in Power Apps consente agli utenti di interagire con agenti personalizzati che estendono le operazioni che Copilot può 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 Copilot.

Questo articolo descrive i tipi di agenti che è possibile creare per Microsoft 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:

• Panoramica e indicazioni su come scegliere il tipo di agente da creare nella panoramica degli agenti di Microsoft Copilot.
• Crea un agente dichiarativo per Microsoft Copilot o un agente con 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 Copilot.
• Esaminare le indicazioni su come scegliere tra Microsoft 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 Copilot direttamente nell'app. Per altre informazioni, vedere Abilitare l'app per Microsoft 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 Copilot personalizzata che si apre per gli utenti e le API creano la connessione bidirezionale tra l'app e Microsoft Copilot.

Impostare un agente predefinito

Se si crea un agente personalizzato come complemento dell'app basata su modello, è possibile impostarlo come agente predefinito in modo che venga caricato automaticamente quando sono aperti l'app e il riquadro laterale di Microsoft 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 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 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 Copilot direttamente in esperienze di app basate su modello. Con queste API, l'app può interagire direttamente con il riquadro laterale Microsoft Copilot e rispondere alle azioni basate su Microsoft Copilot, in modo da poter creare scenari agentici end-to-end più completi.

Quando usi queste API con un agente predefinito, completano il modello di modalità agente: l'agente è il punto di partenza, l'app può inviare prompt e contesto a Microsoft Copilot e Microsoft 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 Copilot. Usa sendPromptToM365Copilot per avviare un'interazione Microsoft Copilot dalla tua app.
• Aprire e controllare il riquadro laterale Microsoft Copilot. Usare openM365CopilotPanel per assicurarsi che il riquadro Microsoft Copilot sia visibile quando necessario.
• Passare il contesto dell'app a Microsoft 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 Copilot nell'app. Usare addActionHandler per registrare gestori personalizzati che elaborano le azioni inviate dalle risposte di Microsoft 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 Copilot con addActionHandler

Usare l'addActionHandler API quando la tua app deve gestire azioni strutturate che Microsoft Copilot genera.

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 Copilot possono includere Schede adattive con pulsanti Action.Submit che inviano messaggi di azione all'host 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 Copilot possono includere HTML che invia messaggi di azione all'host 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

• Aggiungere Microsoft Copilot per gli utenti delle app nelle app basate su modello
• Usare Microsoft Copilot nelle app basate su modello
• Aggiungere Microsoft Copilot per gli utenti dell'app nelle app canvas (anteprima)
• Usare Microsoft Copilot nelle app canvas (anteprima)
• Personalizzare Microsoft Copilot con un agente nelle app canvas