Microsoft Copilot Studio
Microsoft Copilot Studio używane do odnajdywania i wyzwalania agentów
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Wszystkie regiony Power Automate z wyjątkiem następujących: - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Apps | Standard | Wszystkie regiony Power Apps z wyjątkiem następujących: - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Standard | Wszystkie regiony Power Automate z wyjątkiem następujących: - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Microsoft Copilot Studio |
| adres URL | https://aka.ms/copilotstudio |
| donglei@microsoft.com |
| Metadane łącznika | |
|---|---|
| Publisher | Microsoft |
| Witryna internetowa | https://aka.ms/copilotstudio |
| Zasady ochrony prywatności | https://www.microsoft.com/en-us/privacy/privacystatement |
| Kategorie | AI |
Ogólne limity
| Name | Wartość |
|---|---|
| Połączenia na konto | 50 |
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 300 | 60 sekund |
Akcje
| Ocena agenta |
Ocenia agenta przy użyciu określonego zestawu testów. |
| Pobieranie przebiegów testów agenta |
Pobiera przebieg testu oceny producenta dla określonego agenta. |
| Pobieranie szczegółów przebiegu testu agenta |
Pobiera szczegóły określonego przebiegu testu oceny twórcy. |
| Pobieranie szczegółów zestawu testów agenta |
Pobiera szczegóły określonego zestawu testów oceny producenta. |
| Pobieranie zestawów testów agenta |
Pobiera zestawy testów dla agenta. |
| Wykonywanie agenta |
Wysyła monit do określonego agenta w celu przetworzenia |
| Wykonywanie agenta i oczekiwanie |
Wysyła monit do określonego agenta w celu przetworzenia i oczekiwania na wznowienie |
Ocena agenta
Ocenia agenta przy użyciu określonego zestawu testów.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Przedstawiciel
|
Agent | True | string |
wybierz agenta z listy rozwijanej lub wprowadź wartość niestandardową (identyfikator agenta). |
|
Zestaw testów
|
TestSetId | True | string |
Wybierz zestaw testowy z listy rozwijanej lub wprowadź wartość niestandardową (identyfikator zestawu testów). |
|
Identyfikator połączenia usługi MCS
|
mcsConnectionId | string |
Wybierz pozycję Profil użytkownika — wprowadź identyfikator połączenia MCS lub pozostaw pusty dla anonimowego przebiegu. |
|
|
Nazwa przebiegu oceny
|
evaluationRunName | string |
Wprowadź nazwę przebiegu oceny lub pozostaw puste. |
Pobieranie przebiegów testów agenta
Pobiera przebieg testu oceny producenta dla określonego agenta.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Przedstawiciel
|
Agent | True | string |
wybierz agenta z listy rozwijanej lub wprowadź wartość niestandardową (identyfikator agenta). |
Zwraca
- Body
- TestRunsResponse
Pobieranie szczegółów przebiegu testu agenta
Pobiera szczegóły określonego przebiegu testu oceny twórcy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Przedstawiciel
|
Agent | True | string |
wybierz agenta z listy rozwijanej lub wprowadź wartość niestandardową (identyfikator agenta). |
|
Przebieg oceny
|
EvaluationRunId | True | string |
Wybierz pozycję Przebieg oceny z listy rozwijanej lub wprowadź wartość niestandardową (identyfikator przebiegu oceny). |
Zwraca
- Body
- TestRun
Pobieranie szczegółów zestawu testów agenta
Pobiera szczegóły określonego zestawu testów oceny producenta.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Przedstawiciel
|
Agent | True | string |
wybierz agenta z listy rozwijanej lub wprowadź wartość niestandardową (identyfikator agenta). |
|
Zestaw testów
|
TestSetId | True | string |
Wybierz zestaw testowy z listy rozwijanej lub wprowadź wartość niestandardową (identyfikator zestawu testów). |
Zwraca
- Body
- TestSet
Pobieranie zestawów testów agenta
Pobiera zestawy testów dla agenta.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Przedstawiciel
|
Agent | True | string |
wybierz agenta z listy rozwijanej lub wprowadź wartość niestandardową (identyfikator agenta). |
Zwraca
- Body
- TestSetsResponse
Wykonywanie agenta
Wysyła monit do określonego agenta w celu przetworzenia
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Przedstawiciel
|
Copilot | True | string |
Przedstawiciel |
|
komunikat
|
message | string |
Message |
|
|
Nazwa ustawień regionalnych BCP-47 dla zawartości pola tekstowego.
|
locale | string |
Nazwa ustawień regionalnych BCP-47 dla zawartości pola tekstowego. |
|
|
typ treści
|
contentType | string | ||
|
contentUrl
|
contentUrl | string | ||
|
zawartość
|
content | object | ||
|
nazwa
|
name | string | ||
|
thumbnailUrl
|
thumbnailUrl | string | ||
|
Identyfikator konwersacji
|
x-ms-conversation-id | string |
Podaj identyfikator konwersacji, aby wznowić wykonywanie agenta. |
|
|
Identyfikator środowiska
|
environmentId | string |
Opcjonalny identyfikator środowiska |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator konwersacji
|
ConversationId | string |
Identyfikator konwersacji skojarzony z odpowiedzią |
Wykonywanie agenta i oczekiwanie
Wysyła monit do określonego agenta w celu przetworzenia i oczekiwania na wznowienie
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Przedstawiciel
|
Copilot | True | string |
Przedstawiciel |
|
Message
|
message | string |
Message |
|
|
Nazwa ustawień regionalnych BCP-47 dla zawartości pola tekstowego.
|
locale | string |
Nazwa ustawień regionalnych BCP-47 dla zawartości pola tekstowego. |
|
|
typ treści
|
contentType | string | ||
|
contentUrl
|
contentUrl | string | ||
|
zawartość
|
content | object | ||
|
nazwa
|
name | string | ||
|
thumbnailUrl
|
thumbnailUrl | string | ||
|
Identyfikator konwersacji
|
x-ms-conversation-id | string |
Podaj identyfikator konwersacji, aby wznowić wykonywanie agenta. |
|
|
Identyfikator środowiska
|
environmentId | string |
Opcjonalny identyfikator środowiska |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
lastResponse
|
lastResponse | string |
Ostatnia odpowiedź tekstowa na liście działań |
|
Odpowiedzi
|
responses | array of string |
Lista odpowiedzi ciągów na liście działań |
|
conversationId (identyfikator rozmowy)
|
conversationId | string |
Identyfikator konwersacji skojarzony z odpowiedzią |
Definicje
TestSetsResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
wartość
|
value | array of TestSet |
Zestaw testów
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
id
|
id | string | |
|
displayName
|
displayName | string | |
|
totalTestCases
|
totalTestCases | integer | |
|
opis
|
description | string | |
|
Auditinfo
|
auditInfo | AuditInfo | |
|
stan
|
state | string |
Auditinfo
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
utworzone przez
|
createdBy | string | |
|
createdTimeUtc
|
createdTimeUtc | date-time | |
|
modifiedBy
|
modifiedBy | string | |
|
modifiedTimeUtc
|
modifiedTimeUtc | date-time |
TestRunsResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
wartość
|
value | array of TestRun |
Testrun
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
id
|
id | string | |
|
environmentId
|
environmentId | string | |
|
cdsBotId
|
cdsBotId | string | |
|
ownerId
|
ownerId | string | |
|
testSetId
|
testSetId | string | |
|
stan
|
state | string | |
|
startTime
|
startTime | date-time | |
|
endTime
|
endTime | date-time | |
|
nazwa
|
name | string | |
|
totalTestCases
|
totalTestCases | integer | |
|
msConnectionId
|
msConnectionId | string |