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.

Huomautus

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.

Huomautus

  • 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 Description Esimerkki Tila
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 Luontityökalu, johon agentti luotiin: Copilot Studio tai Microsoft 365 Copilot Agent Builder. Copilot Studio Yleisesti saatavilla
properties.schemaName merkkijono Dataverse-rakenteen nimi. Saatavilla Copilot Studio -agenteille ja Microsoft 365 Copilot Agent Builder -agenteille. cr5e3_agentName Yleisesti saatavilla
properties.isQuarantined totuusarvo Onko agentti tällä hetkellä karanteenissa. false Esiversio
properties.quarantinedAt päivämäärä/aika Päivämäärä ja aika, jolloin agentti on viimeksi asetettu karanteeniin. 2026-02-01T08:00:00Z Esiversio
properties.isManaged totuusarvo Onko agentti osa hallittua Dataverse-ratkaisua. Tyhjäarvo Agent Builderissa luoduille agenteille. false Esiversio

Entra-käyttäjätietojen ominaisuudet

Ohjelmointirajapinnan kenttäpolku Tietotyyppi Description 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 Agent Identity ID, kun on olemassa. 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

Huomautus

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ä käyttäjätietojen ominaisuuksista ei koske Microsoft 365 Copilot Agent Builder -agentteja.

Lisätietoja Entra-käyttäjätietojen käsitteistä on artikkelissa App-rekisteröinti, agentin käyttäjätiedot ja Copilot Studio todentaminen.

Määrityksen ominaisuudet

Ohjelmointirajapinnan kenttäpolku Tietotyyppi Description Esimerkki Tila
properties.orchestration merkkijono Agentin orkestrointitila (lisätietoja on orkestrointitiloissa). Generative Esiversio
properties.model merkkijono Agentin käyttämä tekoälymalli. gpt-4o Esiversio
properties.authentication merkkijono Agentille määritetty todentamistila (lisätietoja on todennustiloissa). Microsoft Entra Esiversio
properties.channels matriisi Niiden kanavien näyttönimet, joissa agentti julkaistaan. ["Teams","SharePoint"] Esiversio
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 Esiversio
properties.sharedWithEditors objekti Yksittäisten editorikäyttäjien (userCount) ja editoriryhmien (groupCount) määrä, joiden kanssa agentti on jaettu. "groupCount": 0, "userCount": 0 Esiversio
properties.capabilitiesCounts objekti Kunkin määritetyn ominaisuustyypin erillisten kokonaismäärä "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Esiversio

Orkestrointi-tilat

Kenttä properties.orchestration hyväksyy seuraavat arvot:

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

Todennustilat

Kenttä properties.authentication hyväksyy seuraavat arvot:

Arvo Description
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:

Ominaisuus Tietotyyppi Description Tila
OperationId merkkijono Liittimen sisäisen toiminnon tunnus; esimerkiksi. AddRowV2 Esiversio
createdBy GUID Toiminnon määrittänyt käyttäjä Esiversio
isEnabled totuusarvo Onko liitintoiminto käytössä tällä hetkellä Esiversio
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
Esiversio
requiresEndUserConsent totuusarvo Antaako loppukäyttäjä suostumuksensa, ennen kuin agentti voi käyttää toimintoa Esiversio
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
Esiversio
connectionProvider merkkijono Kuka tarjoaa yhteyden toiminnolle:
  • User jos käyttäjä antaa tunnistetiedot suorituksen aikana
  • Maker jos tekijä määrittää yhteyden luontihetkellä
Esiversio
connectionIdSharedByMaker GUID Yhteystunnus, joka täytetään vain, kun connectionProvider = Maker Esiversio
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:

Ominaisuus Tietotyyppi Description Tila
IsWebSearchEnabledForKnowledge totuusarvo True, jos agentti voi käyttää verkkohakua tietolähteenä Esiversio

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ätietojen ominaisuudet eivät ehkä ole käytettävissä kaikille agenteille: - - ja entraAgentId -entraAgentBlueprintIdkentät täytetään vain agenteille, jotka on valmistelty uudemman Entra-agentin käyttäjätietomallin avulla. Vanhemmilla agenteilla voi olla vain entraAppId, eikä Microsoft 365 Copilot Agent Builder -agenteilla ole mitään näistä käyttäjätietojen ominaisuuksista.
  • 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.