次の方法で共有


AtBot ロジック

AtBot は、プログラミングエクスペリエンスなしで会話型 UI をすばやく作成できるコードなしのボット構築サービスです。

このコネクタは、次の製品とリージョンで使用できます。

サービス クラス リージョン
コピロット スタジオ Standard 次を除くすべての Power Automate リージョン :
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
ロジック アプリ Standard 次を除くすべての Logic Apps リージョン :
     - Azure China リージョン
     - 米国国防総省 (DoD)
Power Apps Standard 次を除くすべての Power Apps リージョン :
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
Power Automate Standard 次を除くすべての Power Automate リージョン :
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
お問い合わせ
名前 AtBot のサポート
URL https://admin.atbot.io/Docs
Email support@atbot.io
コネクタ メタデータ
Publisher H3 Solutions Inc.
Website https://www.atbot.io
プライバシー ポリシー https://admin.atbot.io/privacy
カテゴリ 人工知能;生産性

AtBot Logic コネクタは、AtBot サービスに組み込まれているボットのボット スキルを作成するために使用されます。 コネクタのアクションを使用すると、ボットの複雑な会話スキルを作成し、追加のコネクタを使用して他のサービスに接続できます。 AtBot はMicrosoft Teamsで無料で試すことができます。Premium バージョンを使用して、追加のプラットフォームでカスタム ボットを構築できます。 詳細については、AtBot の Web サイトを参照してください。

[前提条件]

無料版の AtBot を使用するには、Microsoft Teams アカウントを持ち、 アプリ ストアから AtBot ボットをダウンロードしている必要があります。

独自のカスタム ボットを構築できる Premium バージョンを使用するには、 AtBot Premium にサインアップする必要があります。 Premium にサインアップすると、サービスを試すために 25 ドルのクレジットが付与されます。

資格情報を取得する方法

常に、Microsoft Entra ID の職場または学校アカウントを使用して AtBot コネクタにログインします。

既知の問題と制限事項

キーワード トリガーで LUIS のサポートが使い果たされました。 LUIS 意図ベクターを使用して、自然言語を認識するスキルを作成してください。

調整制限

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

アクション

2 つ以上の会話間のチャット ブリッジを登録する

この操作は、2 人以上のユーザー間のチャット ブリッジを開始するために使用されます。

アダプティブ カード セットの返信を送信する

この操作は、フローをトリガーしたアクティビティにアダプティブ カード セット応答を送信するために使用されます。 このセットは、リストフォームまたはカルーセルフォームのいずれかになります。

アダプティブ カードの生成

この操作は、後でカードの一覧またはカルーセルを表示するために使用するアダプティブ カードを生成するために使用されます。

アダプティブ カードの返信を送信する

この操作は、フローをトリガーしたアクティビティにアダプティブ カード応答を送信するために使用されます。

イベントの送信

この操作は、ボット クライアントにイベントを送信するために使用されます。

タブに送信されたアダプティブ カードを更新する

この操作は、タブに送信されたカードを更新するために使用されます。

ボット メモリから削除する

この操作は、ボット内のメモリから情報の一部を削除するために使用されます。

ボットのメモリに保存する

この操作は、ボット内のメモリに情報の一部を保存するために使用されます。

ユーザーから datetime 応答を取得する

この操作は、ユーザーに datetime 入力を要求するために使用されます。

ユーザーからアダプティブ カードの応答を取得する

この操作は、アダプティブ カードを使用してユーザーに入力を求めるために使用されます。

ユーザーからメモリ応答を取得する

この操作は、ボット のメモリ入力をユーザーに要求するために使用されます。

ユーザーからユーザーの応答を取得する

この操作は、ユーザーにユーザー選択ウィンドウの入力を求めるために使用されます。

ユーザーから応答を取得する

この操作は、ユーザーに入力を求めるために使用されます。

ユーザーから意図ベクトル応答を取得する

この操作は、ユーザーに NLP 入力を要求するために使用されます。

ユーザーから選択肢の応答を取得する

この操作は、ユーザーに選択の入力を求めるために使用されます。

ユーザーから選択肢リストの応答を取得する

この操作は、選択リストの入力をユーザーに要求するために使用されます。

新しいグループ会話を開始する

この操作は、チャネルで新しいグループ会話を開始するために使用されます。

新しいプライベート会話を開始する

この操作は、ユーザーとの新しいプライベート会話を開始するために使用されます。

種類別にボット メモリ項目を取得する

すべてのボット メモリ項目を種類別に取得します。

返信を送信する

この操作は、フローをトリガーしたアクティビティに応答を送信するために使用されます。

2 つ以上の会話間のチャット ブリッジを登録する

この操作は、2 人以上のユーザー間のチャット ブリッジを開始するために使用されます。

パラメーター

名前 キー 必須 説明
filters
filters array of string
headers
headers object
プロパティ
properties object
ユーザー名
chatUserName True string

チャット ユーザーの表示名。

開始メッセージ
chatInitiationMessage string

チャット ブリッジが確立されたときにこのユーザーに送信するメッセージ。

応答アクティビティ
activityJson True string

チャット ユーザーの応答アクティビティ。

[チャットの終了] コマンド
endBridgeCommand True string

ボットに送信してチャット ブリッジを終了するキーワード コマンド。

アイドル タイムアウト
idleTimeoutDuration True integer

タイムアウトをトリガーするアイドル 状態のアクティビティの期間 (分単位)。

戻り値

アダプティブ カード セットの返信を送信する

この操作は、フローをトリガーしたアクティビティにアダプティブ カード セット応答を送信するために使用されます。 このセットは、リストフォームまたはカルーセルフォームのいずれかになります。

パラメーター

名前 キー 必須 説明
アダプティブ カード セット
cards True object

カード セット オブジェクトを指定します。

表示スタイル
displayStyle True string

使用する表示スタイルを選択します。

応答アクティビティ
activityJson True string

ボットからの応答アクティビティ。

[表示] タブ
showInTab boolean

インライン チャットの代わりに、このカード セットをタブに表示します。

タブ ボタン ラベル
deepLinkButtonLabel string

タブに表示するためのボタン ラベル。

タブ ボタン メッセージ
deepLinkMessage string

タブに表示するときにボタンと共に送信するメッセージ。

戻り値

アダプティブ カードの生成

この操作は、後でカードの一覧またはカルーセルを表示するために使用するアダプティブ カードを生成するために使用されます。

パラメーター

名前 キー 必須 説明
選択されたアダプティブ カード
selectedCard True string

アダプティブ カードを選択します。

コンテンツ
content dynamic

戻り値

response
object

アダプティブ カードの返信を送信する

この操作は、フローをトリガーしたアクティビティにアダプティブ カード応答を送信するために使用されます。

パラメーター

名前 キー 必須 説明
選択されたアダプティブ カード
selectedCard True string

アダプティブ カードを選択します。

コンテンツ
content True dynamic

戻り値

イベントの送信

この操作は、ボット クライアントにイベントを送信するために使用されます。

パラメーター

名前 キー 必須 説明
応答アクティビティ
activityJson True string

ボットからの応答アクティビティ

イベント JSON
eventObject True object

チャット イベントで送信される JSON オブジェクト。

タブに送信されたアダプティブ カードを更新する

この操作は、タブに送信されたカードを更新するために使用されます。

パラメーター

名前 キー 必須 説明
アダプティブ カード
card True object

更新プログラムとして使用するカードを指定します。

応答アクティビティ
activityJson True string

ボットからの応答アクティビティ。

戻り値

ボット メモリから削除する

この操作は、ボット内のメモリから情報の一部を削除するために使用されます。

パラメーター

名前 キー 必須 説明
ユーザー プリンシパル名
user True string

メモリ項目を保存する対象のユーザー。

メモリの種類
type True string

メモリの種類。

価値
value True string

メモリ項目の値。

戻り値

ボットのメモリに保存する

この操作は、ボット内のメモリに情報の一部を保存するために使用されます。

パラメーター

名前 キー 必須 説明
ユーザー プリンシパル名
user True string

メモリ項目を保存する対象のユーザー。

メモリの種類
type True string

メモリの種類。

Title
title True string

メモリ項目のタイトル。

価値
value True string

メモリ項目の値。

戻り値

ユーザーから datetime 応答を取得する

この操作は、ユーザーに datetime 入力を要求するために使用されます。

パラメーター

名前 キー 必須 説明
filters
filters array of string
headers
headers object
プロパティ
properties object
日付スコープ
dateScope True string

日付値のスコープを選択します。

メッセージ
message True string

ユーザーに送信するメッセージを入力します。

応答アクティビティ
activityJson True string

ボットからの応答アクティビティ。

応答の受け入れ
acceptResponseFrom string

特定のユーザーまたは任意のユーザーからの応答を受け入れます。

分岐を許可する
allowBranching string

応答を提供する前に、ユーザーが分岐スキルをトリガーできるようにします。

チャットで表示する
showInChat boolean

Teams 通話の場合は、チャットでこのメッセージを表示します。 それ以外の場合、ボットはメッセージのみを読み上げられます。

戻り値

ユーザーからアダプティブ カードの応答を取得する

この操作は、アダプティブ カードを使用してユーザーに入力を求めるために使用されます。

パラメーター

名前 キー 必須 説明
選択されたアダプティブ カード
selectedCard True string

アダプティブ カードを選択します。

webHook
webHook dynamic

戻り値

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

ユーザーからメモリ応答を取得する

この操作は、ボット のメモリ入力をユーザーに要求するために使用されます。

パラメーター

名前 キー 必須 説明
filters
filters array of string
headers
headers object
プロパティ
properties object
メッセージ
message True string

ユーザーに送信するメッセージを入力します。

メモリの種類
type True string

一覧表示するメモリの種類を指定します。

応答アクティビティ
activityJson True string

ボットからの応答アクティビティ。

アイコン URL
icon string

選択項目ごとに表示するアイコンの絶対 URL を入力します。

応答の受け入れ
acceptResponseFrom string

特定のユーザーまたは任意のユーザーからの応答を受け入れます。

ターゲット ユーザー
targetUserMemory string

必要に応じて、ボットがメモリ項目をプルするユーザーの UPN を指定します。 空白のままにすると、スキルを開始したユーザーからメモリ項目がプルされます。 ボットから開始されたグループ会話の場合、Flow で認証されたユーザーからメモリ項目がプルされます。

分岐を許可する
allowBranching string

応答を提供する前に、ユーザーが分岐スキルをトリガーできるようにします。

チャットで表示する
showInChat boolean

Teams 通話の場合は、チャットでこのメッセージを表示します。 それ以外の場合、ボットはメッセージのみを読み上げられます。

戻り値

ユーザーからユーザーの応答を取得する

この操作は、ユーザーにユーザー選択ウィンドウの入力を求めるために使用されます。

パラメーター

名前 キー 必須 説明
filters
filters array of string
headers
headers object
プロパティ
properties object
メッセージ
message True string

ユーザーに送信するメッセージを入力します。

Mode
mode True string

1 人または複数のユーザーを選択するようにユーザーに依頼します。

検索文字列
searchstr string

必要に応じて、開始検索文字列を指定します。

応答アクティビティ
activityJson True string

ボットからの応答アクティビティ。

応答の受け入れ
acceptResponseFrom string

特定のユーザーまたは任意のユーザーからの応答を受け入れます。

分岐を許可する
allowBranching string

応答を提供する前に、ユーザーが分岐スキルをトリガーできるようにします。

チャットで表示する
showInChat boolean

Teams 通話の場合は、チャットでこのメッセージを表示します。 それ以外の場合、ボットはメッセージのみを読み上げられます。

音声応答をリッスンする
listenForInput boolean

これが Teams 呼び出しの場合、このプロパティはボットが音声応答をリッスンするかどうかを決定します。 Teams 呼び出しがない場合、または呼び出されない場合、ボットはすぐに音声応答をリッスンしません。

戻り値

ユーザーから応答を取得する

この操作は、ユーザーに入力を求めるために使用されます。

パラメーター

名前 キー 必須 説明
filters
filters array of string
headers
headers object
プロパティ
properties object
メッセージ
message True string

ユーザーに送信するメッセージを入力します。

応答アクティビティ
activityJson True string

ボットからの応答アクティビティ。

応答の受け入れ
acceptResponseFrom string

特定のユーザーまたは任意のユーザーからの応答を受け入れます。

チャットで表示する
showInChat boolean

Teams 通話の場合は、チャットでこのメッセージを表示します。 それ以外の場合、ボットはメッセージのみを読み上げられます。

戻り値

ユーザーから意図ベクトル応答を取得する

この操作は、ユーザーに NLP 入力を要求するために使用されます。

パラメーター

名前 キー 必須 説明
filters
filters array of string
headers
headers object
プロパティ
properties object
メッセージ
message True string

ユーザーに送信するメッセージを入力します。

LUIS 意図ベクトル
intentVector True string

LUIS 意図ベクトルを選択します。

応答アクティビティ
activityJson True string

ボットからの応答アクティビティ。

応答の受け入れ
acceptResponseFrom string

特定のユーザーまたは任意のユーザーからの応答を受け入れます。

分岐を許可する
allowBranching string

応答を提供する前に、ユーザーが分岐スキルをトリガーできるようにします。

チャットで表示する
showInChat boolean

Teams 通話の場合は、チャットでこのメッセージを表示します。 それ以外の場合、ボットはメッセージのみを読み上げられます。

戻り値

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

ユーザーから選択肢の応答を取得する

この操作は、ユーザーに選択の入力を求めるために使用されます。

パラメーター

名前 キー 必須 説明
filters
filters array of string
headers
headers object
プロパティ
properties object
メッセージ
message True string

ユーザーに送信するメッセージを入力します。

選択肢の値
choices True string

各選択肢を個別の行に指定します。

応答アクティビティ
activityJson True string

ボットからの応答アクティビティ。

応答の受け入れ
acceptResponseFrom string

特定のユーザーまたは任意のユーザーからの応答を受け入れます。

分岐を許可する
allowBranching string

応答を提供する前に、ユーザーが分岐スキルをトリガーできるようにします。

チャットで表示する
showInChat boolean

Teams 通話の場合は、チャットでこのメッセージを表示します。 それ以外の場合、ボットはメッセージのみを読み上げられます。

音声応答をリッスンする
listenForInput boolean

これが Teams 呼び出しの場合、このプロパティはボットが音声応答をリッスンするかどうかを決定します。 Teams 呼び出しがない場合、または呼び出されない場合、ボットはすぐに音声応答をリッスンしません。

戻り値

ユーザーから選択肢リストの応答を取得する

この操作は、選択リストの入力をユーザーに要求するために使用されます。

パラメーター

名前 キー 必須 説明
filters
filters array of string
headers
headers object
プロパティ
properties object
アイコン URL
icon string

選択項目ごとに表示するアイコンの絶対 URL を入力します。

メッセージ
message True string

ユーザーに送信するメッセージを入力します。

選択肢の値
choices True object

選択配列オブジェクトを指定します。

応答アクティビティ
activityJson True string

ボットからの応答アクティビティ。

応答の受け入れ
acceptResponseFrom string

特定のユーザーまたは任意のユーザーからの応答を受け入れます。

分岐を許可する
allowBranching string

応答を提供する前に、ユーザーが分岐スキルをトリガーできるようにします。

チャットで表示する
showInChat boolean

Teams 通話の場合は、チャットでこのメッセージを表示します。 それ以外の場合、ボットはメッセージのみを読み上げられます。

音声応答をリッスンする
listenForInput boolean

これが Teams 呼び出しの場合、このプロパティはボットが音声応答をリッスンするかどうかを決定します。 Teams 呼び出しがない場合、または呼び出されない場合、ボットはすぐに音声応答をリッスンしません。

戻り値

新しいグループ会話を開始する

この操作は、チャネルで新しいグループ会話を開始するために使用されます。

パラメーター

名前 キー 必須 説明
ターゲット ボット
EnterpriseBot True string

ボットを選択します。

チャネル登録情報
teamIDStr True object

出力を一覧表示するチャネル。

チャネル名
channelId True string

会話を投稿するチャネル。 名前を入力します。

会話テキスト
message True string

会話を開始するメッセージ。

戻り値

新しいプライベート会話を開始する

この操作は、ユーザーとの新しいプライベート会話を開始するために使用されます。

パラメーター

名前 キー 必須 説明
ターゲット ボット
EnterpriseBot True string

ボットを選択します。

会話テキスト
message True string

会話を開始するメッセージ。

User
user True string

ユーザー プリンシパル名 (UPN)。

戻り値

種類別にボット メモリ項目を取得する

すべてのボット メモリ項目を種類別に取得します。

パラメーター

名前 キー 必須 説明
ユーザー プリンシパル名。
user True string

ユーザー プリンシパル名を指定します。

メモリの種類
type True string

一覧表示するメモリの種類を指定します。

戻り値

返信を送信する

この操作は、フローをトリガーしたアクティビティに応答を送信するために使用されます。

パラメーター

名前 キー 必須 説明
応答テキスト
message True string

ユーザーに返信するメッセージ。

応答アクティビティ
activityJson True string

ボットからの応答アクティビティ

チャットで表示する
showInChat boolean

Teams 通話の場合は、チャットでこのメッセージを表示します。 それ以外の場合、ボットはメッセージのみを読み上げられます。

カスタム チャネル データ
customChannelDataJson string

メッセージのカスタム チャネル データ JSON (Direct Line でのみサポート)

シグナル応答 JSON
signalResponse string

シグナル応答 JSON 文字列

メッセージ ID
messageId string

(省略可能)置き換える同じ会話内の前のメッセージの ID。 指定した場合、ボットは既存のチャット メッセージをこのメッセージに置き換えます。

戻り値

トリガー

キーワードを使用する場合

この操作は、指定されたキーワードがボットによって使用されたときにトリガーされます。 セミコロンで区切られた形式で複数のキーワードを指定します。

意図ベクトルが認識されたとき

この操作は、指定された LUIS 意図ベクトルがボットによって認識されたときにトリガーされます。

キーワードを使用する場合

この操作は、指定されたキーワードがボットによって使用されたときにトリガーされます。 セミコロンで区切られた形式で複数のキーワードを指定します。

パラメーター

名前 キー 必須 説明
filters
filters array of string
headers
headers object
プロパティ
properties object
トリガーの説明
triggerDescription True string

ボットのヘルプ ダイアログに表示される説明

ボット トリガーの種類
triggerType True string

トリガーの種類を選択します。

キーワード
keywords string

フローをトリガーするカスタム キーワードを入力します。

(非推奨)LUIS API キー
luisApiKey string

(非推奨)LUIS API キーを AtBot に提供します。 このパラメーターは非推奨です。 今後 LUIS で使用する場合は、Intent Vector トリガーを使用してください。

(非推奨)LUIS アプリ
luisAppId string

(非推奨)LUIS アプリを選択します。 このパラメーターは非推奨です。 今後 LUIS で使用する場合は、Intent Vector トリガーを使用してください。

(非推奨)LUIS の意図
luisIntent string

(非推奨)使用する LUIS 意図を選択します。 このパラメーターは非推奨です。 今後 LUIS で使用する場合は、Intent Vector トリガーを使用してください。

戻り値

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

意図ベクトルが認識されたとき

この操作は、指定された LUIS 意図ベクトルがボットによって認識されたときにトリガーされます。

パラメーター

名前 キー 必須 説明
filters
filters array of string
headers
headers object
プロパティ
properties object
トリガーの説明
triggerDescription True string

ボットのヘルプ ダイアログに表示される説明。

ボット トリガーの種類
triggerType True string

トリガーの種類を選択します。

LUIS 意図ベクトル
intentVector string

LUIS 意図ベクトルを選択します。

分岐を許可する
allowBranching string

ユーザーがフォローアップの質問に答えながら分岐スキルをトリガーできるようにします。

戻り値

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

定義

BotReplyResponse

名前 パス 説明
メッセージ ID
id string

応答から作成されたメッセージの ID。 メッセージを更新するために使用されます。

BotResponse

名前 パス 説明
応答テキスト
text string

ユーザーが入力した応答。

キャンセルに関するお知らせ
cancelNotice boolean

ユーザーがキャンセル キーワードで応答した場合、このフラグは True になります。

応答するユーザー
respondingUser string

ボットに応答するユーザー。

files
files array of object
ファイル名
files.name string

ファイル名。

ファイルの種類
files.content-type string

ファイルの種類。

ファイル バイト数
files.bytes byte

ファイルバイト数。

BotResponse_Date

名前 パス 説明
応答日
text date-time

ユーザーが入力した応答日時。

応答日 (UTC)
text_UTC date-time

ユーザーが入力した応答日時 (UTC 形式)。

キャンセルに関するお知らせ
cancelNotice boolean

ユーザーがキャンセル キーワードで応答した場合、このフラグは True になります。

応答するユーザー
respondingUser string

ボットに応答するユーザー。

BotResponse_Choice

名前 パス 説明
応答の選択
text string

ユーザーが入力した応答の選択肢。

キャンセルに関するお知らせ
cancelNotice boolean

ユーザーがキャンセル キーワードで応答した場合、このフラグは True になります。

応答するユーザー
respondingUser string

ボットに応答するユーザー。

BotResponse_ChoiceList

名前 パス 説明
選択した選択肢リストのタイトル
title string

選択した選択肢リストのタイトル。

選択した選択肢リストのサブタイトル
subtitle string

選択した選択肢リストのサブタイトル。

選択した選択肢リストの値
value string

選択した選択肢リストの値。

キャンセルに関するお知らせ
cancelNotice boolean

ユーザーがキャンセル キーワードで応答した場合、このフラグは True になります。

応答するユーザー
respondingUser string

ボットに応答するユーザー。

BotResponse_People

名前 パス 説明
people
people array of object
ユーザー プリンシパル名
people.upn string

ユーザー プリンシパル名。

ユーザー ID
people.userid string

ユーザー ID。

氏名
people.fullname string

ユーザーの完全な名前。

Email
people.email string

ユーザーの電子メール。

キャンセルに関するお知らせ
cancelNotice boolean

ユーザーがキャンセル キーワードで応答した場合、このフラグは True になります。

応答するユーザー
respondingUser string

ボットに応答するユーザー。

BotResponse_Memory

名前 パス 説明
メモリ項目のタイトル
title string

メモリ項目のタイトル。

メモリ項目の値
value string

メモリ項目の値。

キャンセルに関するお知らせ
cancelNotice boolean

ユーザーがキャンセル キーワードで応答した場合、このフラグは True になります。

応答するユーザー
respondingUser string

ボットに応答するユーザー。

Response_SaveBotMemory

名前 パス 説明
Bot Memory Save Result
text string

ボット メモリへの保存の結果。

Response_DeleteBotMemory

名前 パス 説明
ボット のメモリ削除の結果
text string

ボット メモリからの削除の結果。

BotGroupConversationStartResponse

名前 パス 説明
会話 ID
id string

グループ会話の開始から作成された会話の ID。 会話を更新するために使用されます。

メッセージ ID
messageId string

グループ会話の開始から作成されたメッセージの ID。 メッセージを更新するために使用されます。

応答アクティビティ
activityJson string

アクティビティ Json。

BotConversationStartResponse

名前 パス 説明
メッセージ ID
id string

応答から作成されたメッセージの ID。 メッセージを更新するために使用されます。

応答アクティビティ
activityJson string

アクティビティ Json。

BridgeOutcome

名前 パス 説明
結果
outcome string

ブリッジの結果。

閉じた橋
bridgeClosedBy string

ブリッジを閉じたユーザー。

MemoryItem

名前 パス 説明
メモリ項目のタイトル
title string

メモリ項目のタイトル。

メモリ項目の値
value string

メモリ項目の値。

オブジェクト

これは型 'object' です。