Microsoft Copilotin mukauttaminen agentin avulla

Microsoft Copilotin avulla Power Appsissa käyttäjät voivat olla vuorovaikutuksessa mukautettujen agenttien kanssa, jotka laajentavat Copilotin toimintoja. Mukauttamalla agenttia voit luoda räätälöityjä kokemuksia, jotka sopivat organisaatiosi liiketoimintaprosesseihin ja tietoihin. Lisätietoja on artikkelissa Agenttien käyttö Microsoft Copilot.

Tässä artikkelissa kerrotaan agenttityypeistä, joita voidaan luoda Power Appsin Microsoft Copilotille, sekä juuri oikean lähestymistavan valitsemisesta skenaariota varten.

Valitse agenttityyppi

Seuraavassa taulukossa verrataan agenttityyppejä, joita voit luoda.

Löydät organisaatiollesi parhaan vaihtoehdon käyttämällä seuraavia resursseja:

• Yleiskatsaus ja ohjeita siitä, miten luotavan agentin tyyppi valitaan, on kohdassa Microsoft Copilot -agenttien yleiskatsaus.
• Luo Microsoft Copilotia varten deklaratiivisen agentin tai Microsoft 365:tä varten mukautetun moottoriagentin.
• Microsoft Copilot Studio avulla voit muodostaa yhteyden ja määrittää agentin Teamsia ja Microsoft 365:tä varten, jotta se on käytettävissä Microsoft Copilotissa.
• Lue ohjeet siitä, miten voit valita Microsoft Copilotin ja Copilot Studion välillä agenttisi luomiseen.

Yksi tapa luoda deklaratiivinen agentti mallipohjaiselle sovellukselle on ottaa Microsoft Copilot käyttöön suoraan sovelluksessa. Lisätietoja on kohdassa Ota sovelluksesi käyttöön Microsoft Copilotia varten.

Voit luoda oman sovelluskohtaisen agenttitilan Power Apps yhdistämällä oletusagentin Xrm.Copilot.* ohjelmointirajapintoihin. Oletusagentti määrittää käyttäjille avautuvan räätälöidyn Microsoft Copilot käyttökokemuksen, ja ohjelmointirajapinnat luovat kaksisuuntaisen yhteyden sovelluksesi ja Microsoft Copilot välille.

Määritä oletusagentti

Jos rakennat mukautetun agentin mallipohjaisen sovelluksesi kumppanina, voit määrittää sen oletusagentiksi, jolloin se latautuu automaattisesti, kun sovellus ja Microsoft Copilot sivuruutu avautuvat. Tämä tekee agentista käyttökokemuksen aloituskohdan, ja se on ensimmäinen osa oman agenttitilan rakentamista.

Kun määrität oletusagentin:

• Agentti valitaan ilman käyttäjän toimia.
• Käyttäjät käyttävät suoraan sovellukselle suunniteltua räätälöityä käyttökokemusta.
• Sovelluskohtaiset työnkulut ja ohjeet ovat valmiita heti, kun Microsoft Copilot avautuu.

Oletusagentti on erityisen hyödyllinen skenaarioihin keskittyville agenteille, jotka laajentavat sovelluksen ydinkokemusta ja toimivat etuovena sovelluskohtaiseen Microsoft Copilot -kokemukseen, jonka haluat käyttäjien saavan.

Xrm.Copilot-ohjelmointirajapinnat

Xrm.Copilot.*-asiakasohjelman ohjelmistorajapinnat antavat kehittäjien integroida Microsoft Copilotin suoraan mallipohjaisten sovellusten käyttökokemuksiin. Näiden ohjelmointirajapintojen avulla sovelluksesi voi olla suoraan vuorovaikutuksessa Microsoft Copilot -sivuruudun kanssa ja reagoida Microsoft Copilotin käynnistämiin toimintoihin. Näin voit luoda monipuolisempia, päästä päähän ulottuvia agenttipohjaisia skenaarioita.

Kun käytät näitä ohjelmointirajapintoja oletusagentin kanssa, ne täydentävät agenttitilan mallin. Agentti on aloituspiste, sovellus voi lähettää kehotteita ja kontekstia Microsoft Copilotille ja Microsoft Copilot voi käynnistää toimintoja sovelluksen sisällä.

Katso ohjelmointirajapinnan koko osa kohdasta Xrm.Copilot (asiakasohjelman ohjelmointirajapintaviittaus) mallipohjaisissa sovelluksissa.

Näiden ohjelmointirajapintojen avulla voit:

• Lähetä kehotteita Microsoft Copilotiin. Ota käyttöön sendPromptToM365Copilot, kun haluat aloittaa Microsoft Copilot -vuorovaikutuksen sovelluksessa.
• Avaa ja hallitse Microsoft Copilot -sivuruutua. Käytä openM365CopilotPanel varmistaaksesi, että Microsoft Copilot -ruutu näkyy tarvittaessa.
• Välitä sovelluskonteksti Microsoft Copilotille. Käytä updateContext (esikatselu) lähettääksesi ylimääräisiä maadoitussignaaleja sovelluksestasi.
• Agenttien kanssa työskentely. Käytä getCurrentAgent tätä, kun haluat tarkistaa, mikä agentti on aktiivinen.
• Käsittele Microsoft Copilot -toimintoja sovelluksessasi. Ota käyttöön addActionHandler, kun haluat rekisteröidä mukautettuja käsittelijöitä, jotka käsittelevät Microsoft Copilotin vastauksista lähetettyjä toimintoja.

Yhdessä nämä ohjelmointirajapinnat luovat todellisen kaksisuuntaisen kokemuksen sovelluksen käyttöliittymän ja agentin välille, jotta agentit voivat edistää käyttöliittymäpäivityksiä, käynnistää työnkulkuja tai suorittaa mukautetun liiketoimintalogiikan.

Microsoft Copilot toimintojen käsitteleminen addActionHandler-toiminnolla

Käytä addActionHandler APIa, kun sovelluksesi tarvitsee käsitellä jäsenneltyjä toimintoja, joita Microsoft Copilot tuottaa.

Kun luot toiminnon hyötykuorman:

• Määritä typePowerApps, jotta kohdennetaan Power Apps isäntä.
• Määritä action (esimerkiksi ) sille toimintotunnuksen, MyNamespace.MyMessagejonka rekisteröit kohteessa addActionHandler.
• Käytä actionData sille hyötykuormalle, jonka koodisi käsittelee ja välittää Power Apps -isännälle.

Seuraavissa osissa esitellään kaksi tuettua skenaariota.

Mukautuvat kortit

Microsoft Copilot -vastaukset voivat sisältää Mukautuvat kortit -kortteja, joissa on Action.Submit-painikkeita ja jotka lähettävät toimintoviestejä Power Apps -isännälle.

Esimerkki:

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

MCP-sovellukset

Microsoft Copilot vastaukset voivat sisältää HTML:n, joka lähettää toimintoviestejä Power Apps isännälle.

Esimerkki:

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

Rajoitukset

• Luomasi agentit eivät vielä voi käyttää sovelluksen sisäistä käyttäjäkontekstia vastaustensa räätälöintiin.
• Kun määrität oletusagenttia, aloituskehotetta agentilta ei näytetä.

Liittyvät tiedot

• Microsoft Copilotin lisääminen sovellusten käyttäjille mallipohjaisissa sovelluksissa
• Microsoft Copilot käyttäminen mallipohjaisissa sovelluksissa
• Microsoft Copilotin lisääminen sovellusten käyttäjille pohjaan perustuvissa sovelluksissa (esiversio)
• Käytä Microsoft Copilotia canvas-sovelluksissa (esikatselu)
• Microsoft Copilotin mukauttaminen agentin avulla pohjaan perustuvissa sovelluksissa