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