Microsoft Copilot Studio
Microsoft Copilot Studio utilisé pour découvrir et déclencher des agents
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Norme | Toutes les régions Power Automate à l’exception des éléments suivants : - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Apps | Norme | Toutes les régions Power Apps à l’exception des éléments suivants : - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Norme | Toutes les régions Power Automate à l’exception des éléments suivants : - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Microsoft Copilot Studio |
| URL | https://aka.ms/copilotstudio |
| Messagerie électronique | donglei@microsoft.com |
| Métadonnées du connecteur | |
|---|---|
| Publisher | Microsoft |
| Site web | https://aka.ms/copilotstudio |
| Politique de confidentialité | https://www.microsoft.com/en-us/privacy/privacystatement |
| Catégories | AI |
Limites générales
| Nom | Valeur |
|---|---|
| Connexions par compte | 50 |
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Oauth | Connectez-vous à l’aide de Microsoft Entra ID à l’API Power Platform. | Toutes les régions | Non partageable |
| Valeur par défaut [DÉCONSEILLÉE] | Cette option concerne uniquement les connexions plus anciennes sans type d’authentification explicite et est fournie uniquement pour la compatibilité descendante. | Toutes les régions | Non partageable |
Oauth
ID d’authentification : oauthDefault
Applicable : Toutes les régions
Connectez-vous à l’aide de Microsoft Entra ID à l’API Power Platform.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
Valeur par défaut [DÉCONSEILLÉE]
Applicable : Toutes les régions
Cette option concerne uniquement les connexions plus anciennes sans type d’authentification explicite et est fournie uniquement pour la compatibilité descendante.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 300 | 60 secondes |
Actions
| Exécuter l’agent |
Envoie une invite à l’Agent spécifié pour le traitement |
| Exécuter l’agent et attendre |
Envoie une invite à l’Agent spécifié pour le traitement et attendez de reprendre |
| Obtenir des jeux de tests d’agent |
Obtient les jeux de tests d’un agent. |
| Obtenir les détails de l’exécution des tests de l’agent |
Obtient les détails d’une exécution de test d’évaluation de créateur spécifique. |
| Obtenir les détails du jeu de tests de l’agent |
Obtient les détails d’un jeu de test d’évaluation de créateur spécifique. |
| Obtenir les exécutions de test de l’agent |
Obtient les exécutions de test d’évaluation du créateur pour l’agent spécifié. |
| Évaluer l’agent |
Évalue un agent à l’aide d’un jeu de tests spécifique. |
Exécuter l’agent
Envoie une invite à l’Agent spécifié pour le traitement
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Agent
|
Copilot | True | string |
Agent |
|
Message
|
message | True | string |
Message |
|
Nom des paramètres régionaux BCP-47 pour le contenu du champ de texte.
|
locale | string |
Nom des paramètres régionaux BCP-47 pour le contenu du champ de texte. |
|
|
type de contenu
|
contentType | string | ||
|
contentUrl
|
contentUrl | string | ||
|
contenu
|
content | object | ||
|
nom
|
name | string | ||
|
URL de la vignette
|
thumbnailUrl | string | ||
|
ID de conversation
|
x-ms-conversation-id | string |
Fournissez l’ID de conversation exisiting pour reprendre l’exécution de l’agent. |
|
|
ID environnement
|
environmentId | string |
ID d’environnement facultatif |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ConversationId
|
ConversationId | string |
ID de conversation associé à la réponse |
Exécuter l’agent et attendre
Envoie une invite à l’Agent spécifié pour le traitement et attendez de reprendre
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Agent
|
Copilot | True | string |
Agent |
|
Message
|
message | string |
Message |
|
|
Nom des paramètres régionaux BCP-47 pour le contenu du champ de texte.
|
locale | string |
Nom des paramètres régionaux BCP-47 pour le contenu du champ de texte. |
|
|
type de contenu
|
contentType | string | ||
|
contentUrl
|
contentUrl | string | ||
|
contenu
|
content | object | ||
|
nom
|
name | string | ||
|
URL de la vignette
|
thumbnailUrl | string | ||
|
ID de conversation
|
x-ms-conversation-id | string |
Fournissez l’ID de conversation exisiting pour reprendre l’exécution de l’agent. |
|
|
ID environnement
|
environmentId | string |
ID d’environnement facultatif |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
lastResponse
|
lastResponse | string |
Dernière réponse de texte dans la liste des activités |
|
réponses
|
responses | array of string |
Liste des réponses de chaîne dans la liste des activités |
|
ID de conversation
|
conversationId | string |
ID de conversation associé à la réponse |
Obtenir des jeux de tests d’agent
Obtient les jeux de tests d’un agent.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Agent
|
Agent | True | string |
sélectionnez un agent dans la liste déroulante ou entrez une valeur personnalisée (l’ID de l’agent). |
Retours
- Corps
- TestSetsResponse
Obtenir les détails de l’exécution des tests de l’agent
Obtient les détails d’une exécution de test d’évaluation de créateur spécifique.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Agent
|
Agent | True | string |
sélectionnez un agent dans la liste déroulante ou entrez une valeur personnalisée (l’ID de l’agent). |
|
Exécution de l’évaluation
|
EvaluationRunId | True | string |
Sélectionnez l’exécution d’évaluation dans la liste déroulante ou entrez une valeur personnalisée (ID d’exécution d’évaluation). |
Retours
- Corps
- TestRun
Obtenir les détails du jeu de tests de l’agent
Obtient les détails d’un jeu de test d’évaluation de créateur spécifique.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Agent
|
Agent | True | string |
sélectionnez un agent dans la liste déroulante ou entrez une valeur personnalisée (l’ID de l’agent). |
|
Jeu de tests
|
TestSetId | True | string |
Sélectionnez un jeu de tests dans la liste déroulante ou entrez une valeur personnalisée (ID du jeu de tests). |
Retours
- Corps
- TestSet
Obtenir les exécutions de test de l’agent
Obtient les exécutions de test d’évaluation du créateur pour l’agent spécifié.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Agent
|
Agent | True | string |
sélectionnez un agent dans la liste déroulante ou entrez une valeur personnalisée (l’ID de l’agent). |
Retours
- Corps
- TestRunsResponse
Évaluer l’agent
Évalue un agent à l’aide d’un jeu de tests spécifique.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Agent
|
Agent | True | string |
sélectionnez un agent dans la liste déroulante ou entrez une valeur personnalisée (l’ID de l’agent). |
|
Jeu de tests
|
TestSetId | True | string |
Sélectionnez un jeu de tests dans la liste déroulante ou entrez une valeur personnalisée (ID du jeu de tests). |
|
ID de connexion MCS
|
mcsConnectionId | string |
Sélectionnez Profil utilisateur : entrez l’ID de connexion MCS ou laissez vide pour l’exécution anonyme. |
|
|
Nom de l’exécution d’évaluation
|
evaluationRunName | string |
Entrez un nom pour l’exécution de l’évaluation ou laissez vide. |
Retours
- Corps
- RunStatusResponse
Définitions
TestSetsResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
valeur
|
value | array of TestSet |
TestSet
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
pièce d'identité
|
id | string | |
|
nom d’affichage
|
displayName | string | |
|
totalTestCases
|
totalTestCases | integer | |
|
descriptif
|
description | string | |
|
auditInfo
|
auditInfo | AuditInfo | |
|
état
|
state | string |
AuditInfo
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
createdBy
|
createdBy | string | |
|
createdTimeUtc
|
createdTimeUtc | date-time | |
|
modifiedBy
|
modifiedBy | string | |
|
modifiedTimeUtc
|
modifiedTimeUtc | date-time |
TestRunsResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
valeur
|
value | array of TestRun |
TestRun
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
pièce d'identité
|
id | string | |
|
environmentId
|
environmentId | string | |
|
cdsBotId
|
cdsBotId | string | |
|
ownerId
|
ownerId | string | |
|
testSetId
|
testSetId | string | |
|
état
|
state | string | |
|
startTime
|
startTime | date-time | |
|
endTime
|
endTime | date-time | |
|
nom
|
name | string | |
|
totalTestCases
|
totalTestCases | integer | |
|
msConnectionId
|
msConnectionId | string | |
|
testCasesResults
|
testCasesResults | array of TestCaseResult |
TestCaseResult
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
testCaseId
|
testCaseId | string | |
|
état
|
state | string | |
|
metricsResults
|
metricsResults | array of TestCaseMetric |
TestCaseMetric
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
type
|
type | string | |
|
résultat
|
result | TestCaseMetricResult |
TestCaseMetricResult
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
données
|
data | object | |
|
status
|
status | string | |
|
errorReason
|
errorReason | string | |
|
aiResultReason
|
aiResultReason | string |
RunStatusResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Identifiant d'exécution
|
runId | string | |
|
lastUpdatedAt
|
lastUpdatedAt | date-time | |
|
état
|
state | string | |
|
executionState
|
executionState | string | |
|
totalTestCases
|
totalTestCases | integer | |
|
testCasesProcessed
|
testCasesProcessed | integer |