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