Microsoft Copilot Studio

Aracıları bulmak ve tetiklemek için kullanılan Microsoft Copilot Studio

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet	Class	Bölgeler
Copilot Studio	Standart	Aşağıdakiler dışında tüm Power Automate bölgeleri: - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD)
Power Apps	Standart	Aşağıdakiler dışında tüm Power Apps bölgeleri: - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD)
Power Automate	Standart	Aşağıdakiler dışında tüm Power Automate bölgeleri: - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD)

İletişim
İsim	Microsoft Copilot Studio
URL	https://aka.ms/copilotstudio
E-posta	donglei@microsoft.com

Bağlayıcı Meta Verileri
Publisher	Microsoft
Web sitesi	https://aka.ms/copilotstudio
Gizlilik ilkesi	https://www.microsoft.com/en-us/privacy/privacystatement
Kategoriler	AI

Genel Sınırlar

İsim	Değer
Hesap başına bağlantı sayısı	50

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:


Oauth	Power Platform API'sinde Microsoft Entra ID kullanarak oturum açın.	Tüm bölgeler	Paylaşılamaz
Varsayılan [KULLANIM DIŞI]	Bu seçenek yalnızca açık kimlik doğrulama türü olmayan eski bağlantılar içindir ve yalnızca geriye dönük uyumluluk için sağlanır.	Tüm bölgeler	Paylaşılamaz

Oauth

Kimlik Doğrulama Kimliği: oauthDefault

Geçerli: Tüm bölgeler

Power Platform API'sinde Microsoft Entra ID kullanarak oturum açın.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

Varsayılan [KULLANIM DIŞI]

Geçerli: Tüm bölgeler

Bu seçenek yalnızca açık kimlik doğrulama türü olmayan eski bağlantılar içindir ve yalnızca geriye dönük uyumluluk için sağlanır.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

Azaltma Sınırları

Name	Çağrılar	Yenileme Dönemi
Bağlantı başına API çağrıları	300	60 saniye

Eylemler

Aracı Test Kümelerini Alma	Aracı için test kümelerini alır.
Aracı Test Kümesi Ayrıntılarını Alma	Belirli bir oluşturucu değerlendirme test kümesinin ayrıntılarını alır.
Aracı Test Çalıştırmalarını Alma	Belirtilen Aracı için oluşturucu değerlendirme testi çalıştırmalarını alır.
Aracı Test Çalıştırması Ayrıntılarını Alma	Belirli bir oluşturucu değerlendirme testi çalıştırmasının ayrıntılarını alır.
Aracıyı Değerlendir	Aracıyı belirli bir test kümesi kullanarak değerlendirir.
Aracıyı yürüt ve bekle	belirtilen Aracıya işleme için bir istem gönderir ve sürdürülmesini bekler
Aracıyı Yürütme	belirtilen Aracıya işlenmek üzere bir istem gönderir

Aracı Test Kümelerini Alma

İşlem Kimliği:: GetAgentMakerEvaluationTestSets

Aracı için test kümelerini alır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Temsilci	Agent	True	string	açılan listeden bir aracı seçin veya özel bir değer (aracı kimliği) girin.

Döndürülenler

Vücut: TestSetsResponse

Aracı Test Kümesi Ayrıntılarını Alma

İşlem Kimliği:: GetAgentMakerEvaluationTestSetDetails

Belirli bir oluşturucu değerlendirme test kümesinin ayrıntılarını alır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Temsilci	Agent	True	string	açılan listeden bir aracı seçin veya özel bir değer (aracı kimliği) girin.
Test Kümesi	TestSetId	True	string	Açılan listeden bir test kümesi seçin veya özel bir değer (test kümesi kimliği) girin.

Döndürülenler

Vücut: TestSet

Aracı Test Çalıştırmalarını Alma

İşlem Kimliği:: GetAgentMakerEvaluationTestRuns

Belirtilen Aracı için oluşturucu değerlendirme testi çalıştırmalarını alır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Temsilci	Agent	True	string	açılan listeden bir aracı seçin veya özel bir değer (aracı kimliği) girin.

Döndürülenler

Vücut: TestRunsResponse

Aracı Test Çalıştırması Ayrıntılarını Alma

İşlem Kimliği:: GetAgentMakerEvaluationTestRunDetails

Belirli bir oluşturucu değerlendirme testi çalıştırmasının ayrıntılarını alır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Temsilci	Agent	True	string	açılan listeden bir aracı seçin veya özel bir değer (aracı kimliği) girin.
Değerlendirme Çalıştırması	EvaluationRunId	True	string	Açılan listeden değerlendirme çalıştırmasını seçin veya özel bir değer (değerlendirme çalıştırma kimliği) girin.

Döndürülenler

Vücut: TestRun

Aracıyı Değerlendir

İşlem Kimliği:: RunAgentMakerEvaluationTestSet

Aracıyı belirli bir test kümesi kullanarak değerlendirir.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Temsilci	Agent	True	string	açılan listeden bir aracı seçin veya özel bir değer (aracı kimliği) girin.
Test Kümesi	TestSetId	True	string	Açılan listeden bir test kümesi seçin veya özel bir değer (test kümesi kimliği) girin.
MCS Bağlantı Kimliği	mcsConnectionId		string	Kullanıcı profili - MCS bağlantı kimliğini girin veya anonim çalıştırma için boş bırakın'ı seçin.
Değerlendirme çalıştırma adı	evaluationRunName		string	Değerlendirme çalıştırması için bir ad girin veya boş bırakın.

Döndürülenler

Vücut: RunStatusResponse

Aracıyı yürüt ve bekle

İşlem Kimliği:: ExecuteCopilotAsyncV2

belirtilen Aracıya işleme için bir istem gönderir ve sürdürülmesini bekler

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Temsilci	Copilot	True	string	Temsilci
Message	message		string	Message
Metin alanının içeriği için BCP-47 yerel ayarı adı.	locale		string	Metin alanının içeriği için BCP-47 yerel ayarı adı.
içerik türü	contentType		string
contentUrl	contentUrl		string
içerik	content		object
name	name		string
küçükResimURL	thumbnailUrl		string
Konuşma kimliği	x-ms-conversation-id		string	Aracı yürütmeyi sürdürmek için konuşma kimliğini açın.
Ortam kimliği	environmentId		string	İsteğe bağlı ortam kimliği

Döndürülenler

Name	Yol	Tür	Description
lastResponse	lastResponse	string	Etkinlikler listesindeki son metin yanıtı
Yanıt	responses	array of string	Etkinlikler listesindeki dize yanıtlarının listesi
conversationId	conversationId	string	Yanıtla ilişkilendirilmiş konuşma kimliği

Aracıyı Yürütme

İşlem Kimliği:: ExecuteCopilot

belirtilen Aracıya işlenmek üzere bir istem gönderir

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Temsilci	Copilot	True	string	Temsilci
Message	message	True	string	Message
Metin alanının içeriği için BCP-47 yerel ayarı adı.	locale		string	Metin alanının içeriği için BCP-47 yerel ayarı adı.
içerik türü	contentType		string
contentUrl	contentUrl		string
içerik	content		object
name	name		string
küçükResimURL	thumbnailUrl		string
Konuşma kimliği	x-ms-conversation-id		string	Aracı yürütmeyi sürdürmek için konuşma kimliğini açın.
Ortam kimliği	environmentId		string	İsteğe bağlı ortam kimliği

Döndürülenler

Name	Yol	Tür	Description
Konuşma Kimliği	ConversationId	string	Yanıtla ilişkilendirilmiş konuşma kimliği

Tanımlar

TestSetsResponse

Name	Yol	Tür	Description
değer	value	array of TestSet

TestSet

Name	Yol	Tür
kimlik	id	string
ekran adı	displayName	string
totalTestCases	totalTestCases	integer
açıklama	description	string
Auditınfo	auditInfo	AuditInfo
state	state	string

Auditınfo

Name	Yol	Tür
oluşturan	createdBy	string
createdTimeUtc	createdTimeUtc	date-time
modifiedBy	modifiedBy	string
modifiedTimeUtc	modifiedTimeUtc	date-time

TestRunsResponse

Name	Yol	Tür	Description
değer	value	array of TestRun

Test Çalıştırması

Name	Yol	Tür
kimlik	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
name	name	string
totalTestCases	totalTestCases	integer
msConnectionId	msConnectionId	string
testCasesResults	testCasesResults	array of TestCaseResult

TestCaseResult

Name	Yol	Tür
testCaseId	testCaseId	string
state	state	string
metricsResults	metricsResults	array of TestCaseMetric

TestCaseMetric

Name	Yol	Tür	Description
türü	type	string
sonuç	result	TestCaseMetricResult

TestCaseMetricResult

Name	Yol	Tür
veriler	data	object
statü	status	string
errorReason	errorReason	string
aiResultReason	aiResultReason	string

RunStatusResponse

Name	Yol	Tür
runId	runId	string
lastUpdatedAt	lastUpdatedAt	date-time
state	state	string
executionState	executionState	string
totalTestCases	totalTestCases	integer
testCasesProcessed	testCasesProcessed	integer