Microsoft Copilot Studio
Microsoft Copilot Studio gebruikt voor het detecteren en activeren van agents
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Standaard | Alle Power Automate regio's behalve: - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Apps | Standaard | Alle Power Apps regio's behalve: - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Standaard | Alle Power Automate regio's behalve: - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | Microsoft Copilot Studio |
| URL | https://aka.ms/copilotstudio |
| E-mailen | donglei@microsoft.com |
| Connectormetagegevens | |
|---|---|
| Uitgever | Microsoft |
| Webpagina | https://aka.ms/copilotstudio |
| Privacybeleid | https://www.microsoft.com/en-us/privacy/privacystatement |
| Categorieën | AI |
Algemene limieten
| Naam | Waarde |
|---|---|
| Verbindingen per account | 50 |
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| standaard | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 300 | 60 seconden |
Acties
| Agent evalueren |
Evalueert een agent met behulp van een specifieke testset. |
| Agent uitvoeren |
Hiermee wordt een prompt verzonden naar de opgegeven agent voor verwerking |
| Agent uitvoeren en wachten |
Hiermee wordt een prompt verzonden naar de opgegeven agent voor verwerking en wacht om te worden hervat |
| Agenttestsets ophalen |
Hiermee haalt u de testsets voor een agent op. |
| Agenttestuitvoeringen ophalen |
Hiermee haalt u testuitvoeringen voor de makerevaluatie op voor de opgegeven agent. |
| Details van agenttestset ophalen |
Hiermee haalt u de details van een specifieke testset voor de maker-evaluatie op. |
| Details van agenttestuitvoering ophalen |
Hiermee haalt u de details van een specifieke testuitvoering voor de maker-evaluatie op. |
Agent evalueren
Evalueert een agent met behulp van een specifieke testset.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Vertegenwoordiger
|
Agent | True | string |
selecteer een agent in de vervolgkeuzelijst of voer een aangepaste waarde in (de agent-id). |
|
Testset
|
TestSetId | True | string |
Selecteer een testset in de vervolgkeuzelijst of voer een aangepaste waarde in (de testset-id). |
|
MCS-verbindings-id
|
mcsConnectionId | string |
Selecteer Gebruikersprofiel - Voer de MCS-verbindings-id in of laat deze leeg voor anonieme uitvoering. |
|
|
Naam van evaluatieuitvoering
|
evaluationRunName | string |
Voer een naam in voor de evaluatieuitvoering of laat deze leeg. |
Agent uitvoeren
Hiermee wordt een prompt verzonden naar de opgegeven agent voor verwerking
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Vertegenwoordiger
|
Copilot | True | string |
Vertegenwoordiger |
|
message
|
message | string |
Message |
|
|
Een BCP-47-landinstellingsnaam voor de inhoud van het tekstveld.
|
locale | string |
Een BCP-47-landinstellingsnaam voor de inhoud van het tekstveld. |
|
|
inhoudstype
|
contentType | string | ||
|
contentUrl
|
contentUrl | string | ||
|
inhoud
|
content | object | ||
|
naam
|
name | string | ||
|
thumbnailUrl
|
thumbnailUrl | string | ||
|
Gespreks-id
|
x-ms-conversation-id | string |
Geef een bestaande gespreks-id op om de uitvoering van de agent te hervatten. |
|
|
Omgevings-id
|
environmentId | string |
Optionele omgevings-id |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
ConversationId
|
ConversationId | string |
De gespreks-id die is gekoppeld aan het antwoord |
Agent uitvoeren en wachten
Hiermee wordt een prompt verzonden naar de opgegeven agent voor verwerking en wacht om te worden hervat
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Vertegenwoordiger
|
Copilot | True | string |
Vertegenwoordiger |
|
Message
|
message | string |
Message |
|
|
Een BCP-47-landinstellingsnaam voor de inhoud van het tekstveld.
|
locale | string |
Een BCP-47-landinstellingsnaam voor de inhoud van het tekstveld. |
|
|
inhoudstype
|
contentType | string | ||
|
contentUrl
|
contentUrl | string | ||
|
inhoud
|
content | object | ||
|
naam
|
name | string | ||
|
thumbnailUrl
|
thumbnailUrl | string | ||
|
Gespreks-id
|
x-ms-conversation-id | string |
Geef een bestaande gespreks-id op om de uitvoering van de agent te hervatten. |
|
|
Omgevings-id
|
environmentId | string |
Optionele omgevings-id |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
lastResponse
|
lastResponse | string |
Het laatste tekstantwoord in de lijst met activiteiten |
|
Reacties
|
responses | array of string |
De lijst met tekenreeksantwoorden in de lijst met activiteiten |
|
conversationId
|
conversationId | string |
De gespreks-id die is gekoppeld aan het antwoord |
Agenttestsets ophalen
Hiermee haalt u de testsets voor een agent op.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Vertegenwoordiger
|
Agent | True | string |
selecteer een agent in de vervolgkeuzelijst of voer een aangepaste waarde in (de agent-id). |
Retouren
- Body
- TestSetsResponse
Agenttestuitvoeringen ophalen
Hiermee haalt u testuitvoeringen voor de makerevaluatie op voor de opgegeven agent.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Vertegenwoordiger
|
Agent | True | string |
selecteer een agent in de vervolgkeuzelijst of voer een aangepaste waarde in (de agent-id). |
Retouren
- Body
- TestRunsResponse
Details van agenttestset ophalen
Hiermee haalt u de details van een specifieke testset voor de maker-evaluatie op.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Vertegenwoordiger
|
Agent | True | string |
selecteer een agent in de vervolgkeuzelijst of voer een aangepaste waarde in (de agent-id). |
|
Testset
|
TestSetId | True | string |
Selecteer een testset in de vervolgkeuzelijst of voer een aangepaste waarde in (de testset-id). |
Retouren
- Body
- TestSet
Details van agenttestuitvoering ophalen
Hiermee haalt u de details van een specifieke testuitvoering voor de maker-evaluatie op.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Vertegenwoordiger
|
Agent | True | string |
selecteer een agent in de vervolgkeuzelijst of voer een aangepaste waarde in (de agent-id). |
|
Evaluatieuitvoering
|
EvaluationRunId | True | string |
Selecteer evaluatieuitvoering in de vervolgkeuzelijst of voer een aangepaste waarde in (de id van de evaluatieuitvoering). |
Retouren
- Body
- TestRun
Definities
TestSetsResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
value
|
value | array of TestSet |
TestSet
| Name | Pad | Type | Description |
|---|---|---|---|
|
identiteitskaart
|
id | string | |
|
displayName
|
displayName | string | |
|
totalTestCases
|
totalTestCases | integer | |
|
beschrijving
|
description | string | |
|
auditInfo
|
auditInfo | AuditInfo | |
|
state
|
state | string |
AuditInfo
| Name | Pad | Type | Description |
|---|---|---|---|
|
gemaakt door
|
createdBy | string | |
|
aangemaaktTimeUtc
|
createdTimeUtc | date-time | |
|
modifiedBy
|
modifiedBy | string | |
|
modifiedTimeUtc
|
modifiedTimeUtc | date-time |
TestRunsResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
value
|
value | array of TestRun |
TestRun
| Name | Pad | Type | Description |
|---|---|---|---|
|
identiteitskaart
|
id | string | |
|
environmentId
|
environmentId | string | |
|
cdsBotId
|
cdsBotId | string | |
|
ownerId
|
ownerId | string | |
|
testSetId
|
testSetId | string | |
|
state
|
state | string | |
|
startTime
|
startTime | date-time | |
|
endTime
|
endTime | date-time | |
|
naam
|
name | string | |
|
totalTestCases
|
totalTestCases | integer | |
|
msConnectionId
|
msConnectionId | string |