COSMO Bot （預覽版）

COSMO Bot 通過提高日常生活效率來提高您的業務成功率。如果你今天回答一個標準問題，你就是在浪費時間。在與客戶接觸時，這通常是相互了解和建立關係的好機會。但在內部，從員工到員工，或者當事情太多時，這不是每個人都能允許自己的奢侈。此連接器可讓您擴充機器人的功能並整合其他系統。

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部（DoD）
Power Apps	進階	除下列區域外的所有 Power Apps 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
Power Automate（自動化服務）	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）

連絡人
名稱	COSMO CONSULT 支援
URL	https://de.cosmoconsult.com/service/support/
Email	support.west@cosmoconsult.com

連接器中繼資料
Publisher	COSMO CONSULT 有限公司
網站	https://cosma.link/cc-bot
隱私策略	https://www.cosmoconsult.com/data-protection/
類別	人工智慧;傳達

先決條件

若要使用此連接器，您必須具有 COSMO Bot 執行個體的系統管理存取權。什麼是 COSMO 機器人？如何取得 COSMO Bot 執行個體？

如何取得憑證？

獲得 COSMO 機器人實例的管理存取權限後，請前往聊天介面（即 https://cosma.cosmoconsult.com/），然後按一下右上角的「管理」切換到「管理」標籤。導航到“API 密鑰”並創建一個新密鑰或複製現有密鑰。

正在建立連線

連接器支援下列驗證類型：


預設值	建立連線的參數。	所有區域	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	為必填項目
機器人執行個體 URL	字串	可以連線到機器人執行個體的 URL	對
API 金鑰	securestring	用於存取此機器人執行個體的 API 金鑰	對

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒

動作

刪除問答集	從連線的執行個體中刪除現有的問題-答案集。
取得主題	從連線的執行個體取得特定主題。
取得全域設定	從連線的執行個體取得全域設定。
取得所有主題	從連線的機器人執行個體取得所有主題。
取得所有問答集	從連線的執行個體取得所有答案。
取得某個主題的專家	從連線的執行個體取得所有暴露。
取得開放式門票	從連線的執行個體取得所有開啟的票證。
向 COSMO Bot 提問	機器人將搜索知識庫並返回最匹配的答案。也會傳回分數。
將專家新增至主題	機器人會將專家新增至提供的主題。
建立問答集的陰影複製	為簡短描述所指定的問答集新增陰影複製。謹！更新答案時，會刪除這些陰影副本。因此，建議使用「當問題-答案集更新時」觸發程式自動呼叫此動作。
從主題中移除專家	機器人將從提供的主題中刪除專家。如果未提供主題，則專家將從所有主題中刪除。
新增主題	將新主題新增至連線的執行個體。
新增問答集	將新的問答集新增至連線的執行個體。
編輯現有的問答集	從連線的執行個體編輯現有的問答集。
翻譯（降價友好）	翻譯給定的文本，同時遵守 COSMO Bot 方言 Markdown 語法。
轉換 COSMO 機器人腳本	透過 COSMO Bot 腳本剖析器執行指定的文字。
重新命名現有主題	從連線的執行個體重新命名現有主題。
開啟工單（意見反應）	在連線的執行個體上開啟類型為意見回饋的新票證。
開票（問題）	在連線的執行個體上開啟新票證。
關閉票證	關閉已連線執行個體上開啟的票證。

刪除問答集

作業識別碼：: DeleteAnswer

從連線的執行個體中刪除現有的問題-答案集。

參數

名稱	機碼	必要	類型	Description
簡短描述	shortDescription	True	string

取得主題

作業識別碼：: GetTopic

從連線的執行個體取得特定主題。

參數

名稱	機碼	必要	類型	Description
主題名稱	topicName	True	string	主題名稱

傳回

名稱	路徑	類型	Description
名稱	topic.name	string
Description	topic.description	string

取得全域設定

作業識別碼：: GetGlobalSettings

從連線的執行個體取得全域設定。

傳回

此作業會輸出隨機的結果。

取得所有主題

作業識別碼：: GetAllTopics

從連線的機器人執行個體取得所有主題。

參數

名稱	機碼	必要	類型	Description
按專家篩選	filterByExpert		string	按專家篩選

傳回

名稱	路徑	類型	Description
主題	topics	array of string

取得所有問答集

作業識別碼：: GetAllAnswers

從連線的執行個體取得所有答案。

參數

名稱	機碼	類型	Description
依主題篩選（包含）	filterByTopic	string	依主題篩選（包含）
依簡短說明篩選（包含）	filterByShortDescription	string	依簡短說明篩選（包含）
按問題文本過濾（包含）	filterByQuestionText	string	按問題文本過濾（包含）
按答案文本過濾（包含）	filterByAnswerText	string	按答案文本過濾（包含）

傳回

名稱	路徑	類型	Description
Answers	answers	array of Answer

取得某個主題的專家

作業識別碼：: GetExperts

從連線的執行個體取得所有暴露。

參數

名稱	機碼	必要	類型	Description
主題	topic	True	string	主題

傳回

名稱	路徑	類型	Description
專家	expertEmails	array of string

取得開放式門票

作業識別碼：: GetOpenTickets

從連線的執行個體取得所有開啟的票證。

參數

名稱	機碼	類型	Description
依開啟持續時間篩選（最小）	filterByHoursSinceOpened	integer	僅獲取開放時間超過 x 小時的門票。
依開啟持續時間篩選（最大）	filterByHoursSinceOpenedMax	integer	僅獲取開放時間少於 x 小時的門票。
按主題篩選	filterByTopic	string	按主題篩選
按專家篩選	filterByExpertEmail	string	按專家篩選

傳回

名稱	路徑	類型	Description
罰單	tickets	array of Ticket

向 COSMO Bot 提問

作業識別碼：: AskQuestion

機器人將搜索知識庫並返回最匹配的答案。也會傳回分數。

參數

名稱	機碼	必要	類型	Description
Question	question	True	string
分數閾值	scoreThreshold		integer	返回答案的最低分數。
用戶電子郵件	userEmail		string

傳回

名稱	路徑	類型	Description
找到答案	foundAnswer	boolean	COSMO Bot 是否找到與問題相符的答案。
是 Shadow-Answer	isSubAnswer	boolean	傳回的答案是否為子答案。
問題被翻譯了	isTranslated	boolean	問題和返回的答案是否已翻譯。
回答	answer	Answer
Score	score	integer	機器人對傳回答案正確的信心程度。

將專家新增至主題

作業識別碼：: AddExpert

機器人會將專家新增至提供的主題。

參數

名稱	機碼	必要	類型	Description
主題	topic	True	string
專家電子郵件	expertEmail	True	string

建立問答集的陰影複製

作業識別碼：: AddSubAnswer

為簡短描述所指定的問答集新增陰影複製。謹！更新答案時，會刪除這些陰影副本。因此，建議使用「當問題-答案集更新時」觸發程式自動呼叫此動作。

參數

名稱	機碼	必要	類型
原始答案的簡短描述	shortDescription	True	string
Shadow Copy的簡短描述	subShortDescription	True	string
提問	subQuestions	True	array of string
答案文字	subAnswerText	True	string

從主題中移除專家

作業識別碼：: RemoveExpert

機器人將從提供的主題中刪除專家。如果未提供主題，則專家將從所有主題中刪除。

參數

名稱	機碼	必要	類型	Description
專家電子郵件	expertEmail	True	string
主題	topic		string

新增主題

作業識別碼：: AddTopic

將新主題新增至連線的執行個體。

參數

名稱	機碼	必要	類型
主題名稱	name	True	string
Description	description	True	string
專家電子郵件	expertEmails	True	array of string

新增問答集

作業識別碼：: AddAnswer

將新的問答集新增至連線的執行個體。

參數

名稱	機碼	必要	類型
主題	topic	True	string
簡短描述	shortDescription	True	string
提問	questions	True	array of string
答案文字	answerText	True	string
用戶電子郵件	userEmail		string

編輯現有的問答集

作業識別碼：: EditAnswer

從連線的執行個體編輯現有的問答集。

參數

名稱	機碼	必要	類型
現有集合的簡短描述	shortDescription	True	string
更新主題	newTopic		string
更新的簡短描述	newShortDescription		string
更新的問題	newQuestions		array of string
更新的答案文本	newAnswerText		string
用戶電子郵件	userEmail		string

翻譯（降價友好）

作業識別碼：: Translate

翻譯給定的文本，同時遵守 COSMO Bot 方言 Markdown 語法。

參數

名稱	機碼	必要	類型	Description
目標語言	targetLanguageCode	True	string	目標語言代碼（例如：fr）。
文字	inputText	True	string	要翻譯的文字。

傳回

名稱	路徑	類型	Description
翻譯文本	outputText	string

轉換 COSMO 機器人腳本

作業識別碼：: ParseText

透過 COSMO Bot 腳本剖析器執行指定的文字。

參數

名稱	機碼	必要	類型	Description
輸入文字	inputText	True	string
輸出格式	outputFormat	True	string

傳回

名稱	路徑	類型	Description
輸出文字	outputText	string	COSMO Bot 腳本剖析器所傳回的剖析文字。

重新命名現有主題

作業識別碼：: RenameTopic

從連線的執行個體重新命名現有主題。

參數

名稱	機碼	必要	類型	Description
主題名稱	name	True	string	要重新命名的現有主題的名稱。
新主題名稱	newName	True	string	主題將重新命名的名稱。

開啟工單（意見反應）

作業識別碼：: OpenTicketFeedback

在連線的執行個體上開啟類型為意見回饋的新票證。

參數

名稱	機碼	必要	類型
用戶電子郵件	userEmail	True	string
使用者提出的問題	queryText	True	string
答案的簡短描述	answerShortDescription	True	string
關於答案的反饋	feedbackText	True	string

傳回

名稱	路徑	類型	Description
券	ticket	Ticket

開票（問題）

作業識別碼：: OpenTicketQuestion

在連線的執行個體上開啟新票證。

參數

名稱	機碼	必要	類型
用戶電子郵件	userEmail	True	string
使用者提出的問題	queryText	True	string
這個問題可能屬於的主題	topic		string

傳回

名稱	路徑	類型	Description
券	ticket	Ticket

關閉票證

作業識別碼：: CloseTicket

關閉已連線執行個體上開啟的票證。

參數

名稱	機碼	必要	類型
唯一票證 ID	ticketId	True	string
處理票證之使用者的電子郵件	editorEmail	True	string
將傳送給使用者的註解	editorComment	True	string

觸發程序

建立或修改問答集時	建立或修改問答集時。
建立新的問答集時	建立新的問答集時。
建立新票證時	建立新票證時。
當使用者提出問題時	當使用者提出問題時。
當票證的主題更新時	當現有票證的主題更新時。
解決票證時	當現有票證得到解決時。

建立或修改問答集時

作業識別碼：: OnUpdateAnswer

建立或修改問答集時。

傳回

名稱	路徑	類型	Description
回答	answer	Answer

建立新的問答集時

作業識別碼：: OnNewAnswer

建立新的問答集時。

傳回

名稱	路徑	類型	Description
回答	answer	Answer

建立新票證時

作業識別碼：: OnNewTicket

建立新票證時。

傳回

名稱	路徑	類型	Description
券	ticket	Ticket

當使用者提出問題時

作業識別碼：: OnAskedQuestion

當使用者提出問題時。

傳回

名稱	路徑	類型	Description
用戶電子郵件	userEmail	string
使用者提出的問題	queryText	string
找到答案	foundAnswer	boolean	COSMO Bot是否找到與使用者問題相符的答案。
回答	answer	Answer

當票證的主題更新時

作業識別碼：: OnUpdatedTicketTopic

當現有票證的主題更新時。

傳回

名稱	路徑	類型	Description
券	ticket	Ticket

解決票證時

作業識別碼：: OnResolvedTicket

當現有票證得到解決時。

傳回

名稱	路徑	類型
券	ticket	Ticket
編輯電子郵件	editorEmail	string
編輯點評	editorComment	string
原始查詢的深層連結	queryUrl	string

定義

回答

名稱	路徑	類型
主題	topic	string
簡短描述	shortDescription	string
提問	questions	array of string
答案文字	answerText	string
上次修改此答案的日期和時間	modifiedAt	date-time
修改人	modifiedBy	string

券

名稱	路徑	類型	Description
唯一票證 ID	ticketId	string
主題	topic	string
處理工單的深層連結	ticketUrl	string
請求者電子郵件	requesterEmail	string
專家電子郵件	expertEmails	array of string
使用者提出的問題	queryText	string
使用者提交的意見反應	feedbackText	string	如果此票證不是反饋，則該票證是空的。
使用者提出問題後收到的答案的簡短描述	answerShortDescription	string	如果此票證不是反饋，則該票證是空的。
使用者提出問題後收到的答案	answerText	string	如果此票證不是反饋，則該票證是空的。
建立票證的日期和時間	createdAt	date-time

共用方式為