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 に質問する
ボットは、サポート情報を検索し、最も一致する回答を返します。 スコアも返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
質問
|
question | True | string | |
|
スコアのしきい値
|
scoreThreshold | integer |
返される回答の最小スコア。 |
|
|
ユーザーの電子メール
|
userEmail | string |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
回答が見つかりました
|
foundAnswer | boolean |
COSMO Bot が質問に一致する回答を見つけたかどうか。 |
|
シャドウ回答
|
isSubAnswer | boolean |
返された回答がサブ回答であるかどうか。 |
|
質問は翻訳されましたか
|
isTranslated | boolean |
質問と返された回答が翻訳されたかどうか。 |
|
応答
|
answer | Answer | |
|
スコア
|
score | integer |
返された回答の正しさにおけるボットの信頼度を示します。 |
COSMO Bot スクリプトを変換する
指定されたテキストを COSMO Bot スクリプト パーサーで実行します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
入力テキスト
|
inputText | True | string | |
|
出力形式
|
outputFormat | True | string |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力テキスト
|
outputText | string |
COSMO Bot スクリプト パーサーによって返された解析済みのテキスト。 |
すべてのトピックを取得する
接続されているボット インスタンスからすべてのトピックを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
エキスパートでフィルター処理する
|
filterByExpert | string |
エキスパートでフィルター処理する |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
トピック
|
topics | array of string |
すべての質問と回答のセットを取得
接続されているインスタンスからすべての回答を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
トピックでフィルター処理する (含める)
|
filterByTopic | string |
トピックでフィルター処理する (含める) |
|
|
簡単な説明でフィルター処理する (含める)
|
filterByShortDescription | string |
簡単な説明でフィルター処理する (含める) |
|
|
質問テキストでフィルター処理する (含める)
|
filterByQuestionText | string |
質問テキストでフィルター処理する (含める) |
|
|
回答テキストでフィルター処理する (含める)
|
filterByAnswerText | string |
回答テキストでフィルター処理する (含める) |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
回答
|
answers | array of Answer |
オープンなチケットを取得する
接続されているインスタンスからすべてのオープンなチケットを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
オープンな期間でフィルター処理する (最小)
|
filterByHoursSinceOpened | integer |
オープンな状態が x 時間よりも長いチケットのみを取得します。 |
|
|
オープンな期間でフィルター処理する (最大)
|
filterByHoursSinceOpenedMax | integer |
オープンな状態が x 時間よりも短いチケットのみを取得します。 |
|
|
トピックでフィルター処理する
|
filterByTopic | string |
トピックでフィルター処理する |
|
|
エキスパートでフィルター処理する
|
filterByExpertEmail | string |
エキスパートでフィルター処理する |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
チケット
|
tickets | array of Ticket |
グローバル設定を取得する
接続されたインスタンスからグローバル設定を取得します。
戻り値
チケットを閉じる
接続されているインスタンスのオープン チケットを閉じます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
一意のチケット ID
|
ticketId | True | string | |
|
チケットを処理したユーザーのメール
|
editorEmail | True | string | |
|
ユーザーに送信されるコメント
|
editorComment | True | string |
チケットを開く (フィードバック)
接続されたインスタンスで種類がフィードバックの新しいチケットを開きます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ユーザーの電子メール
|
userEmail | True | string | |
|
ユーザーからの質問
|
queryText | True | string | |
|
回答の簡単な説明
|
answerShortDescription | True | string | |
|
回答に関するフィードバック
|
feedbackText | True | string |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
チケット
|
ticket | Ticket |
チケットを開く (質問)
接続されているインスタンスの新しいチケットを開きます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ユーザーの電子メール
|
userEmail | True | string | |
|
ユーザーからの質問
|
queryText | True | string | |
|
この質問が属する可能性が高いトピック
|
topic | string |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
チケット
|
ticket | Ticket |
トピックからエキスパートを削除する
ボットは、提供されたトピックからエキスパートを削除します。 トピックが指定されていない場合、エキスパートはすべてのトピックから削除されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
エキスパート メール
|
expertEmail | True | string | |
|
トピック
|
topic | string |
トピックにエキスパートを追加する
ボットは、提供されたトピックにエキスパートを追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
トピック
|
topic | True | string | |
|
エキスパート メール
|
expertEmail | True | string |
トピックの専門家を取得する
接続されているインスタンスからすべての専門家を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
トピック
|
topic | True | string |
トピック |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
専門家
|
expertEmails | array of string |
トピックを取得
接続されているインスタンスから特定のトピックを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
トピック名
|
topicName | True | string |
トピック名 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
件名
|
topic.name | string | |
|
内容
|
topic.description | string |
新しいトピックを追加する
接続されたインスタンスに新しいトピックを追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
トピック名
|
name | True | string | |
|
内容
|
description | True | string | |
|
エキスパート メール
|
expertEmails | True | array of string |
新しい質問と回答のセットを追加する
接続されたインスタンスに新しい質問と回答のセットを追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
トピック
|
topic | True | string | |
|
短い説明:
|
shortDescription | True | string | |
|
質問
|
questions | True | array of string | |
|
回答テキスト
|
answerText | True | string | |
|
ユーザーの電子メール
|
userEmail | string |
既存のトピックの名前を変更する
接続されているインスタンスから既存のトピックの名前を変更します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
トピック名
|
name | True | string |
名前を変更する既存のトピックの名前。 |
|
新しいトピック名
|
newName | True | string |
予定されている名前変更後のトピックの名前。 |
既存の質問と回答のセットを編集する
接続されたインスタンスから既存の質問と回答のセットを編集します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
既存のセットの簡単な説明
|
shortDescription | True | string | |
|
更新済みのトピック
|
newTopic | string | ||
|
更新済みの簡単な説明
|
newShortDescription | string | ||
|
更新済みの質問
|
newQuestions | array of string | ||
|
更新済みの回答テキスト
|
newAnswerText | string | ||
|
ユーザーの電子メール
|
userEmail | string |
翻訳 (マークダウン対応)
COSMO Bot 言語マークダウン構文を尊重すると同時に、指定されたテキストを翻訳します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ターゲット言語
|
targetLanguageCode | True | string |
翻訳先言語のコード (例: フランス語)。 |
|
テキスト
|
inputText | True | string |
翻訳するテキスト。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
翻訳されたテキスト
|
outputText | string |
質問と回答のセットのシャドウ コピーを作成する
簡単な説明で指定された質問と回答のセットに新しいシャドウ コピーを追加します。 ご注意! これらのシャドウ コピーは、回答が更新されると削除されます。 したがって、"質問と回答のセットが更新されたとき" というトリガーを使用して、このアクションを自動的に呼び出すことをお勧めします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
元の回答の簡単な説明
|
shortDescription | True | string | |
|
シャドウ コピーの簡単な説明
|
subShortDescription | True | string | |
|
質問
|
subQuestions | True | array of string | |
|
回答テキスト
|
subAnswerText | True | string |
質問と回答のセットを削除する
接続されたインスタンスから既存の質問と回答のセットを削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
短い説明:
|
shortDescription | True | string |
トリガー
| チケットが解決されたとき |
既存のチケットが解決されたとき。 |
| チケットのトピックが更新されたとき |
既存のチケットのトピックが更新されたとき。 |
| ユーザーが質問したとき |
ユーザーが質問したとき。 |
| 新しいチケットが作成されるとき |
新しいチケットが作成されるとき。 |
| 新しい質問と回答のセットが作成されたとき |
新しい質問と回答のセットが作成されたとき。 |
| 質問と回答のセットが作成または変更されたとき |
質問と回答のセットが作成または変更されたとき。 |
チケットが解決されたとき
既存のチケットが解決されたとき。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
チケット
|
ticket | Ticket | |
|
エディター メール
|
editorEmail | string | |
|
エディター コメント
|
editorComment | string | |
|
元のクエリへのディープ リンク
|
queryUrl | string |
チケットのトピックが更新されたとき
既存のチケットのトピックが更新されたとき。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
チケット
|
ticket | Ticket |
ユーザーが質問したとき
ユーザーが質問したとき。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ユーザーの電子メール
|
userEmail | string | |
|
ユーザーからの質問
|
queryText | string | |
|
回答が見つかりました
|
foundAnswer | boolean |
COSMO Bot がユーザーの質問に一致する回答を見つけたかどうか。 |
|
応答
|
answer | Answer |
新しいチケットが作成されるとき
新しいチケットが作成されるとき。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
チケット
|
ticket | Ticket |
新しい質問と回答のセットが作成されたとき
新しい質問と回答のセットが作成されたとき。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
応答
|
answer | Answer |
質問と回答のセットが作成または変更されたとき
質問と回答のセットが作成または変更されたとき。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
応答
|
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 |