COSMO Bot (Önizleme)

COSMO Bot, günlük yaşamda daha fazla verimlilikle iş başarınızı artırır. Bugün standart bir soruya yanıt verirseniz zaman kaybediyorsunuz. Müşterilerinizle iletişim halinde, bu genellikle birbirinizi tanımak ve bir ilişki kurmak için iyi bir fırsattır. Ancak dahili olarak, çalışandan çalışana veya yapılacak çok şey olduğunda, herkesin kendi kendine izin veremeyecekleri bir lükstür. Bu bağlayıcı, bot işlevselliğini genişletmenize ve diğer sistemleri tümleştirmenize olanak tanır.

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

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

İletişim
İsim	COSMO CONSULT Desteği
URL	https://de.cosmoconsult.com/service/support/
E-posta	support.west@cosmoconsult.com

Bağlayıcı Meta Verileri
Publisher	COSMO CONSULT GmbH
Web sitesi	https://cosma.link/cc-bot
Gizlilik ilkesi	https://www.cosmoconsult.com/data-protection/
Kategoriler	AI; İletişim

Önkoşullar

Bu bağlayıcıyı kullanmak için cosmo bot örneğine yönetici erişimine sahip olmanız gerekir. COSMO Bot nedir?Cosmo Bot örneğini nasıl alabilirim?

Kimlik bilgileri nasıl alınıyor?

Cosmo Bot Örneğine yönetici erişiminiz olduğunda sohbet arabirimine (örneğin https://cosma.cosmoconsult.com/) gidin ve sağ üst köşedeki "Yönetim" seçeneğine tıklayarak "Yönetim" sekmesine geçin. "API Anahtarları" bölümüne gidin ve yeni bir tane oluşturun veya mevcut bir anahtarı kopyalayın.

Bağlantı oluşturma

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

Varsayılan	Bağlantı oluşturmak için parametreler.	Tüm bölgeler	Paylaşılamaz

Temerrüt

Geçerli: Tüm bölgeler

Bağlantı oluşturmak için parametreler.

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.

İsim	Türü	Description	Gerekli
Bot Örneği URL'si	String	Bot örneğinize ulaşabileceğiniz URL	Doğru
API Anahtarı	securestring	Bu bot örneğine erişmek için API anahtarı	Doğru

Azaltma Sınırları

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

Eylemler

Açık biletler alma	Bağlı örnekteki tüm açık biletleri alır.
Bilet açma (geri bildirim)	Bağlı örnekte yeni bir geri bildirim türü bileti açın.
Bilet açma (soru)	Bağlı örnekte yeni bir bilet açın.
Bileti kapatma	Bağlı örnekte açık bir bileti kapatır.
Bir konu için uzman alma	Bağlı örnekteki tüm üsleri alır.
Bir uzmanı konu başlığından kaldırma	Bot, sağlanan konudan bir uzmanı kaldırır. Herhangi bir konu verilmemişse, uzman tüm konulardan çıkarılacaktır.
COSMO Bot'a soru sorun	Bot bilgi bankasında arama yapacak ve yanıtı en iyi eşleşmeyle döndürecektir. Ayrıca puanı döndürür.
COSMO Bot Betiğini Dönüştürme	Verilen metni COSMO Bot Betiği ayrıştırıcısı aracılığıyla çalıştırın.
Genel ayarları alma	Bağlı örnekten genel ayarları alır.
Konu alma	Bağlı örnekten belirli bir konu alır.
Konuya uzman ekleme	Bot, sağlanan konuya uzmanı ekler.
Mevcut soru-yanıt kümesini düzenleme	Bağlı örnekten mevcut bir soru-yanıt kümesini düzenleyin.
Soru-yanıt kümesini silme	Bağlı örnekten mevcut bir soru-yanıt kümesini silin.
Soru-yanıt kümesinin gölge kopyasını oluşturma	Kısa açıklama tarafından belirtilen soru-yanıt kümesi için yeni bir gölge kopya ekler. Dikkatli! Yanıt güncelleştirildiğinde bu gölge kopyalar silinir. Bu nedenle, "soru-yanıt kümesi güncelleştirildiğinde" tetikleyicisini kullanarak bu eylemi otomatik olarak çağırmak önerilir.
Tüm konuları alma	Bağlı bot örneğindeki tüm konuları alır.
Tüm soru-cevap kümelerini alma	Bağlı örnekten tüm yanıtları alır.
Var olan bir konuyu yeniden adlandırma	Bağlı örnekten var olan bir konuyu yeniden adlandırın.
Yeni konu ekleme	Bağlı örneğe yeni bir konu ekler.
Yeni soru-yanıt kümesi ekleme	Bağlı örneğe yeni bir soru-yanıt kümesi ekler.
Çevir (markdown kolay)	COSMO Bot diyalekt Markdown söz dizimini dikkate alırken verilen metni çevirin.

Açık biletler alma

İşlem Kimliği:

GetOpenTickets

Bağlı örnekteki tüm açık biletleri alır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Açık Süreye Göre Filtrele (en az)	filterByHoursSinceOpened		integer	Yalnızca x saatten uzun süredir açık olan biletleri alın.
Açık Süreye Göre Filtrele (en fazla)	filterByHoursSinceOpenedMax		integer	Yalnızca x saatten kısa bir süredir açık olan biletleri alın.
Konuya Göre Filtrele	filterByTopic		string	Konuya Göre Filtrele
Uzmana Göre Filtrele	filterByExpertEmail		string	Uzmana Göre Filtrele

Döndürülenler

Name	Yol	Tür	Description
Biletler	tickets	array of Ticket

Bilet açma (geri bildirim)

İşlem Kimliği:

OpenTicketFeedback

Bağlı örnekte yeni bir geri bildirim türü bileti açın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kullanıcı E-postası	userEmail	True	string
Kullanıcı tarafından sorulan soru	queryText	True	string
Yanıtın kısa açıklaması	answerShortDescription	True	string
Yanıtla ilgili geri bildirim	feedbackText	True	string

Döndürülenler

Name	Yol	Tür	Description
Bilet	ticket	Ticket

Bilet açma (soru)

İşlem Kimliği:

OpenTicketQuestion

Bağlı örnekte yeni bir bilet açın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kullanıcı E-postası	userEmail	True	string
Kullanıcı tarafından sorulan soru	queryText	True	string
Bu sorunun büyük olasılıkla ait olduğu konu	topic		string

Döndürülenler

Name	Yol	Tür	Description
Bilet	ticket	Ticket

Bileti kapatma

İşlem Kimliği:

CloseTicket

Bağlı örnekte açık bir bileti kapatır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Benzersiz Anahtar Kimliği	ticketId	True	string
Bileti işleyen kullanıcının e-postası	editorEmail	True	string
Kullanıcıya gönderilecek açıklama	editorComment	True	string

Bir konu için uzman alma

İşlem Kimliği:

GetExperts

Bağlı örnekteki tüm üsleri alır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Konu	topic	True	string	Konu

Döndürülenler

Name	Yol	Tür	Description
Uzmanlar	expertEmails	array of string

Bir uzmanı konu başlığından kaldırma

İşlem Kimliği:

RemoveExpert

Bot, sağlanan konudan bir uzmanı kaldırır. Herhangi bir konu verilmemişse, uzman tüm konulardan çıkarılacaktır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Uzman E-postası	expertEmail	True	string
Konu	topic		string

COSMO Bot'a soru sorun

İşlem Kimliği:

AskQuestion

Bot bilgi bankasında arama yapacak ve yanıtı en iyi eşleşmeyle döndürecektir. Ayrıca puanı döndürür.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Question	question	True	string
Puan Eşiği	scoreThreshold		integer	Döndürülecek yanıtın en düşük puanı.
Kullanıcı E-postası	userEmail		string

Döndürülenler

Name	Yol	Tür	Description
Yanıt Bulundu	foundAnswer	boolean	COSMO Bot'un soruyla eşleşen bir yanıt bulup bulmadığı.
Shadow-Answer	isSubAnswer	boolean	Döndürülen yanıtın alt yanıt olup olmadığı.
Soru Çevrildi mi?	isTranslated	boolean	Sorunun ve döndürülen yanıtın çevrilip çevrilmediği.
Cevap	answer	Answer
Score	score	integer	Bot, döndürülen yanıtın doğru olduğundan ne kadar emindir.

COSMO Bot Betiğini Dönüştürme

İşlem Kimliği:

ParseText

Verilen metni COSMO Bot Betiği ayrıştırıcısı aracılığıyla çalıştırın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Metin Girişi	inputText	True	string
Çıkış Biçimi	outputFormat	True	string

Döndürülenler

Name	Yol	Tür	Description
Çıkış Metni	outputText	string	COSMO Bot Betik Ayrıştırıcısı tarafından döndürülen ayrıştırılmış metin.

Genel ayarları alma

İşlem Kimliği:

GetGlobalSettings

Bağlı örnekten genel ayarları alır.

Döndürülenler

Bu işlemin çıkışları dinamiktir.

Konu alma

İşlem Kimliği:

GetTopic

Bağlı örnekten belirli bir konu alır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Konu Adı	topicName	True	string	Konu Adı

Döndürülenler

Name	Yol	Tür	Description
İsim	topic.name	string
Description	topic.description	string

Konuya uzman ekleme

İşlem Kimliği:

AddExpert

Bot, sağlanan konuya uzmanı ekler.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Konu	topic	True	string
Uzman E-postası	expertEmail	True	string

Mevcut soru-yanıt kümesini düzenleme

İşlem Kimliği:

EditAnswer

Bağlı örnekten mevcut bir soru-yanıt kümesini düzenleyin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Mevcut Kümenin Kısa Açıklaması	shortDescription	True	string
Güncelleştirilmiş Konu	newTopic		string
Güncelleştirilmiş Kısa Açıklama	newShortDescription		string
Güncelleştirilmiş Sorular	newQuestions		array of string
Güncelleştirilmiş Yanıt Metni	newAnswerText		string
Kullanıcı E-postası	userEmail		string

Soru-yanıt kümesini silme

İşlem Kimliği:

DeleteAnswer

Bağlı örnekten mevcut bir soru-yanıt kümesini silin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kısa Açıklama	shortDescription	True	string

Soru-yanıt kümesinin gölge kopyasını oluşturma

İşlem Kimliği:

AddSubAnswer

Kısa açıklama tarafından belirtilen soru-yanıt kümesi için yeni bir gölge kopya ekler. Dikkatli! Yanıt güncelleştirildiğinde bu gölge kopyalar silinir. Bu nedenle, "soru-yanıt kümesi güncelleştirildiğinde" tetikleyicisini kullanarak bu eylemi otomatik olarak çağırmak önerilir.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Özgün Yanıtın Kısa Açıklaması	shortDescription	True	string
Gölge Kopyanın Kısa Açıklaması	subShortDescription	True	string
Sorular	subQuestions	True	array of string
Yanıt Metni	subAnswerText	True	string

Tüm konuları alma

İşlem Kimliği:

GetAllTopics

Bağlı bot örneğindeki tüm konuları alır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Uzmana Göre Filtrele	filterByExpert		string	Uzmana Göre Filtrele

Döndürülenler

Name	Yol	Tür	Description
Konu başlıkları	topics	array of string

Tüm soru-cevap kümelerini alma

İşlem Kimliği:

GetAllAnswers

Bağlı örnekten tüm yanıtları alır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Konuya Göre Filtrele (içerir)	filterByTopic		string	Konuya Göre Filtrele (içerir)
Kısa Açıklamaya Göre Filtrele (içerir)	filterByShortDescription		string	Kısa Açıklamaya Göre Filtrele (içerir)
Soru Metnine Göre Filtrele (içerir)	filterByQuestionText		string	Soru Metnine Göre Filtrele (içerir)
Yanıt Metnine Göre Filtrele (içerir)	filterByAnswerText		string	Yanıt Metnine Göre Filtrele (içerir)

Döndürülenler

Name	Yol	Tür	Description
Yanıtlar	answers	array of Answer

Var olan bir konuyu yeniden adlandırma

İşlem Kimliği:

RenameTopic

Bağlı örnekten var olan bir konuyu yeniden adlandırın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Konu Adı	name	True	string	Yeniden adlandırılacak mevcut konunun adı.
Yeni Konu Adı	newName	True	string	Konunun yeniden adlandırılacağı ad.

Yeni konu ekleme

İşlem Kimliği:

AddTopic

Bağlı örneğe yeni bir konu ekler.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Konu Adı	name	True	string
Description	description	True	string
Uzman E-postaları	expertEmails	True	array of string

Yeni soru-yanıt kümesi ekleme

İşlem Kimliği:

AddAnswer

Bağlı örneğe yeni bir soru-yanıt kümesi ekler.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Konu	topic	True	string
Kısa Açıklama	shortDescription	True	string
Sorular	questions	True	array of string
Yanıt Metni	answerText	True	string
Kullanıcı E-postası	userEmail		string

Çevir (markdown kolay)

İşlem Kimliği:

Translate

COSMO Bot diyalekt Markdown söz dizimini dikkate alırken verilen metni çevirin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Hedef Dil	targetLanguageCode	True	string	Hedef dil kodu (örnek: fr).
Metin	inputText	True	string	Çevrilecek metin.

Döndürülenler

Name	Yol	Tür	Description
Çevrilmiş metin	outputText	string

Tetikleyiciler

Bilet çözümlendiğinde	Mevcut bir Bilet çözümlendiğinde.
Biletin konusu güncelleştirildiğinde	Mevcut bir Biletin konusu güncelleştirildiğinde.
Kullanıcı soru sorduğunda	Bir kullanıcı soru sorduğunda.
Soru-yanıt kümesi oluşturulduğunda veya değiştirildiğinde	Soru-yanıt kümesi oluşturulduğunda veya değiştirildiğinde.
Yeni bir bilet oluşturulduğunda	Yeni bir Bilet oluşturulduğunda.
Yeni bir soru-yanıt kümesi oluşturulduğunda	Yeni bir soru-yanıt kümesi oluşturulduğunda.

Bilet çözümlendiğinde

İşlem Kimliği:

OnResolvedTicket

Mevcut bir Bilet çözümlendiğinde.

Döndürülenler

Name	Yol	Tür	Description
Bilet	ticket	Ticket
Düzenleyici E-postası	editorEmail	string
Düzenleyici Açıklaması	editorComment	string
Özgün sorguya derin bağlantı	queryUrl	string

Biletin konusu güncelleştirildiğinde

İşlem Kimliği:

OnUpdatedTicketTopic

Mevcut bir Biletin konusu güncelleştirildiğinde.

Döndürülenler

Name	Yol	Tür	Description
Bilet	ticket	Ticket

Kullanıcı soru sorduğunda

İşlem Kimliği:

OnAskedQuestion

Bir kullanıcı soru sorduğunda.

Döndürülenler

Name	Yol	Tür	Description
Kullanıcı E-postası	userEmail	string
Kullanıcı tarafından sorulan soru	queryText	string
Yanıt Bulundu	foundAnswer	boolean	COSMO Bot'un kullanıcının sorusuyla eşleşen bir yanıt bulup bulmadığı.
Cevap	answer	Answer

Soru-yanıt kümesi oluşturulduğunda veya değiştirildiğinde

İşlem Kimliği:

OnUpdateAnswer

Soru-yanıt kümesi oluşturulduğunda veya değiştirildiğinde.

Döndürülenler

Name	Yol	Tür	Description
Cevap	answer	Answer

Yeni bir bilet oluşturulduğunda

İşlem Kimliği:

OnNewTicket

Yeni bir Bilet oluşturulduğunda.

Döndürülenler

Name	Yol	Tür	Description
Bilet	ticket	Ticket

Yeni bir soru-yanıt kümesi oluşturulduğunda

İşlem Kimliği:

OnNewAnswer

Yeni bir soru-yanıt kümesi oluşturulduğunda.

Döndürülenler

Name	Yol	Tür	Description
Cevap	answer	Answer

Tanımlar

Cevap

Name	Yol	Tür	Description
Konu	topic	string
Kısa Açıklama	shortDescription	string
Sorular	questions	array of string
Yanıt Metni	answerText	string
Bu yanıtın son değiştirildiği tarih ve saat	modifiedAt	date-time
Değiştiren	modifiedBy	string

Bilet

Name	Yol	Tür	Description
Benzersiz Anahtar Kimliği	ticketId	string
Konu	topic	string
Bileti işlemek için ayrıntılı bağlantı	ticketUrl	string
İstek Sahibi E-postası	requesterEmail	string
Uzman E-postaları	expertEmails	array of string
Kullanıcı tarafından sorulan soru	queryText	string
Kullanıcı tarafından gönderilen geri bildirim	feedbackText	string	Bu bilet geri bildirim değilse bu boş olur.
Kullanıcının sorusunu sorduktan sonra aldığı yanıtın kısa açıklaması	answerShortDescription	string	Bu bilet geri bildirim değilse bu boş olur.
Kullanıcının sorusunu sorduktan sonra aldığı yanıt	answerText	string	Bu bilet geri bildirim değilse bu boş olur.
Biletin oluşturulduğu tarih ve saat	createdAt	date-time