Microsoft 365 Copilot mukauttaminen agentin kanssa

Microsoft 365 Copilot Power Apps avulla käyttäjät voivat käyttää mukautettuja agentteja, jotka laajentavat Copilot mahdollista. Mukauttamalla agenttia voit luoda räätälöityjä kokemuksia, jotka sopivat organisaatiosi liiketoimintaprosesseihin ja tietoihin. Lisätietoja on artikkelissa Agenttien käyttö Microsoft 365 Copilot.

Tässä artikkelissa kuvataan agenttityyppejä, joita voit luoda Microsoft 365 Copilot varten Power Apps ja autetaan valitsemaan oikea lähestymistapa skenaarioosi.

Valitse agenttityyppi

Seuraavassa taulukossa verrataan agenttityyppejä, joita voit luoda.

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

• Yleiskatsaus ja ohjeet siihen, miten voit valita minkä tyyppisen agentin luotMicrosoft 365 Copilot agenteille yleiskatsauksessa.
• Luo deklaratiivinen agentti Microsoft 365 Copilotia varten tai mukautetun suoritusympäristön agentti Microsoft 365:lle.
• Microsoft Copilot Studio avulla voit muodostaa yhteyden Ja määrittää agentin Teamsiin ja Microsoft 365, jotta se on käytettävissä Microsoft 365 Copilot.
• Lue ohjeet siitä, miten voit valita agenttisi koostamisen Microsoft 365 Copilot ja Copilot Studio välillä.

Yksi tapa luoda määrittävä agentti mallipohjaiselle sovellukselle on ottaa Microsoft 365 Copilot käyttöön suoraan sovelluksessa. Lisätietoja on kohdassa Sovelluksen ottaminen käyttöön Microsoft 365 Copilot.

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 365 Copilot käyttökokemuksen, ja ohjelmointirajapinnat luovat kaksisuuntaisen yhteyden sovelluksesi ja Microsoft 365 Copilot välille.

Määritä oletusagentti

Jos luot mukautetun agentin mallipohjaisen sovelluksesi kumppanina, voit määrittää sen oletusagentiksi, jolloin se latautuu automaattisesti, kun sovellus ja Microsoft 365 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 365 Copilot avautuu.

Oletusagentti on erityisen hyödyllinen skenaarioihin keskittyville agenteille, jotka laajentavat sovelluksen ydinkokemusta ja toimivat etuovena sovelluskohtaiselle Microsoft 365 Copilot kokemukselle, joka haluat käyttäjillä olevan.

Xrm.Copilot-ohjelmointirajapinnat

Asiakassovellusten Xrm.Copilot.* ohjelmointirajapintojen avulla kehittäjät voivat integroida Microsoft 365 Copilot suoraan mallipohjaisiin sovelluskokemuksiin. Näiden ohjelmointirajapintojen avulla sovelluksesi voi käsitellä suoraan Microsoft 365 Copilot sivuruutua ja reagoida Microsoft 365 Copilot toimintoihin. Näin voit luoda monipuolisempia, päästä päähän -agentteja.

Yhdessä oletusagentin kanssa nämä ohjelmointirajapinnat täydentävät agenttitilan mallia: agenttisi on lähtökohtana, sovelluksesi voi lähettää kehotteita ja kontekstia Microsoft 365 Copilot ja Microsoft 365 Copilot voivat käynnistää toimintoja takaisin sovelluksesi sisällä.

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

Näiden ohjelmointirajapintojen avulla voit:

• Lähetä kehotteita Microsoft 365 Copilot. Tämän avulla sendPromptToM365Copilot voit aloittaa Microsoft 365 Copilot vuorovaikutuksen sovelluksestasi.
• Avaa sivuruutu Microsoft 365 Copilot ja hallitse sitä. :n avulla openM365CopilotPanel voit varmistaa, että Microsoft 365 Copilot-ruutu näkyy tarvittaessa.
• Siirrä sovelluskonteksti Microsoft 365 Copilot. 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 365 Copilot toiminnoista sovelluksessasi. Tämän avulla addActionHandler voit rekisteröidä mukautettuja käsittelijöitä, jotka käsittelevät Microsoft 365 Copilot 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 365 Copilot toimintojen käsitteleminen addActionHandler-toiminnolla

Käytä -ohjelmointirajapintaaaddActionHandler, kun sovelluksesi tarvitsee toimintoja, jotka Microsoft 365 Copilot lähettää.

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 365 Copilot vastaukset voivat sisältää Mukautuvat kortit ja painikkeitaAction.Submit, 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 365 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

• Lisää Microsoft 365 Copilot sovellusten käyttäjille mallipohjaisissa sovelluksissa
• Microsoft 365 Copilotin käyttäminen mallipohjaisissa sovelluksissa
• Lisää Microsoft 365 Copilot sovellusten käyttäjille pohjaan perustuvissa sovelluksissa (esikatselu)
• Käyttö Microsoft 365 Copilot pohjaan perustuvissa sovelluksissa (esikatselu)
• Microsoft 365 Copilot mukauttaminen agentin kanssa pohjaan perustuvissa sovelluksissa