Muistiinpano
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoa.
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoa.
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
nullsiitä, miten agentti on määritetty. EsimerkiksiisManagedonnullagenteille, 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:
|
Esiversio |
requiresEndUserConsent |
totuusarvo | Antaako loppukäyttäjä suostumuksensa, ennen kuin agentti voi käyttää toimintoa | Esiversio |
whenCanBeUsed |
merkkijono | Kun toiminto voidaan käynnistää:
|
Esiversio |
connectionProvider |
merkkijono | Kuka tarjoaa yhteyden toiminnolle:
|
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 vainentraAppId, 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
capabilitiesCountsymmärtää, kuinka monta resurssia agentissa on määritetty kullekin tyypille.