Rainbird (プレビュー)
Rainbird は、複雑な意思決定を自動化できるコード不要のインテリジェント オートメーション プラットフォームです。 このコネクタを使用すると、Rainbird で作成したナレッジ マップを操作できます。
このコネクタは、次の製品および地域で利用可能です:
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | Rainbird Technologies Ltd |
| [URL] | https://rainbird.ai/contact-us/ |
| メール | support@rainbird.zohodesk.eu |
| Connector Metadata | |
|---|---|
| 発行者 | Rainbird Technologies ltd |
| Web サイト | https://rainbird.ai/ |
| プライバシー ポリシー | https://rainbird.ai/privacy-policy/ |
| カテゴリー | AI;ビジネス インテリジェンス |
Rainbird を使用すると、組織は複雑な意思決定を大規模に自動化できます。 SME の専門知識を活用して、コードなしの Studio で意思決定ロジックをエンコードし、ワークフローに接続して、完全に自動化されたエンドツーエンド ソリューションを作成できる、高品質でパフォーマンスが高く、監査可能な意思決定を提供します。
詳細については、Rainbird の Web サイト を参照してください。
前提条件
このコネクタを使用するには、Rainbird アカウントへのアクセスが必要です。
今すぐサインアップして、無料のコミュニティ アカウントにアクセスできます。サインアップ。 プレミアム アカウントについては、お問い合わせください。お問い合わせ。
資格情報の入手方法
このコネクタを使用するには、以下が必要です。API キー (ApiKey) -ナレッジ マップID (KmID)
ApiKey および KmID は、Rainbird Studio にあります。
- アカウントにログインする
- ナレッジ マップを開く (または、必要に応じて新しいナレッジ マップを作成する)
- 「公開」ページに移動
Rainbird で認証するには、ApiKey が必要です。 ユーザー名として ApiKey を使用して認証する場合、パスワードは必要ありません (パスワードが必要な場合は任意の文字を入力してください)。
詳細については、Rainbird の説明書 を参照してください。
コネクタの使用を開始する
Rainbird を使用して意思決定を自動化するシナリオでは、次のことを行う必要があります。
-使用したいナレッジ マップでセッションを開始する -セッションにデータを提供する (オプション) -セッションで Rainbird をクエリする
Rainbird は、さらに情報が必要な場合に質問で応答します。これには Response 操作を使用して答えることができます。または、結果が提供されます。
セッションの開始方法:
すべての決定は、セッションを開始し、SessionID を取得するための Start オペレーションから始まります。
Start 操作で、KmID を指定して SessionID を生成します。 その後、この ID を使用して、同じセッション内でナレッジ マップを操作する操作を行う必要があります。
セッションにバッチ データを提供する方法:
クエリを実行する前に Inject 操作を使用して、意思決定に必要なデータを提供します。
クエリの作成方法:
クエリを作成するには、Query 操作を使用して、SessionID、関係名、および関係のサブジェクト/オブジェクトのいずれかまたは両方を提供します。
Rainbird の説明書 にアクセスして、このリクエストの例を確認してください。
質問への回答方法
Rainbird から返された質問に答えるには、Response 操作を使用します。 Query 操作と Response 操作の両方が、詳細情報を求める質問または結果のいずれかを返します。 Rainnbird が結果を提供するのに十分な情報を得るまで、質問/応答ループは再帰的です。
リクエスト フローの詳細については、Rainbird の説明書 を参照してください。
既知の問題と制限事項
現在のコネクタ構成では、ユーザーは証拠操作にセキュリティ キーを使用できません。 ユーザーが証拠操作を使用したい場合は、Rainbird Studio の各マップの公開セクションで証拠セキュリティが無効になっていることを確認する必要があります。
一般的なエラーと解決策
間違った環境変数の使用:
-エラー コード: この間違いにより、Session ID not found や 401: Unauthorized などのさまざまなエラー メッセージが出力される可能性があります。
-解決策: すべての操作は、正しい環境 (アカウントにリンクされている環境) に対して行う必要があります。 各ステップが環境と一致していることを確認してください。
### 間違ったデータ構造を使用しています。
-エラーコード: 400: bad request -解決策: これは、データの非互換性が原因である可能性があります。 エラーの詳細を読んでより多くのコンテキストを取得し、フローで使用されるデータが Rainbird モデルのデータと一致することを確認してください。
よくあるご質問
どの環境を使用する必要があるかを知るにはどうすればよいですか?
Rainbird アカウントで環境を見つけることができます。 アカウントにログインし、Account ページ (左側のナビゲーション メニューの下部) に移動します。 About セクションには、アカウント環境 (Enterprise または Community) に関連する情報が表示されます。
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | 説明設定 | Required |
|---|---|---|---|
| API キー | securestring | Rainbird アカウントに関連付けられた API キー | True |
| オプションのパスワード | securestring | パスワードは不要です。任意の文字を入力してください | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| クエリ - 実行中のセッションをクエリします |
ナレッジ マップに質問します。 このアクションは、Rainbird の意思決定エンジンをトリガーします。 自動決定を実行し、最終的な回答を提供します。 Rainbird が結論を出すためにさらに情報が必要な場合は、質問が表示されます。 |
| バージョン - エンジンのバージョンを報告します |
現在の Rainbird の推論エンジンのバージョンを返します。 |
| 元に戻す - エンジンとの以前の対話を元に戻します |
直前の操作を元に戻します。 このアクションは、最後に実行されたアクションを削除します。 Rainbird に与えられた最後のデータを削除します。 |
| 応答 - 尋ねられた質問に応答する |
Rainbird に答えを返します。 Rainbird がクエリに対する質問を返すとき、ユーザーまたはシステムがさらにデータを入力することを期待します。 このアクションは応答を返します。 |
| 注入 - 事実をセッションに注入する |
特定のセッション ID に対してナレッジ マップにデータを挿入します。 これは通常、クエリの前に実行されます。 Rainbird モデルにデータをアップロードする方法です。 |
| 証拠 - 特定の事実の証拠を返します |
事実 ID に基づいてエビデンスを生成します。 Rainbird によって推論された知識には、意思決定プロセスを説明するためのデータが常に付属しています。 このデータは、このアクションによってアクセス可能になります。 注: Rainbird studio で証拠キーがオフになっていることを確認してください。 |
| 開始 - 新規セッションの開始 |
ナレッジ マップに新しいセッション ID を作成します。 この最初のステップでは、ファクトの挿入やクエリの実行など、Rainbird モデルに対してさらにアクションを実行できます。 |
クエリ - 実行中のセッションをクエリします
ナレッジ マップに質問します。 このアクションは、Rainbird の意思決定エンジンをトリガーします。 自動決定を実行し、最終的な回答を提供します。 Rainbird が結論を出すためにさらに情報が必要な場合は、質問が表示されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Environment
|
environment | True | string |
アカウント環境: コミュニティ (api.rainbird.ai) またはエンタープライズ (enterprise-api.rainbird.ai)。 |
|
セッション ID
|
sessionID | True | string |
クエリ対象のセッション |
|
subject
|
subject | string |
サブジェクト側の概念インスタンス (オブジェクトまたはサブジェクトが必要) |
|
|
relationship
|
relationship | True | string |
照会先とのリレーションシップ |
|
オブジェクト
|
object | string |
オブジェクト側の概念インスタンス (オブジェクトまたはサブジェクトが必要) |
戻り値
- 返答
- object
バージョン - エンジンのバージョンを報告します
現在の Rainbird の推論エンジンのバージョンを返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Environment
|
environment | True | string |
アカウント環境: コミュニティ (api.rainbird.ai) またはエンタープライズ (enterprise-api.rainbird.ai)。 |
戻り値
- 返答
- string
元に戻す - エンジンとの以前の対話を元に戻します
直前の操作を元に戻します。 このアクションは、最後に実行されたアクションを削除します。 Rainbird に与えられた最後のデータを削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Environment
|
environment | True | string |
アカウント環境: コミュニティ (api.rainbird.ai) またはエンタープライズ (enterprise-api.rainbird.ai)。 |
|
セッション ID
|
sessionID | True | string |
元に戻すために戻るセッション ID |
戻り値
- 返答
- object
応答 - 尋ねられた質問に応答する
Rainbird に答えを返します。 Rainbird がクエリに対する質問を返すとき、ユーザーまたはシステムがさらにデータを入力することを期待します。 このアクションは応答を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Environment
|
environment | True | string |
アカウント環境: コミュニティ (api.rainbird.ai) またはエンタープライズ (enterprise-api.rainbird.ai)。 |
|
セッション ID
|
sessionID | True | string |
応答を送信するセッション |
|
subject
|
subject | True |
サブジェクト側の概念インスタンスまたは値 |
|
|
relationship
|
relationship | True |
主語と目的語を結ぶ関係 |
|
|
オブジェクト
|
object | True |
オブジェクト側の概念インスタンスまたは値 |
|
|
certainty
|
certainty | True | number |
この事実または答えがどれほど確実か |
戻り値
- 返答
- object
注入 - 事実をセッションに注入する
特定のセッション ID に対してナレッジ マップにデータを挿入します。 これは通常、クエリの前に実行されます。 Rainbird モデルにデータをアップロードする方法です。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Environment
|
environment | True | string |
アカウント環境: コミュニティ (api.rainbird.ai) またはエンタープライズ (enterprise-api.rainbird.ai)。 |
|
セッション ID
|
sessionID | True | string |
事実を注入するセッション |
|
subject
|
subject | True |
サブジェクト側の概念インスタンスまたは値 |
|
|
relationship
|
relationship | True |
主語と目的語を結ぶ関係 |
|
|
オブジェクト
|
object | True |
オブジェクト側の概念インスタンスまたは値 |
|
|
certainty
|
certainty | True | number |
この事実または答えがどれほど確実か |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
result
|
result | string |
証拠 - 特定の事実の証拠を返します
事実 ID に基づいてエビデンスを生成します。 Rainbird によって推論された知識には、意思決定プロセスを説明するためのデータが常に付属しています。 このデータは、このアクションによってアクセス可能になります。 注: Rainbird studio で証拠キーがオフになっていることを確認してください。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Environment
|
environment | True | string |
アカウント環境: コミュニティ (api.rainbird.ai) またはエンタープライズ (enterprise-api.rainbird.ai)。 |
|
事実 ID
|
factID | True | string |
証拠を取得するための事実 ID |
|
セッション ID
|
sessionID | True | string |
事実が作成された sessionID WITH EVIDENCE SECURITY OFF (モデル設定を参照) |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
certainty
|
fact.certainty | Certainty |
この事実または答えがどれほど確実か |
|
dataType
|
fact.object.dataType | string | |
|
タイプ
|
fact.object.type | string | |
|
価値
|
fact.object.value | Object |
オブジェクト側の概念インスタンスまたは値 |
|
タイプ
|
fact.relationship.type | string | |
|
dataType
|
fact.subject.dataType | string | |
|
タイプ
|
fact.subject.type | string | |
|
価値
|
fact.subject.value | string | |
|
factID
|
factID | string | |
|
conditions
|
rule.bindings.conditions | array of object | |
|
certainty
|
rule.bindings.conditions.certainty | Certainty |
この事実または答えがどれほど確実か |
|
factID
|
rule.bindings.conditions.factID | factID |
この決定につながる証拠を取得するために使用される ID |
|
オブジェクト
|
rule.bindings.conditions.object | Object |
オブジェクト側の概念インスタンスまたは値 |
|
objectType
|
rule.bindings.conditions.objectType | string | |
|
relationship
|
rule.bindings.conditions.relationship | Relationship |
主語と目的語を結ぶ関係 |
|
salience
|
rule.bindings.conditions.salience | number | |
|
subject
|
rule.bindings.conditions.subject | Subject |
サブジェクト側の概念インスタンスまたは値 |
|
source
|
source | string | |
|
時刻
|
time | number |
開始 - 新規セッションの開始
ナレッジ マップに新しいセッション ID を作成します。 この最初のステップでは、ファクトの挿入やクエリの実行など、Rainbird モデルに対してさらにアクションを実行できます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Environment
|
environment | True | string |
アカウント環境: コミュニティ (api.rainbird.ai) またはエンタープライズ (enterprise-api.rainbird.ai)。 |
|
ナレッジ マップ ID (kmId)
|
kmID | True | string |
セッションを開始するナレッジ マップ ID |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
id
|
id | string |
新しく作成されたセッションの ID |
|
id
|
kmVersion.id | string |
ナレッジ マップのライブ バージョンをクエリするときのナレッジ マップ ID とは異なる、クエリ対象のバージョンの ID |
定義
確実性
サブジェクト
Relationship
Object
factID
オブジェクト
’オブジェクト’ 型です。
string
これは基本的なデータ型 '文字列' です。