Microsoft Copilot Studio

Microsoft Copilot Studio sloužící ke zjišťování a aktivaci agentů

Tento konektor je dostupný v následujících produktech a oblastech:

Service	Class	Regions
Copilot Studio	Standard	Všechny oblasti Power Automate kromě následujících: - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD)
Power Apps	Standard	Všechny oblasti Power Apps s výjimkou následujících: - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD)
Power Automate	Standard	Všechny oblasti Power Automate kromě následujících: - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD)

Kontakt
Název	Microsoft Copilot Studio
URL	https://aka.ms/copilotstudio
Email	donglei@microsoft.com

Metadata konektoru
Publisher	Microsoft
Internetová stránka	https://aka.ms/copilotstudio
Zásady ochrany osobních údajů	https://www.microsoft.com/en-us/privacy/privacystatement
Kategorie	AI

Obecné limity

Název	Hodnota
Připojení na účet	50

Vytvoření připojení

Konektor podporuje následující typy ověřování:


výchozí	Parametry pro vytvoření připojení	Všechny oblasti	Nesdílitelné

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Limity omezování

Name	Volání	Období obnovení
Volání rozhraní API na připojení	300	60 sekund

Akce

Spustit agenta	Odešle výzvu zadanému agentu ke zpracování.
Spuštění agenta a čekání	Odešle výzvu zadanému agentu ke zpracování a čekání na obnovení.
Vyhodnocení agenta	Vyhodnotí agenta pomocí konkrétní testovací sady.
Získání podrobností o testovací sadě agentů	Získá podrobnosti o konkrétní testovací sadě testů pro tvůrce.
Získání podrobností o testovacím spuštění agenta	Získá podrobnosti o testovacím běhu konkrétního tvůrce.
Získání testovacích běhů agenta	Získá testovací spuštění testů pro tvůrce pro zadaného agenta.
Získání testovacích sad agentů	Získá testovací sady pro agenta.

Spustit agenta

ID operace:: ExecuteCopilot

Odešle výzvu zadanému agentu ke zpracování.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Agenta	Copilot	True	string	Agenta
zpráva	message		string	Message
Název národního prostředí BCP-47 pro obsah textového pole.	locale		string	Název národního prostředí BCP-47 pro obsah textového pole.
typ obsahu	contentType		string
URLobsahu	contentUrl		string
obsah	content		object
název	name		string
thumbnailUrl	thumbnailUrl		string
ID konverzace	x-ms-conversation-id		string	Zadejte ID konverzace, abyste mohli pokračovat v provádění agenta.
ID prostředí	environmentId		string	Volitelné ID prostředí

Návraty

Name	Cesta	Typ	Description
Id konverzace	ConversationId	string	ID konverzace přidružené k odpovědi

Spuštění agenta a čekání

ID operace:: ExecuteCopilotAsyncV2

Odešle výzvu zadanému agentu ke zpracování a čekání na obnovení.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Agenta	Copilot	True	string	Agenta
Message	message		string	Message
Název národního prostředí BCP-47 pro obsah textového pole.	locale		string	Název národního prostředí BCP-47 pro obsah textového pole.
typ obsahu	contentType		string
URLobsahu	contentUrl		string
obsah	content		object
název	name		string
thumbnailUrl	thumbnailUrl		string
ID konverzace	x-ms-conversation-id		string	Zadejte ID konverzace, abyste mohli pokračovat v provádění agenta.
ID prostředí	environmentId		string	Volitelné ID prostředí

Návraty

Name	Cesta	Typ	Description
lastResponse	lastResponse	string	Poslední textová odpověď v seznamu aktivit
odpovědi	responses	array of string	Seznam řetězcových odpovědí v seznamu aktivit
conversationId	conversationId	string	ID konverzace přidružené k odpovědi

Vyhodnocení agenta

ID operace:: RunAgentMakerEvaluationTestSet

Vyhodnotí agenta pomocí konkrétní testovací sady.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Agenta	Agent	True	string	vyberte agenta z rozevíracího seznamu nebo zadejte vlastní hodnotu (ID agenta).
Testovací sada	TestSetId	True	string	V rozevíracím seznamu vyberte testovací sadu nebo zadejte vlastní hodnotu (ID testovací sady).
ID připojení MCS	mcsConnectionId		string	Vyberte Profil uživatele – Zadejte ID připojení MCS nebo nechte prázdné pro anonymní spuštění.
Název zkušebního spuštění	evaluationRunName		string	Zadejte název zkušebního spuštění nebo nechte prázdný.

Návraty

Tělo: RunStatusResponse

Získání podrobností o testovací sadě agentů

ID operace:: GetAgentMakerEvaluationTestSetDetails

Získá podrobnosti o konkrétní testovací sadě testů pro tvůrce.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Agenta	Agent	True	string	vyberte agenta z rozevíracího seznamu nebo zadejte vlastní hodnotu (ID agenta).
Testovací sada	TestSetId	True	string	V rozevíracím seznamu vyberte testovací sadu nebo zadejte vlastní hodnotu (ID testovací sady).

Návraty

Tělo: TestSet

Získání podrobností o testovacím spuštění agenta

ID operace:: GetAgentMakerEvaluationTestRunDetails

Získá podrobnosti o testovacím běhu konkrétního tvůrce.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Agenta	Agent	True	string	vyberte agenta z rozevíracího seznamu nebo zadejte vlastní hodnotu (ID agenta).
Spuštění vyhodnocení	EvaluationRunId	True	string	V rozevíracím seznamu vyberte zkušební spuštění nebo zadejte vlastní hodnotu (ID zkušebního spuštění).

Návraty

Tělo: TestRun

Získání testovacích běhů agenta

ID operace:: GetAgentMakerEvaluationTestRuns

Získá testovací spuštění testů pro tvůrce pro zadaného agenta.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Agenta	Agent	True	string	vyberte agenta z rozevíracího seznamu nebo zadejte vlastní hodnotu (ID agenta).

Návraty

Tělo: TestRunsResponse

Získání testovacích sad agentů

ID operace:: GetAgentMakerEvaluationTestSets

Získá testovací sady pro agenta.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Agenta	Agent	True	string	vyberte agenta z rozevíracího seznamu nebo zadejte vlastní hodnotu (ID agenta).

Návraty

Tělo: TestSetsResponse

Definice

TestSetsResponse

Name	Cesta	Typ	Description
value	value	array of TestSet

Testovací sada

Name	Cesta	Typ
identifikační číslo	id	string
zobrazované jméno	displayName	string
totalTestCases	totalTestCases	integer
popis	description	string
auditInfo	auditInfo	AuditInfo
stav	state	string

AuditInfo

Name	Cesta	Typ
vytvořeno kým	createdBy	string
createdTimeUtc	createdTimeUtc	date-time
modifiedBy	modifiedBy	string
modifiedTimeUtc	modifiedTimeUtc	date-time

TestRunsResponse

Name	Cesta	Typ	Description
value	value	array of TestRun

Testovací spuštění

Name	Cesta	Typ
identifikační číslo	id	string
environmentId	environmentId	string
cdsBotId	cdsBotId	string
ownerId	ownerId	string
testSetId	testSetId	string
stav	state	string
startTime	startTime	date-time
endTime	endTime	date-time
název	name	string
totalTestCases	totalTestCases	integer
msConnectionId	msConnectionId	string
testCasesResults	testCasesResults	array of TestCaseResult

TestCaseResult

Name	Cesta	Typ
testCaseId	testCaseId	string
stav	state	string
metricsResults	metricsResults	array of TestCaseMetric

TestCaseMetric

Name	Cesta	Typ	Description
typ	type	string
výsledek	result	TestCaseMetricResult

TestCaseMetricResult

Name	Cesta	Typ
data	data	object
stav	status	string
errorReason	errorReason	string
aiResultReason	aiResultReason	string

RunStatusResponse

Name	Cesta	Typ
identifikátor spuštění	runId	string
lastUpdatedAt	lastUpdatedAt	date-time
stav	state	string
executionState	executionState	string
totalTestCases	totalTestCases	integer
testCasesProcessed	testCasesProcessed	integer