Microsoft Copilot Studion agenttien varasto

Copilot Studion agenttien varasto antaa IT- ja tietoturvajärjestelmänvalvojille keskitetyn näkymän vuokraajan kaikkiin Copilot Studiossa tai agentin muodostintyökalussa luotuihin agentteihin. Varasto sisältää sekä julkaisemattomat (luonnos) että julkaistut agentit. Varasto näyttää kunkin agentin osalta keskeiset metatiedot, kuten agentin tekijän, viimeisimmän julkaisuajankohdan, kanavat, jossa on otettu käyttöön, käyttäjien todennustavan, agentin ominaisuudet ja paljon muuta. Varaston tiedot päivitetään automaattisesti, ja agenttiin tehdyt muutokset näkyvät tavallisesti 20 minuutin sisällä.

Järjestelmänvalvojat voivat hyödyntää varaston tietoja eri tavoin, mukaan lukien Power Platform -hallintakeskus, Power Platform API ja Azure Resource Graph. Käyttömenetelmien ja vaadittujen roolien täydellinen luettelo on kohdassa Power Platform -varasto.

Tässä artikkelissa käsitellään Copilot Studio -agenteille (microsoft.copilotstudio/agents) ominaisia kenttiä Power Platform -varastossa. Lisätietoja kaikkien resurssityyppien käytettävissä olevista yhteisistä kentistä on kohdassa Power Platform -varaston rakenneviite.

Muistiinpano

Varasto ei sisällä agentteja, jotka on luotu Copilot Studion V1-versiolla (tunnetaan myös nimillä perinteiset botit tai Power Virtual Agents). Voit kuitenkin nähdä kyseiset agentit siirtymällä Power Platform -hallintakeskukseen ja valitsemalla Hallinta>Copilot Studio>Perinteiset keskustelubotit.

Tärkeää

Tämä artikkeli sisältää Microsoft Copilot Studion esiversiota koskevia ohjeita. Artikkeliin saatetaan tehdä muutoksia.

Esiversiotoimintoja ei ole tarkoitettu tuotantokäyttöön, ja niiden toiminnot voivat olla rajoitettuja. Nämä toiminnot ovat käytettävissä ennen virallista julkaisua, jotta voit käyttää niitä aikaisessa vaiheessa ja antaa palautetta.

Jos olet luomassa tuotantovalmista agenttia, katso lisätietoja kohdasta Microsoft Copilot Studion yleiskuvaus.

Agentin ominaisuudet

Varaston kullakin agentilla on seuraavat ominaisuudet.

Muistiinpano

  • Varasto vastaa kunkin agentin julkaistun version rakennetta. Jos agentilla on julkaisemattomia muutoksia (uusi luonnos), nämä muutokset näkyvät varastossa vasta, kun agentti on julkaistu.

  • Agentin määritys vaikuttaa siihen, mitkä kentät täytetään. Joiden ominaisuuksien arvo voi olla null sen mukaan, miten agentti on määritetty. Esimerkiksi isManaged on null, jos agentti on luotu agentin muodostintyökalussa.

Perusominaisuudet

Ohjelmointirajapinnan kentän polku Tietotyyppi Description Esimerkki Tila
properties.displayName Merkkijono Agentin näyttönimi. Customer support agent Yleinen saatavuus
properties.name GUID Agentin tunnus tietyssä Dataverse-ympäristössä (CDS-bottitunnus). aaaa0000-bb11-2222-33cc-444444dddddd Yleinen saatavuus
properties.createdAt datetime Agentin luontipäivä ja -aika. 2024-12-13T04:00:00Z Yleinen saatavuus
properties.createdBy GUID Agentin luoneen käyttäjän Entra ID -tunnus. aaaa0000-bb11-2222-33cc-444444dddddd Yleinen saatavuus
properties.ownerId Merkkijono Agentin nykyisen omistajan objektitunnus (Entra ID -tunnus). aaaa0000-bb11-2222-33cc-444444dddddd Yleinen saatavuus
properties.environmentId Merkkijono Resurssin sisältävän Power Platform -ympäristön tunniste. aaaa0000-bb11-2222-33cc-444444dddddd Yleinen saatavuus
properties.lastPublishedAt datetime Agentin viimeisin julkaisupäivä ja -aika. Tyhjä/tyhjäarvo, jos agentti on vielä luonnostilassa. 2026-01-15T10:30:00Z Yleinen saatavuus
properties.createdIn Merkkijono Luontityökalu, jolla agentti luotiin: Copilot Studio tai Microsoft 365 Copilot -agentin muodostintyökalu. Copilot Studio Yleinen saatavuus
properties.schemaName Merkkijono Dataverse-rakenteen nimi. Copilot Studio -agenttien ja Microsoft 365 Copilot -agentin muodostintyökalun agenttien käytettävissä. cr5e3_agentName Yleinen saatavuus
properties.isQuarantined totuusarvo Onko agentti tällä hetkellä karanteenissa. false Esikatsele
properties.quarantinedAt datetime Agentin viimeisin karanteenipäivä ja -aika. 2026-02-01T08:00:00Z Esikatsele
properties.isManaged totuusarvo Onko agentti Dataverse-ratkaisun osa. Tyhjäarvo, jos agentti luotiin agentin muodostintyökalussa. false Esikatsele

Entran käyttäjätieto-ominaisuudet

Ohjelmointirajapinnan kentän polku Tietotyyppi Description Esimerkki Tila
properties.botId Merkkijono Ympäristön CDS-botin tunnus. aaaa0000-bb11-2222-33cc-444444dddddd Yleinen saatavuus
properties.entraAppId Merkkijono Agenttiin liitetty Entra-sovellusrekisteröinnin tunnus, jos sellainen on. aaaa0000-bb11-2222-33cc-444444dddddd Yleinen saatavuus
properties.entraAgentId Merkkijono Entran agentin käyttäjätietotunnus, jos sellainen on aaaa0000-bb11-2222-33cc-444444dddddd Yleinen saatavuus
properties.entraAgentBlueprintId Merkkijono Entran agentin etenemissuunnitelman tunnus, jos sellainen on aaaa0000-bb11-2222-33cc-444444dddddd Yleinen saatavuus

Muistiinpano

Kaikki käyttäjätieto-ominaisuudet eivät ole kaikkien agenttityyppien käytettävissä: entraAppId on vanha tunniste, uusien agenttien käytössä on entraAgentId ja entraAgentBlueprintId. Nämä kentät täytetään vain, kun ne koskevat tiettyä agenttia. Mikään näistä käyttäjätieto-ominaisuuksista ei koske Microsoft 365 Copilotin agentin muodostintyökalun agentteja.

Lisätietoja Entran käyttäjätietokäsitteistä on kohdassa Sovelluksen rekisteröinti, agentin käyttäjätiedot ja todennus Copilot Studiossa.

Määrityksen ominaisuudet

Ohjelmointirajapinnan kentän polku Tietotyyppi Description Esimerkki Tila
properties.orchestration Merkkijono Agentin orkestrointitila (lisätietoja on kohdassa Orkestrointitilat). Generative Esikatsele
properties.model Merkkijono Agentin käyttämä tekoälymalli. gpt-4o Esikatsele
properties.authentication Merkkijono Agentille määritetty todennustila (lisätietoja on kohdassa Todennustilat). Microsoft Entra Esikatsele
properties.channels matriisi Niiden kanavien näyttönimet, joissa agentti julkaistaan. ["Teams","SharePoint"] Esiversio
properties.sharedWithViewers objekti Niiden yksittäisten katselijakäyttäjien (userCount) ja katselijaryhmien (groupCount) määrä, joiden kanssa agentti jaetaan. Jos tekijä jakoi agentin koko vuokraajaan, entireTenant-määrityksenä on true, vaikka järjestelmänvalvoja ei olisi hyväksynyt jakamista. "groupCount": 0, "userCount": 0, "entireTenant": false Esikatsele
properties.sharedWithEditors objekti Niiden yksittäisten muokkaajakäyttäjien (userCount) ja muokkaajaryhmien (groupCount) määrä, joiden kanssa agentti jaettiin. "groupCount": 0, "userCount": 0 Esikatsele
properties.capabilitiesCounts objekti Kunkin määritetyn ominaisuustyypin erillisten kokonaismäärä "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Esikatsele

Orkestrointitilat

properties.orchestration-kenttä hyväksyy seuraavat arvot:

Arvo Description
Perinteinen Agentti käyttää perinteistä aihepohjaista orkestrointia ja laadittuja dialogipuita.
Generatiivinen Agentti käyttää generatiivista orkestrointia, jossa tekoälymalli valitsee aiheet ja toiminnot dynaamisesti.

Todennustilat

properties.authentication-kenttä hyväksyy seuraavat arvot:

Arvo Description
Ei ole Todennusta ei tarvita.
Microsoft Entra Todennus Microsoft Entra ID:n kautta.
Yleinen OAuth 2.0 Todennus yleisen OAuth 2.0 -palvelun kautta.

Agentin ominaisuudet

Tässä osiossa käsitellään agentin ominaisuuksia (työkalut ja tietämys). Tällä hetkellä se näyttää vain agentin käyttämien yhdistimen eritellyt tiedot ja tietämysmäärityksen seuraavissa osioissa selitetyin tavoin.

Varastossa kunkin tyypin agenttikohtainen resurssien enimmäismäärä on 200. Lisätietoja on kohdassa Tunnetut rajoitukset.

Varasto poistaa automaattisesti resurssien kaksoiskappaleet, kuten agentin samassa määrityksessä kahdesti määritetyn Power Platform -yhdistimen.

Yhdistimen ominaisuudet

Varastossa on powerPlatformConnectors-niminen matriisi, joka sisältää agentissa määritetyt Power Platform -yhdistimet. Kunkin yhdistimen tunnistimena on sen connectorId (yhdistimen resurssitunnuksen sisältävä merkkijono, kuten shared_excelonlinebusiness). Kullakin määritetyllä yhdistelmällä on luettelo määritetyistä operations-ominaisuuksista. Luettelo sisältää seuraavat ominaisuudet:

Ominaisuus Tietotyyppi Description Status
OperationId Merkkijono Yhdistimen tietyn toiminnon tunnus, kuten AddRowV2 Esikatsele
createdBy GUID Toiminnon määrittänyt käyttäjä Esikatsele
isEnabled totuusarvo Onko yhdistintoiminto otettu tällä hetkellä käyttöön Esikatsele
usedAs Merkkijono Toiminnon käyttötapa:
  • Tool jos määritetty yleiseksi työkaluksi
  • Topic Tool jos määritetty työkaluksi tietyssä aiheessa
  • Knowledge jos yhdistin on määritetty tietolähteeksi
 Esikatsele
requiresEndUserConsent totuusarvo Onko loppukäyttäjien suostuttava, ennen kuin agentti voi käyttää toimintoa Esikatsele
whenCanBeUsed Merkkijono Milloin toiminto voidaan käynnistää:
  • Anytime jos työkalu on agentin käytettävissä ilman rajoituksia
  • ViaDirectReferenceOnly jos agentti käyttää työkalua vain, kun tekijä on nimenomaisesti määrittänyt sen tietyissä aiheissa
  • Conditional jos agentti voi käyttää työkalua tekijän ennalta määrittämän logiikan mukaisesti
 Esikatsele
connectionProvider Merkkijono Toiminnon yhteyden muodostaja:
  • User jos loppukäyttäjä antaa tunnistetiedot suorituspalvelussa
  • Maker jos tekijä määrittää yhteyden luontivaiheessa
 Esikatsele
connectionIdSharedByMaker GUID Yhteystunnus, täytetään ainoastaan jos connectionProvider = Maker Esikatsele
Esimerkki
{
  "type": "microsoft.copilotstudio/agents",
  "properties": {
    "displayName": "Customer Support Agent",
    "createdIn": "Copilot Studio",
    "powerPlatformConnectors": [
      {
        "connectorId": "shared_excelonlinebusiness",
        "operations": [
          {
            "operationId": "RunScriptProd",
            "usedAs": "Tool",
            "isEnabled": true,
            "requiresEndUserConsent": false,
            "whenCanBeUsed": "ViaDirectReferenceOnly",
            "connectionProvider": "Maker",
            "connectionIdSharedByMaker": "11112222-3333-4444-5555-666677778888",
            "createdBy": "52bff06b-5db5-42cd-9919-28f95e3c07af"
          }
        ]
      }
    ],
    "capabilitiesCounts": {
      "distinctPowerPlatformConnectors": 2,
      "distinctPowerPlatformConnectorsOperations": 3
    }
  }
}

Tietämysominaisuudet

Varasto sisältää seuraavan tietämysominaisuuden:

Ominaisuus Tietotyyppi Description Status
IsWebSearchEnabledForKnowledge totuusarvo Tosi, jos agentti voi käyttää verkkohakua tietolähteenä Esikatsele

Tunnetut rajoitukset

  • V1-agentteja ei seurata – Varasto ei sisällä agentteja, jotka on luotu alkuperäisessä Power Virtual Agents V1 -suorituspalvelussa. Se seuraa vain V2 (Copilot Studio) -agentteja.
  • Käyttäjätieto-ominaisuudet eivät välttämättä ole kaikkien agenttien käytettävissä – entraAgentId- ja entraAgentBlueprintId-täytetään vain, jos agentit valmisteltiin Entran uudessa agentin käyttäjätietomallissa. Vanhoissa agenteissa saattaa olla vain entraAppId, eikä Microsoft 365 Copilotin agentin muodostintyökalun agenteilla ole mitään näistä käyttäjätieto-ominaisuuksista.
  • Ominaisuuksien määrä – Varastossa kunkin tyypin agenttikohtainen resurssien enimmäismäärä on 200. Jos agentilla on yli 200 määritettyä tietyn tyypin resurssia (kuten Power Platform -yhdistimiä), varastossa näkyy satunnaisesti valitut 200 yhdistintä. Järjestelmänvalvojat voivat ymmärtää capabilitiesCounts-kentän avulla, kuinka monta resurssia agentille on tyyppikohtaisesti määritetty.

Liittyvä sisältö

  • Last updated on