COSMO Bot (プレビュー)

COSMO Bot は、日常生活で効率をさらに高めることによりビジネスの成功を促進します。 今日の標準的な質問に答えているとすれば、時間を無駄にしていることになります。 顧客と接触を取ること、これは多くの場合、互いを理解し、リレーションシップを確立するための良い機会です。 しかし、内部では、従業員から従業員に対して、または単にやることが多すぎるときは、だれもが行う余裕はありません。 このコネクタを使用すると、ボットの機能を拡張し、他のシステムを統合できます。

このコネクタは、次の製品および地域で利用可能です。

Service	クラス	地域
Logic Apps	標準	以下を除くすべての Logic Apps 地域 :      -   Azure 政府の地域      -   Azure 中国の地域      -   国防総省 (DoD)
Power Automate	プレミアム	以下を除くすべての Power Automate 地域 :      -   米国政府 (GCC)      -   米国政府 (GCC High)      -   21Vianet が運用する中国のクラウド      -   国防総省 (DoD)
Power Apps	プレミアム	以下を除くすべての Power Apps 地域 :      -   米国政府 (GCC)      -   米国政府 (GCC High)      -   21Vianet が運用する中国のクラウド      -   米国国防総省 (DoD)

お問い合わせ先
件名	COSMO CONSULT サポート
[URL]	https://de.cosmoconsult.com/service/support/
メール	support.west@cosmoconsult.com

Connector Metadata
発行者	COSMO CONSULT GmbH
Web サイト	https://cosma.link/cc-bot
プライバシー ポリシー	https://www.cosmoconsult.com/data-protection/
カテゴリ	AI; コミュニケーション

前提条件

このコネクタを使用するには、COSMO Bot インスタンスへの管理者アクセス権を持っている必要があります。 COSMO Bot とは COSMO Bot インスタンスを取得する方法

資格情報の入手方法

COSMO Bot インスタンスへの管理者アクセス権を取得したら、チャット インターフェイス (例: https://cosma.cosmoconsult.com/) に移動し、右上隅にある "管理" をクリックして "管理" タブに切り替えます。 "API キー" に移動し、新しいキーを作成するか、既存のキーをコピーします。

接続の作成

コネクタは、次の認証タイプをサポートしています:

既定	接続を作成するためのパラメーター。	すべての地域	共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

件名	タイプ	内容	必要
ボット インスタンスの URL	文字列	ボット インスタンスにアクセスできる URL	真
API キー	securestring	このボット インスタンスにアクセスするための API キー	真

調整制限

名前	呼び出し	更新期間
接続ごとの API 呼び出し	100	60 秒

アクション

COSMO Bot に質問する	ボットは、サポート情報を検索し、最も一致する回答を返します。 スコアも返します。
COSMO Bot スクリプトを変換する	指定されたテキストを COSMO Bot スクリプト パーサーで実行します。
すべてのトピックを取得する	接続されているボット インスタンスからすべてのトピックを取得します。
すべての質問と回答のセットを取得	接続されているインスタンスからすべての回答を取得します。
オープンなチケットを取得する	接続されているインスタンスからすべてのオープンなチケットを取得します。
グローバル設定を取得する	接続されたインスタンスからグローバル設定を取得します。
チケットを閉じる	接続されているインスタンスのオープン チケットを閉じます。
チケットを開く (フィードバック)	接続されたインスタンスで種類がフィードバックの新しいチケットを開きます。
チケットを開く (質問)	接続されているインスタンスの新しいチケットを開きます。
トピックからエキスパートを削除する	ボットは、提供されたトピックからエキスパートを削除します。 トピックが指定されていない場合、エキスパートはすべてのトピックから削除されます。
トピックにエキスパートを追加する	ボットは、提供されたトピックにエキスパートを追加します。
トピックの専門家を取得する	接続されているインスタンスからすべての専門家を取得します。
トピックを取得	接続されているインスタンスから特定のトピックを取得します。
新しいトピックを追加する	接続されたインスタンスに新しいトピックを追加します。
新しい質問と回答のセットを追加する	接続されたインスタンスに新しい質問と回答のセットを追加します。
既存のトピックの名前を変更する	接続されているインスタンスから既存のトピックの名前を変更します。
既存の質問と回答のセットを編集する	接続されたインスタンスから既存の質問と回答のセットを編集します。
翻訳 (マークダウン対応)	COSMO Bot 言語マークダウン構文を尊重すると同時に、指定されたテキストを翻訳します。
質問と回答のセットのシャドウ コピーを作成する	簡単な説明で指定された質問と回答のセットに新しいシャドウ コピーを追加します。 ご注意! これらのシャドウ コピーは、回答が更新されると削除されます。 したがって、"質問と回答のセットが更新されたとき" というトリガーを使用して、このアクションを自動的に呼び出すことをお勧めします。
質問と回答のセットを削除する	接続されたインスタンスから既存の質問と回答のセットを削除します。

COSMO Bot に質問する

操作 ID:

AskQuestion

ボットは、サポート情報を検索し、最も一致する回答を返します。 スコアも返します。

パラメーター

名前	キー	必須	型	説明
質問	question	True	string
スコアのしきい値	scoreThreshold		integer	返される回答の最小スコア。
ユーザーの電子メール	userEmail		string

戻り値

名前	パス	型	説明
回答が見つかりました	foundAnswer	boolean	COSMO Bot が質問に一致する回答を見つけたかどうか。
シャドウ回答	isSubAnswer	boolean	返された回答がサブ回答であるかどうか。
質問は翻訳されましたか	isTranslated	boolean	質問と返された回答が翻訳されたかどうか。
応答	answer	Answer
スコア	score	integer	返された回答の正しさにおけるボットの信頼度を示します。

COSMO Bot スクリプトを変換する

操作 ID:

ParseText

指定されたテキストを COSMO Bot スクリプト パーサーで実行します。

パラメーター

名前	キー	必須	型	説明
入力テキスト	inputText	True	string
出力形式	outputFormat	True	string

戻り値

名前	パス	型	説明
出力テキスト	outputText	string	COSMO Bot スクリプト パーサーによって返された解析済みのテキスト。

すべてのトピックを取得する

操作 ID:

GetAllTopics

接続されているボット インスタンスからすべてのトピックを取得します。

パラメーター

名前	キー	必須	型	説明
エキスパートでフィルター処理する	filterByExpert		string	エキスパートでフィルター処理する

戻り値

名前	パス	型	説明
トピック	topics	array of string

すべての質問と回答のセットを取得

操作 ID:

GetAllAnswers

接続されているインスタンスからすべての回答を取得します。

パラメーター

名前	キー	必須	型	説明
トピックでフィルター処理する (含める)	filterByTopic		string	トピックでフィルター処理する (含める)
簡単な説明でフィルター処理する (含める)	filterByShortDescription		string	簡単な説明でフィルター処理する (含める)
質問テキストでフィルター処理する (含める)	filterByQuestionText		string	質問テキストでフィルター処理する (含める)
回答テキストでフィルター処理する (含める)	filterByAnswerText		string	回答テキストでフィルター処理する (含める)

戻り値

名前	パス	型	説明
回答	answers	array of Answer

オープンなチケットを取得する

操作 ID:

GetOpenTickets

接続されているインスタンスからすべてのオープンなチケットを取得します。

パラメーター

名前	キー	必須	型	説明
オープンな期間でフィルター処理する (最小)	filterByHoursSinceOpened		integer	オープンな状態が x 時間よりも長いチケットのみを取得します。
オープンな期間でフィルター処理する (最大)	filterByHoursSinceOpenedMax		integer	オープンな状態が x 時間よりも短いチケットのみを取得します。
トピックでフィルター処理する	filterByTopic		string	トピックでフィルター処理する
エキスパートでフィルター処理する	filterByExpertEmail		string	エキスパートでフィルター処理する

戻り値

名前	パス	型	説明
チケット	tickets	array of Ticket

グローバル設定を取得する

操作 ID:

GetGlobalSettings

接続されたインスタンスからグローバル設定を取得します。

戻り値

この操作の出力は状況に応じて変わります。

チケットを閉じる

操作 ID:

CloseTicket

接続されているインスタンスのオープン チケットを閉じます。

パラメーター

名前	キー	必須	型	説明
一意のチケット ID	ticketId	True	string
チケットを処理したユーザーのメール	editorEmail	True	string
ユーザーに送信されるコメント	editorComment	True	string

チケットを開く (フィードバック)

操作 ID:

OpenTicketFeedback

接続されたインスタンスで種類がフィードバックの新しいチケットを開きます。

パラメーター

名前	キー	必須	型	説明
ユーザーの電子メール	userEmail	True	string
ユーザーからの質問	queryText	True	string
回答の簡単な説明	answerShortDescription	True	string
回答に関するフィードバック	feedbackText	True	string

戻り値

名前	パス	型	説明
チケット	ticket	Ticket

チケットを開く (質問)

操作 ID:

OpenTicketQuestion

接続されているインスタンスの新しいチケットを開きます。

パラメーター

名前	キー	必須	型	説明
ユーザーの電子メール	userEmail	True	string
ユーザーからの質問	queryText	True	string
この質問が属する可能性が高いトピック	topic		string

戻り値

名前	パス	型	説明
チケット	ticket	Ticket

トピックからエキスパートを削除する

操作 ID:

RemoveExpert

ボットは、提供されたトピックからエキスパートを削除します。 トピックが指定されていない場合、エキスパートはすべてのトピックから削除されます。

パラメーター

名前	キー	必須	型	説明
エキスパート メール	expertEmail	True	string
トピック	topic		string

トピックにエキスパートを追加する

操作 ID:

AddExpert

ボットは、提供されたトピックにエキスパートを追加します。

パラメーター

名前	キー	必須	型	説明
トピック	topic	True	string
エキスパート メール	expertEmail	True	string

トピックの専門家を取得する

操作 ID:

GetExperts

接続されているインスタンスからすべての専門家を取得します。

パラメーター

名前	キー	必須	型	説明
トピック	topic	True	string	トピック

戻り値

名前	パス	型	説明
専門家	expertEmails	array of string

トピックを取得

操作 ID:

GetTopic

接続されているインスタンスから特定のトピックを取得します。

パラメーター

名前	キー	必須	型	説明
トピック名	topicName	True	string	トピック名

戻り値

名前	パス	型	説明
件名	topic.name	string
内容	topic.description	string

新しいトピックを追加する

操作 ID:

AddTopic

接続されたインスタンスに新しいトピックを追加します。

パラメーター

名前	キー	必須	型	説明
トピック名	name	True	string
内容	description	True	string
エキスパート メール	expertEmails	True	array of string

新しい質問と回答のセットを追加する

操作 ID:

AddAnswer

接続されたインスタンスに新しい質問と回答のセットを追加します。

パラメーター

名前	キー	必須	型	説明
トピック	topic	True	string
短い説明:	shortDescription	True	string
質問	questions	True	array of string
回答テキスト	answerText	True	string
ユーザーの電子メール	userEmail		string

既存のトピックの名前を変更する

操作 ID:

RenameTopic

接続されているインスタンスから既存のトピックの名前を変更します。

パラメーター

名前	キー	必須	型	説明
トピック名	name	True	string	名前を変更する既存のトピックの名前。
新しいトピック名	newName	True	string	予定されている名前変更後のトピックの名前。

既存の質問と回答のセットを編集する

操作 ID:

EditAnswer

接続されたインスタンスから既存の質問と回答のセットを編集します。

パラメーター

名前	キー	必須	型	説明
既存のセットの簡単な説明	shortDescription	True	string
更新済みのトピック	newTopic		string
更新済みの簡単な説明	newShortDescription		string
更新済みの質問	newQuestions		array of string
更新済みの回答テキスト	newAnswerText		string
ユーザーの電子メール	userEmail		string

翻訳 (マークダウン対応)

操作 ID:

Translate

COSMO Bot 言語マークダウン構文を尊重すると同時に、指定されたテキストを翻訳します。

パラメーター

名前	キー	必須	型	説明
ターゲット言語	targetLanguageCode	True	string	翻訳先言語のコード (例: フランス語)。
テキスト	inputText	True	string	翻訳するテキスト。

戻り値

名前	パス	型	説明
翻訳されたテキスト	outputText	string

質問と回答のセットのシャドウ コピーを作成する

操作 ID:

AddSubAnswer

簡単な説明で指定された質問と回答のセットに新しいシャドウ コピーを追加します。 ご注意! これらのシャドウ コピーは、回答が更新されると削除されます。 したがって、"質問と回答のセットが更新されたとき" というトリガーを使用して、このアクションを自動的に呼び出すことをお勧めします。

パラメーター

名前	キー	必須	型	説明
元の回答の簡単な説明	shortDescription	True	string
シャドウ コピーの簡単な説明	subShortDescription	True	string
質問	subQuestions	True	array of string
回答テキスト	subAnswerText	True	string

質問と回答のセットを削除する

操作 ID:

DeleteAnswer

接続されたインスタンスから既存の質問と回答のセットを削除します。

パラメーター

名前	キー	必須	型	説明
短い説明:	shortDescription	True	string

トリガー

チケットが解決されたとき	既存のチケットが解決されたとき。
チケットのトピックが更新されたとき	既存のチケットのトピックが更新されたとき。
ユーザーが質問したとき	ユーザーが質問したとき。
新しいチケットが作成されるとき	新しいチケットが作成されるとき。
新しい質問と回答のセットが作成されたとき	新しい質問と回答のセットが作成されたとき。
質問と回答のセットが作成または変更されたとき	質問と回答のセットが作成または変更されたとき。

チケットが解決されたとき

操作 ID:

OnResolvedTicket

既存のチケットが解決されたとき。

戻り値

名前	パス	型	説明
チケット	ticket	Ticket
エディター メール	editorEmail	string
エディター コメント	editorComment	string
元のクエリへのディープ リンク	queryUrl	string

チケットのトピックが更新されたとき

操作 ID:

OnUpdatedTicketTopic

既存のチケットのトピックが更新されたとき。

戻り値

名前	パス	型	説明
チケット	ticket	Ticket

ユーザーが質問したとき

操作 ID:

OnAskedQuestion

ユーザーが質問したとき。

戻り値

名前	パス	型	説明
ユーザーの電子メール	userEmail	string
ユーザーからの質問	queryText	string
回答が見つかりました	foundAnswer	boolean	COSMO Bot がユーザーの質問に一致する回答を見つけたかどうか。
応答	answer	Answer

新しいチケットが作成されるとき

操作 ID:

OnNewTicket

新しいチケットが作成されるとき。

戻り値

名前	パス	型	説明
チケット	ticket	Ticket

新しい質問と回答のセットが作成されたとき

操作 ID:

OnNewAnswer

新しい質問と回答のセットが作成されたとき。

戻り値

名前	パス	型	説明
応答	answer	Answer

質問と回答のセットが作成または変更されたとき

操作 ID:

OnUpdateAnswer

質問と回答のセットが作成または変更されたとき。

戻り値

名前	パス	型	説明
応答	answer	Answer

定義

応答

名前	パス	型	説明
トピック	topic	string
短い説明:	shortDescription	string
質問	questions	array of string
回答テキスト	answerText	string
この回答が最後に変更された日時	modifiedAt	date-time
変更者	modifiedBy	string

チケット

名前	パス	型	説明
一意のチケット ID	ticketId	string
トピック	topic	string
チケットを処理するためのディープ リンク	ticketUrl	string
要求者のメール	requesterEmail	string
エキスパート メール	expertEmails	array of string
ユーザーからの質問	queryText	string
ユーザーから送信されたフィードバック	feedbackText	string	このチケットがフィードバックでない場合は空白です。
ユーザーが質問した後に受信した回答の簡単な説明	answerShortDescription	string	このチケットがフィードバックでない場合は空白です。
ユーザーが質問した後に受信した回答	answerText	string	このチケットがフィードバックでない場合は空白です。
チケットが作成された日時	createdAt	date-time