Microsoft Copilot Studio

ügynökök felderítésére és aktiválására használt Microsoft Copilot Studio

Ez az összekötő a következő termékekben és régiókban érhető el:

Service	Class	Régiók
Copilot Studio	Standard	Az összes Power Automate régió kivéve a következőket: - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD)
Power Apps	Standard	Az összes Power Apps régió kivéve a következőket: - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD)
Power Automate	Standard	Az összes Power Automate régió kivéve a következőket: - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD)

Érintkezés
Név	Microsoft Copilot Studio
URL	https://aka.ms/copilotstudio
Email	donglei@microsoft.com

Összekötő metaadatai
Publisher	Microsoft
Webhely	https://aka.ms/copilotstudio
Adatvédelmi irányelvek	https://www.microsoft.com/en-us/privacy/privacystatement
Kategóriák	AI

Kapcsolat létrehozása

Az összekötő a következő hitelesítési típusokat támogatja:


Oauth	Jelentkezzen be Microsoft Entra ID a Power Platform API-ba.	Minden régió	Nem osztható meg
Alapértelmezett [ELAVULT]	Ez a beállítás csak olyan régebbi kapcsolatokhoz használható, amelyeknek nincs explicit hitelesítési típusuk, és csak a visszamenőleges kompatibilitást biztosítják.	Minden régió	Nem osztható meg

Oauth

Hitelesítési azonosító: oauthDefault

Alkalmazható: Minden régió

Jelentkezzen be Microsoft Entra ID a Power Platform API-ba.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Alapértelmezett [ELAVULT]

Alkalmazható: Minden régió

Ez a beállítás csak olyan régebbi kapcsolatokhoz használható, amelyeknek nincs explicit hitelesítési típusuk, és csak a visszamenőleges kompatibilitást biztosítják.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Szabályozási korlátok

Name	Hívások	Megújítási időszak
API-hívások kapcsolatonként	300	60 másodperc

Műveletek

Ügynök kiértékelése	Egy ügynök kiértékelése egy adott tesztkészlettel.
Ügynök végrehajtása	Kérés küldése a megadott ügynöknek feldolgozásra
Ügynök végrehajtása és várakozás	Kérést küld a megadott ügynöknek feldolgozásra, és várja meg a folytatást
Ügynöktesztfuttatás részleteinek lekérése	Lekéri egy adott készítői kiértékelési teszt futtatásának részleteit.
Ügynöktesztfuttatások lekérése	Lekéri a gyártó kiértékelési tesztjét a megadott ügynökhöz.
Ügynöktesztkészlet részleteinek lekérése	Lekéri egy adott készítői kiértékelési tesztkészlet részleteit.
Ügynöktesztkészletek lekérése	Lekéri egy ügynök tesztkészleteit.

Ügynök kiértékelése

Műveletazonosító:: RunAgentMakerEvaluationTestSet

Egy ügynök kiértékelése egy adott tesztkészlettel.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Ügynök	Agent	True	string	válasszon ki egy ügynököt a legördülő listából, vagy adjon meg egy egyéni értéket (az ügynök azonosítóját).
Tesztkészlet	TestSetId	True	string	Válasszon ki egy tesztkészletet a legördülő listából, vagy adjon meg egy egyéni értéket (a tesztkészlet azonosítóját).
MCS-kapcsolat azonosítója	mcsConnectionId		string	Felhasználói profil kiválasztása – Adja meg az MCS-kapcsolat azonosítóját, vagy névtelen futtatás esetén hagyja üresen.
Kiértékelési futtatás neve	evaluationRunName		string	Adja meg a kiértékelési futtatás nevét, vagy hagyja üresen.

Válaszok

Törzs: RunStatusResponse

Ügynök végrehajtása

Műveletazonosító:: ExecuteCopilot

Kérés küldése a megadott ügynöknek feldolgozásra

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Ügynök	Copilot	True	string	Ügynök
Message	message	True	string	Message
A szövegmező tartalmának BCP-47 területi neve.	locale		string	A szövegmező tartalmának BCP-47 területi neve.
tartalomtípus	contentType		string
contentUrl	contentUrl		string
tartalom	content		object
név	name		string
thumbnailUrl	thumbnailUrl		string
Beszélgetés azonosítója	x-ms-conversation-id		string	Adjon meg egy exisiting beszélgetésazonosítót az ügynök végrehajtásának folytatásához.
Környezet azonosítója	environmentId		string	Nem kötelező környezeti azonosító

Válaszok

Name	Elérési út	Típus	Description
Beszélgetésazonosító	ConversationId	string	A válaszhoz társított beszélgetésazonosító

Ügynök végrehajtása és várakozás

Műveletazonosító:: ExecuteCopilotAsyncV2

Kérést küld a megadott ügynöknek feldolgozásra, és várja meg a folytatást

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Ügynök	Copilot	True	string	Ügynök
Message	message		string	Message
A szövegmező tartalmának BCP-47 területi neve.	locale		string	A szövegmező tartalmának BCP-47 területi neve.
tartalomtípus	contentType		string
contentUrl	contentUrl		string
tartalom	content		object
név	name		string
thumbnailUrl	thumbnailUrl		string
Beszélgetés azonosítója	x-ms-conversation-id		string	Adjon meg egy exisiting beszélgetésazonosítót az ügynök végrehajtásának folytatásához.
Környezet azonosítója	environmentId		string	Nem kötelező környezeti azonosító

Válaszok

Name	Elérési út	Típus	Description
lastResponse	lastResponse	string	Az utolsó szöveges válasz a tevékenységek listájában
Válaszok	responses	array of string	A tevékenységek listájában szereplő sztringválaszok listája
conversationId	conversationId	string	A válaszhoz társított beszélgetésazonosító

Ügynöktesztfuttatás részleteinek lekérése

Műveletazonosító:: GetAgentMakerEvaluationTestRunDetails

Lekéri egy adott készítői kiértékelési teszt futtatásának részleteit.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Ügynök	Agent	True	string	válasszon ki egy ügynököt a legördülő listából, vagy adjon meg egy egyéni értéket (az ügynök azonosítóját).
Kiértékelési futtatás	EvaluationRunId	True	string	Válassza ki a kiértékelési futtatást a legördülő listából, vagy adjon meg egy egyéni értéket (a kiértékelési futtatási azonosítót).

Válaszok

Törzs: TestRun

Ügynöktesztfuttatások lekérése

Műveletazonosító:: GetAgentMakerEvaluationTestRuns

Lekéri a gyártó kiértékelési tesztjét a megadott ügynökhöz.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Ügynök	Agent	True	string	válasszon ki egy ügynököt a legördülő listából, vagy adjon meg egy egyéni értéket (az ügynök azonosítóját).

Válaszok

Törzs: TestRunsResponse

Ügynöktesztkészlet részleteinek lekérése

Műveletazonosító:: GetAgentMakerEvaluationTestSetDetails

Lekéri egy adott készítői kiértékelési tesztkészlet részleteit.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Ügynök	Agent	True	string	válasszon ki egy ügynököt a legördülő listából, vagy adjon meg egy egyéni értéket (az ügynök azonosítóját).
Tesztkészlet	TestSetId	True	string	Válasszon ki egy tesztkészletet a legördülő listából, vagy adjon meg egy egyéni értéket (a tesztkészlet azonosítóját).

Válaszok

Törzs: TestSet

Ügynöktesztkészletek lekérése

Műveletazonosító:: GetAgentMakerEvaluationTestSets

Lekéri egy ügynök tesztkészleteit.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Ügynök	Agent	True	string	válasszon ki egy ügynököt a legördülő listából, vagy adjon meg egy egyéni értéket (az ügynök azonosítóját).

Válaszok

Törzs: TestSetsResponse

Definíciók

TestSetsResponse

Name	Elérési út	Típus	Description
value	value	array of TestSet

TestSet

Name	Elérési út	Típus
azonosító	id	string
kijelző neve	displayName	string
totalTestCases	totalTestCases	integer
leírás	description	string
auditInfo	auditInfo	AuditInfo
state	state	string

AuditInfo

Name	Elérési út	Típus
készítette	createdBy	string
createdTimeUtc	createdTimeUtc	date-time
modifiedBy	modifiedBy	string
modifiedTimeUtc	modifiedTimeUtc	date-time

TestRunsResponse

Name	Elérési út	Típus	Description
value	value	array of TestRun

TestRun

Name	Elérési út	Típus
azonosító	id	string
environmentId	environmentId	string
cdsBotId	cdsBotId	string
tulajdonosazonosító	ownerId	string
testSetId	testSetId	string
state	state	string
startTime	startTime	date-time
endTime	endTime	date-time
név	name	string
totalTestCases	totalTestCases	integer
msConnectionId	msConnectionId	string
testCasesResults	testCasesResults	array of TestCaseResult

TestCaseResult

Name	Elérési út	Típus
testCaseId	testCaseId	string
state	state	string
metricsResults	metricsResults	array of TestCaseMetric

TestCaseMetric

Name	Elérési út	Típus	Description
típus	type	string
eredmény	result	TestCaseMetricResult

TestCaseMetricResult

Name	Elérési út	Típus
adat	data	object
állapot	status	string
errorReason	errorReason	string
aiResultReason	aiResultReason	string

RunStatusResponse

Name	Elérési út	Típus
runId	runId	string
utolsóFrissítveAt	lastUpdatedAt	date-time
state	state	string
executionState	executionState	string
totalTestCases	totalTestCases	integer
testCasesProcessed	testCasesProcessed	integer