Microsoft Copilot Studion agenttiluettelo

Copilot Studio agenttivarasto tarjoaa IT- ja tietoturva-järjestelmänvalvojille keskitetyn näkymän kaikista agenteista, jotka on luotu Copilot Studio tai vuokraajan Agent Builderin avulla. Varasto kattaa sekä julkaisemattomat (luonnosvaiheessa) että julkaistut agentit. Kullekin agentille varasto näyttää tärkeimmät metatiedot, kuten agentin luoneen, milloin se julkaistiin viimeksi, mihin kanaviin se on otettu käyttöön, miten se todentaa käyttäjät, sen ominaisuudet ja paljon muuta. Varastotiedot päivitetään automaattisesti, ja agentin muutokset näkyvät yleensä 20 minuutin kuluessa.

Järjestelmänvalvojat voivat käyttää varastotietoja useilla tavoilla, kuten Power Platform -hallintakeskuksessa, Power Platform -ohjelmointirajapinnassa ja Azure Resource Graph. Täydellinen luettelo käyttöoikeusmenetelmistä ja vaadituista rooleista on kohdassa Power Platform -luettelo.

Tässä artikkelissa kuvataan Copilot Studio -agentteja (microsoft.copilotstudio/agents) koskevat kentät Power Platform -varastossa. Katso kaikille resurssityypeille käytettävissä olevat jaetut kentät Power Platform -varastokaavio -artikkelista.

Note

Varasto ei sisällä agentteja, jotka on luotu Copilot Studio V1:llä (kutsutaan myös perinteisiksi boteiksi tai Power Virtual Agent -agenteiksi). Voit kuitenkin edelleen siirtyä Power Platform -hallintakeskukseen ja valita Manage>Copilot Studio>Classic chatbots nähdäksesi kyseiset agentit.

Tärkeää

Tämä artikkeli sisältää Microsoft Copilot Studion esiversiota koskevia ohjeita. Tiedot voivat muuttua.

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

Varasto sisältää seuraavat ominaisuudet kullekin agentille.

Note

  • Varasto kuvastaa kunkin agentin julkaistun version rakennetta. Jos agentilla on julkaisemattomia muutoksia (uudempi luonnos), varastossa ei näytetä näitä muutoksia ennen agentin julkaisemista.

  • Agentin määritykset vaikuttavat siihen, mitkä kentät täytetään. Jotkin ominaisuudet saattavat riippua null siitä, miten agentti on määritetty. Esimerkiksi isManaged on null agenteille, jotka on luotu Agent Builderissa.

Tärkeimmät ominaisuudet

Ohjelmointirajapinnan kenttäpolku Tietotyyppi Kuvaus Esimerkki Tila
properties.harness merkkijono Agentin valjaiden tyyppi. Lue lisää Harnesses in Copilot Studio. Standard Yleisesti saatavilla
properties.displayName merkkijono Agentin näyttönimi. Customer support agent Yleisesti saatavilla
properties.name GUID Agentin tunnus tietyssä Dataverse-ympäristössä (CDS-botin tunnus). aaaa0000-bb11-2222-33cc-444444dddddd Yleisesti saatavilla
properties.createdAt päivämäärä/aika Päivämäärä ja kellonaika, jolloin agentti luotiin. 2024-12-13T04:00:00Z Yleisesti saatavilla
properties.createdBy GUID Entra ID -tunnus agentin luoneesta käyttäjästä. aaaa0000-bb11-2222-33cc-444444dddddd Yleisesti saatavilla
properties.ownerId merkkijono Agentin nykyisen omistajan objektitunnus (Entra ID -tunnus). aaaa0000-bb11-2222-33cc-444444dddddd Yleisesti saatavilla
properties.environmentId merkkijono Resurssin sisältävän Power Platform -ympäristön tunnus. aaaa0000-bb11-2222-33cc-444444dddddd Yleisesti saatavilla
properties.lastPublishedAt päivämäärä/aika Päivämäärä ja kellonaika, jolloin agentti julkaistiin viimeksi. Tyhjä/null, jos agentti on vielä luonnostilassa. 2026-01-15T10:30:00Z Yleisesti saatavilla
properties.createdIn merkkijono Tekijätyökalu, jossa agentti luotiin: Copilot Studio tai Microsoft Copilot Agent Builder. Copilot Studio Yleisesti saatavilla
properties.schemaName merkkijono Dataverse-rakenteen nimi. Saatavilla Copilot Studio -agenteille ja Microsoft Copilot Agent Builder -agenteille. cr5e3_agentName Yleisesti saatavilla
properties.isQuarantined totuusarvo Onko agentti tällä hetkellä karanteenissa. false Esikatsele
properties.quarantinedAt päivämäärä/aika Päivämäärä ja aika, jolloin agentti on viimeksi asetettu karanteeniin. 2026-02-01T08:00:00Z Esikatsele
properties.isManaged totuusarvo Onko agentti osa hallittua Dataverse-ratkaisua. Tyhjäarvo Agent Builderissa luoduille agenteille. false Esikatsele

Entra-käyttäjätietojen ominaisuudet

Ohjelmointirajapinnan kenttäpolku Tietotyyppi Kuvaus Esimerkki Tila
properties.botId merkkijono CDS-bottitunnus ympäristössä. aaaa0000-bb11-2222-33cc-444444dddddd Yleisesti saatavilla
properties.entraAppId merkkijono Entra-sovelluksen rekisteröintitunnus, joka liittyy agenttiin, kun on olemassa. aaaa0000-bb11-2222-33cc-444444dddddd Yleisesti saatavilla
properties.entraAgentId merkkijono Entra agentin käyttäjätunnus, jos sellainen on aaaa0000-bb11-2222-33cc-444444dddddd Yleisesti saatavilla
properties.entraAgentBlueprintId merkkijono Entra Agent Blueprint ID, jos sellainen on olemassa. aaaa0000-bb11-2222-33cc-444444dddddd Yleisesti saatavilla

Note

Kaikki käyttäjätietojen ominaisuudet eivät ole käytettävissä kaikille agenttityypeille: entraAppId on vanha tunniste, uudet agentit käyttävät entraAgentId ja entraAgentBlueprintId. Nämä kentät täytetään vain, kun niitä sovelletaan kyseiseen agenttiin. Mikään näistä identiteettiominaisuuksista ei koske Microsoft Copilot Agent Builder -agentteja.

Lue lisää agenttien identiteettien ja todennuksen osalta Copilot Studio.

Määrityksen ominaisuudet

Ohjelmointirajapinnan kenttäpolku Tietotyyppi Kuvaus Esimerkki Tila
properties.orchestration merkkijono Agentin orkestrointitila (lisätietoja on orkestrointitiloissa). Generative Esikatsele
properties.model merkkijono Agentin käyttämä tekoälymalli. gpt-4o Esikatsele
properties.authentication merkkijono Agentille määritetty todentamistila (lisätietoja on todennustiloissa). Microsoft Entra Esikatsele
properties.channels matriisi Niiden kanavien näyttönimet, joissa agentti julkaistaan. ["Teams","SharePoint"] Esikatsele
properties.sharedWithViewers objekti Yksittäisten katselijakäyttäjien (userCount) ja katselijaryhmien (groupCount) määrä, joiden kanssa agentti on jaettu. Jos tekijä on jakanut agentin koko vuokraajan kanssa, entireTenant asetuksena trueon , vaikka järjestelmänvalvoja ei olisi hyväksynyt jakamista. "groupCount": 0, "userCount": 0, "entireTenant": false Esikatsele
properties.sharedWithEditors objekti Yksittäisten editorikäyttäjien (userCount) ja editoriryhmien (groupCount) määrä, joiden kanssa agentti on jaettu. "groupCount": 0, "userCount": 0 Esikatsele
properties.capabilitiesCounts objekti Kunkin määritetyn ominaisuustyypin erillisten kokonaismäärä "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Esikatsele

Orkestrointi-tilat

Kenttä properties.orchestration hyväksyy seuraavat arvot:

Arvo Kuvaus
Perinteinen Agentti käyttää perinteistä aihepohjaista orkestroinnia luotujen dialogien kanssa.
Generatiivinen Agentti käyttää generatiivista orkestrointia, jossa tekoälymalli valitsee aiheet ja työkalut dynaamisesti.

Todennustilat

Kenttä properties.authentication hyväksyy seuraavat arvot:

Arvo Kuvaus
Ei mitään Todentamista ei tarvita.
Microsoft Entra Todentaminen Microsoft Entra -tunnuksen kautta.
Geneerinen OAuth 2.0 Todentaminen yleisen OAuth 2.0 -palvelun kautta.

Agentin ominaisuudet

Tässä osiossa luetellaan agentin ominaisuudet (työkalut ja tiedot). Tällä hetkellä se näyttää vain yksityiskohtaisia tietoja agentin käyttämistä liittimistä ja tietojen määrityksestä seuraavissa osioissa kuvatulla tavalla.

Varastossa on enintään 200 resurssia kutakin agenttia kohden. Lue lisätietoja kohdasta Tunnetut rajoitukset.

Varasto poistaa automaattisesti resurssien kaksoiskappaleet, kuten Power Platform -liittimen, jonka määritit kahdesti agentissa, jolla on sama määritys.

Liittimen ominaisuudet

Varasto sisältää matriisin nimeltä powerPlatformConnectors, joka sisältää agentissa määritetyt Power Platform -liittimet. Jokainen liitin tunnistetaan sen connectorId mukaan (merkkijono, joka sisältää liittimen resurssitunnuksen, shared_excelonlinebusinessesimerkiksi ). Kullekin määritetylle liittimelle on määritetty operationsluettelo . Luettelo sisältää seuraavat ominaisuudet:

Property Tietotyyppi Kuvaus Tila
OperationId merkkijono Liittimen sisäisen toiminnon tunnus; esimerkiksi. AddRowV2 Esikatsele
createdBy GUID Toiminnon määrittänyt käyttäjä Esikatsele
isEnabled totuusarvo Onko liitintoiminto käytössä tällä hetkellä Esikatsele
usedAs merkkijono Toiminnon käyttötapa:
  • Tool jos määritetty yleiseksi työkaluksi
  • Topic Tool jos se on määritetty työkaluna tietyssä ohjeaiheessa
  • Knowledge jos liitin on määritetty tietolähteeksi
Esikatsele
requiresEndUserConsent totuusarvo Antaako loppukäyttäjä suostumuksensa, ennen kuin agentti voi käyttää toimintoa Esikatsele
whenCanBeUsed merkkijono Kun toiminto voidaan käynnistää:
  • Anytime jos työkalu on edustajan käytettävissä ilman rajoituksia
  • ViaDirectReferenceOnly jos agentti käyttää työkalua vain silloin, kun tekijä on eksplisiittisesti määrittänyt sen tietyissä aiheissa
  • Conditional jos agentti voi käyttää työkalua tekijän ennalta määrittämän logiikan mukaan
Esikatsele
connectionProvider merkkijono Kuka tarjoaa yhteyden toiminnolle:
  • User jos käyttäjä antaa tunnistetiedot suorituksen aikana
  • Maker jos tekijä määrittää yhteyden luontihetkellä
Esikatsele
connectionIdSharedByMaker GUID Yhteystunnus, joka täytetään vain, kun 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
    }
  }
}

Tieto-ominaisuudet

Varasto sisältää seuraavan tietämyksen ominaisuuden:

Property Tietotyyppi Kuvaus Tila
IsWebSearchEnabledForKnowledge totuusarvo True, jos agentti voi käyttää verkkohakua tietolähteenä Esikatsele

Tunnetut rajoitukset

  • V1-agentteja ei seurata – varasto ei sisällä agentteja, jotka on luotu alkuperäisellä Power Virtual Agent V1 -suorituspalvelulla. 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 agentintunnuksen käyttäjätietomallissa. Vanhemmilla agenteilla saattaa olla vain entraAppId, ja Microsoft Copilot Agent Builder -agenteilla ei ole mitään näistä identiteettiominaisuuksista.
  • Toimintojen määrä – Varastossa on enintään 200 resurssia kussakin agenttityypissä. Jos agentilla on yli 200 määritettyä resurssia tietystä tyypistä (esimerkiksi Power Platform -yhdistimet), varasto näyttää satunnaisen 200. Järjestelmänvalvojat voivat -kentän avulla capabilitiesCounts ymmärtää, kuinka monta resurssia agentissa on määritetty kullekin tyypille.