AtBot Logic

AtBot はコード不要のボット構築サービスであり、プログラミングの経験がなくても会話型の UI をすばやく作成できます。

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

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate Standard 以下を除くすべての Power Automate 地域 :
     -   US Government (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
Power Apps Standard 以下を除くすべての Power Apps 地域 :
     -   US Government (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
お問い合わせ先
件名 AtBot サポート
[URL] https://admin.atbot.io/Docs
メール support@atbot.io
Connector Metadata
発行者 H3 Solutions Inc.
Web サイト https://www.atbot.io
プライバシー ポリシー https://admin.atbot.io/privacy
カテゴリ AI; 生産性

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

前提条件

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

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

資格情報の入手方法

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

既知の問題と制限事項

キーワード トリガーで LUIS サポートは廃止されました。 LUIS Intent Vectors を使用して、自然言語を認識するスキルを作成してください。

調整制限

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

アクション

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

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

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

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

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

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

アダプティブ カードを生成する

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

イベントを送信する

この操作はボット クライアントにイベントを送信する際に使用します。

タイプ別にボット メモリ アイテムを取得する

タイプ別にすべてのボット メモリ アイテムを取得します。

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

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

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

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

ボット メモリに保存

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

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

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

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

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

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

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

ユーザーからインテント ベクター応答を取得する

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

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

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

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

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

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

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

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

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

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

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

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

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

返信を送信

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

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

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

パラメーター

名前 キー 必須 説明
filters
filters array of string
headers
headers object
properties
properties object
User Name
chatUserName True string

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

開始メッセージ
chatInitiationMessage string

チャット ブリッジの確立時にこのユーザーに送信するメッセージ。

返信活動
activityJson True string

チャット ユーザーへの返信活動。

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

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

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

タイムアウトをトリガーするアイドル活動の期間 (分)。

戻り値

本文​​
BridgeOutcome

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

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

パラメーター

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

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

表示スタイル
displayStyle True string

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

返信活動
activityJson True string

ボットからの返信活動。

タブで表示
showInTab boolean

インライン チャットではなく、このカード セットをタブに表示します。

タブ ボタンのラベル
deepLinkButtonLabel string

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

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

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

戻り値

本文​​
BotReplyResponse

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

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

パラメーター

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

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

content
content True dynamic

戻り値

本文​​
BotReplyResponse

アダプティブ カードを生成する

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

パラメーター

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

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

content
content dynamic

戻り値

応答
object

イベントを送信する

この操作はボット クライアントにイベントを送信する際に使用します。

パラメーター

名前 キー 必須 説明
返信活動
activityJson True string

ボットからの返信活動

イベントの JSON
eventObject True object

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

タイプ別にボット メモリ アイテムを取得する

タイプ別にすべてのボット メモリ アイテムを取得します。

パラメーター

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

ユーザー プリンシパル名を入力します。

メモリ タイプ
type True string

リストするメモリの種類を指定します。

戻り値

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

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

パラメーター

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

アップデートとして使用するカードを提供します。

返信活動
activityJson True string

ボットからの返信活動。

戻り値

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

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

パラメーター

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

メモリ アイテムを保存するユーザー。

メモリ タイプ
type True string

メモリの種類。

value True string

メモリ アイテムの値。

戻り値

ボット メモリに保存

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

パラメーター

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

メモリ アイテムを保存するユーザー。

メモリ タイプ
type True string

メモリの種類。

敬称
title True string

メモリ アイテムのタイトル。

value True string

メモリ アイテムの値。

戻り値

本文​​
Response_SaveBotMemory

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

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

パラメーター

名前 キー 必須 説明
filters
filters array of string
headers
headers object
properties
properties object
Message
message True string

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

Mode
mode True string

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

検索文字列
searchstr string

オプションで、開始検索文字列を指定します。

返信活動
activityJson True string

ボットからの返信活動。

次からの応答を受け入れる
acceptResponseFrom string

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

分岐を許可する
allowBranching string

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

チャットで表示
showInChat boolean

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

音声応答を聞く
listenForInput boolean

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

戻り値

本文​​
BotResponse_People

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

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

パラメーター

名前 キー 必須 説明
filters
filters array of string
headers
headers object
properties
properties object
Message
message True string

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

返信活動
activityJson True string

ボットからの返信活動。

次からの応答を受け入れる
acceptResponseFrom string

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

チャットで表示
showInChat boolean

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

戻り値

本文​​
BotResponse

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

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

パラメーター

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

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

Webhook
webHook dynamic

戻り値

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

ユーザーからインテント ベクター応答を取得する

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

パラメーター

名前 キー 必須 説明
filters
filters array of string
headers
headers object
properties
properties object
Message
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
properties object
Message
message True string

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

メモリ タイプ
type True string

リストするメモリの種類を指定します。

返信活動
activityJson True string

ボットからの返信活動。

アイコンの URL
icon string

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

次からの応答を受け入れる
acceptResponseFrom string

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

ターゲット ユーザー
targetUserMemory string

オプションで、ボットがメモリ アイテムをプルするユーザーの UPN を指定します。 空白のままにすると、スキルを開始したユーザーからメモリ アイテムがプルされます。 ボットから開始されたグループ会話の場合、フローで認証されたユーザーからメモリ アイテムをプルします。

分岐を許可する
allowBranching string

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

チャットで表示
showInChat boolean

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

戻り値

本文​​
BotResponse_Memory

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

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

パラメーター

名前 キー 必須 説明
filters
filters array of string
headers
headers object
properties
properties object
日付範囲
dateScope True string

日付値の範囲を選択します。

Message
message True string

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

返信活動
activityJson True string

ボットからの返信活動。

次からの応答を受け入れる
acceptResponseFrom string

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

分岐を許可する
allowBranching string

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

チャットで表示
showInChat boolean

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

戻り値

本文​​
BotResponse_Date

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

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

パラメーター

名前 キー 必須 説明
filters
filters array of string
headers
headers object
properties
properties object
Icon URL
icon string

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

Message
message True string

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

選択値
choices True object

選択配列オブジェクトを提供します。

返信活動
activityJson True string

ボットからの返信活動。

次からの応答を受け入れる
acceptResponseFrom string

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

分岐を許可する
allowBranching string

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

チャットで表示
showInChat boolean

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

音声応答を聞く
listenForInput boolean

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

戻り値

本文​​
BotResponse_ChoiceList

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

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

パラメーター

名前 キー 必須 説明
filters
filters array of string
headers
headers object
properties
properties object
Message
message True string

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

選択値
choices True string

それぞれの選択肢を別々の行に入力してください。

返信活動
activityJson True string

ボットからの返信活動。

次からの応答を受け入れる
acceptResponseFrom string

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

分岐を許可する
allowBranching string

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

チャットで表示
showInChat boolean

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

音声応答を聞く
listenForInput boolean

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

戻り値

本文​​
BotResponse_Choice

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

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

パラメーター

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

ボットを選択します。

チャネル一覧
teamIDStr True object

チャネル リストの出力。

チャネル名
channelId True string

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

会話テキスト
message True string

会話を始めるためのメッセージ。

戻り値

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

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

パラメーター

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

ボットを選択します。

会話テキスト
message True string

会話を始めるためのメッセージ。

ユーザー
user True string

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

戻り値

返信を送信

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

パラメーター

名前 キー 必須 説明
返信テキスト
message True string

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

返信活動
activityJson True string

ボットからの返信活動

チャットで表示
showInChat boolean

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

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

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

シグナル 応答 JSON
signalResponse string

シグナル応答 JSON 文字列

メッセージ ID
messageId string

(オプション) 置き換える同じ会話内の前のメッセージの ID。 指定された場合、ボットは既存のチャット メッセージをこのメッセージに置き換えます。

戻り値

本文​​
BotReplyResponse

トリガー

インテント ベクターを認識した時

この操作は、指定した LUIS インテント ベクターをボットが認識したときにトリガーします。

キーワードを使用する時

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

インテント ベクターを認識した時

この操作は、指定した LUIS インテント ベクターをボットが認識したときにトリガーします。

パラメーター

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

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

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

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

LUIS インテント ベクター
intentVector string

LUIS インテント ベクターを選択します。

分岐を許可する
allowBranching string

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

戻り値

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

キーワードを使用する時

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

パラメーター

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

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

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

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

キーワード
keywords string

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

(廃止) LUIS API キー
luisApiKey string

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

(廃止) LUIS アプリ
luisAppId string

(非推奨) LUIS アプリを選択してください。 このパラメーターは非推奨です。 今後 LUIS を使用するには、インテント ベクター トリガーを使用してください。

(廃止) LUIS インテント
luisIntent string

(非推奨) 使用する LUIS インテントを選択します。 このパラメーターは非推奨です。 今後 LUIS を使用するには、インテント ベクター トリガーを使用してください。

戻り値

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

定義

BotReplyResponse

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

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

BotResponse

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

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

キャンセル通知
cancelNotice boolean

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

応答するユーザー
respondingUser string

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

ファイル
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

ユーザーの氏名。

電子メール
people.email string

ユーザーのメール。

キャンセル通知
cancelNotice boolean

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

応答するユーザー
respondingUser string

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

BotResponse_Memory

名前 パス 説明
メモリ アイテムのタイトル
title string

メモリ アイテムのタイトル。

メモリ アイテムの値
value string

メモリ アイテムの値。

キャンセル通知
cancelNotice boolean

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

応答するユーザー
respondingUser string

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

Response_SaveBotMemory

名前 パス 説明
ボット メモリの保存結果
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

メモリ アイテムの値。

オブジェクト

’オブジェクト’ という種類です。