Enterprise Context by Workato
エンタープライズコンテキスト by Workatoコネクターは、ビルダーがWorkatoのナレッジベース内のドキュメントをレシピネイティブな方法で管理できるようにします。 これを使用して、プログラムによってドキュメントを挿入、更新、削除、一覧表示、検索し、Genieが取得するコンテキストをソースシステムの最新状態に保ちます。
このコネクターは、ナレッジベース内のコンテンツを管理します。 ナレッジベース自体の作成、削除、設定は行いません。 これらのタスクについては、ナレッジベースの管理を参照してください。
STORE KNOWLEDGEアクションからの移行
エンタープライズコンテキスト by Workatoは、Workato Genieコネクターのナレッジを保存アクションに代わるものです。 Store knowledgeアクションは非推奨ですが、既存のレシピでは引き続き実行されます。すぐにアクションを実行する必要はありません。 マッピングについては、Store knowledgeアクションから移行するを参照してください。
コネクション設定
エンタープライズコンテキスト by Workatoは、組み込みのファーストパーティコネクターです。 ワークスペースレベルの認証情報を使用してWorkato独自の検索サービスに対して認証するため、外部認証やコネクション設定は必要ありません。 レシピにコネクターを追加すると、自動的にワークスペースにスコープ設定されます。
サポートされているナレッジベース
エンタープライズコンテキスト by Workatoアクションは、コンテンツがレシピまたは直接アップロードから取得されるナレッジベースに対して動作します。
Workato GOデータソース(Google Drive、Confluence、SharePoint、NotionなどのMatrix接続ソース)によって入力されたナレッジベースは個別に管理され、このコネクターでは変更できません。 これにより、それらのデータソースが提供する権限を考慮した取得が維持されます。
各アクションは、ナレッジベースURLに表示されるハンドルでナレッジベースを識別します。 レシピエディターで、リストからナレッジベースを選択します。
ドキュメント
ドキュメントとは、ナレッジベースに格納されるコンテンツの単位です。 各ドキュメントには、次のフィールドがあります。
| フィールド | 説明 |
|---|---|
| ドキュメントID | ソースシステムからの一意の識別子。 エンタープライズコンテキスト by Workatoはアップサート時にこのIDを使用してドキュメントを照合するため、同じIDの場合は重複を作成するのではなく既存のドキュメントを更新します。 |
| タイトル | ドキュメントのタイトル。 |
| 本文 | ドキュメントのコンテンツ。 バイナリファイルタイプの場合は、ファイルコンテンツを指定します。 |
| コンテンツタイプ | ドキュメントのMIMEタイプ(text/plainやapplication/pdfなど)。 ここを空白のままにすると、サービスがコンテンツからタイプを検出します。 |
| ソースURL | ソースURL。 Genieは、ユーザーに情報を提示するときに、このURLを使用してドキュメントを引用します。 |
| メタデータ | 自由形式のキーと値のメタデータ。 英語ドキュメントのテキスト抽出精度を高めるには、lang: enを含めます。 メタデータは、ListアクションおよびSearchアクションで結果をフィルタリングするためにも使用できます。 |
| 作成日 | ソースシステムからの作成タイムスタンプ。 |
| 更新日 | ソースシステムからの最終更新タイムスタンプ。 |
サポートされているファイルタイプ
プレーンテキストに加えて、エンタープライズコンテキスト by Workatoは次のバイナリファイルタイプを受け入れ、インデックス作成前にサーバー側でテキストコンテンツを抽出します。
- PDF(
application/pdf) - Microsoft Word(
.docx) - Microsoft PowerPoint(
.pptx)
Content typeを指定すると、サービスはそれを尊重します。 空白のままにすると、サービスがコンテンツを検査して正しいタイプを検出します。 テンプレートおよびマクロ有効Office形式(例: .dotx、.pptm、.xlsm)ならびに従来のバイナリOffice形式(例: .doc、.xls)はサポートされておらず、拒否されます。
アクション
エンタープライズコンテキスト by Workatoコネクターは、次のレシピアクションをサポートしています。
- Upsert documents:ナレッジベース内のドキュメントのバッチを挿入または更新します。
- Delete document:ナレッジベースからIDでドキュメントを削除します。
- List documents:ナレッジベース内のドキュメントのページ分割されたリストを、オプションのフィルター付きで取得します。
- Search documents:1つ以上のナレッジベース全体で自然言語検索またはキーワード検索を実行します。
Store knowledgeアクションからの移行
エンタープライズコンテキスト by Workatoは、Workato Genieコネクターの知識を保存アクションを、専用の一連のドキュメントアクションとして切り出します。 ドキュメントストレージのマッピングは1対1です:
| Workato Genieコネクター | エンタープライズコンテキスト by Workato |
|---|---|
| ナレッジを保存 | ドキュメントのアップサート |
移行時には、次の点が適用されます。
- 既存のレシピには影響しません。 Store knowledgeアクションは非推奨ですが、削除されたわけではありません。 すでにそれを使用しているレシピは、変更なしで引き続き実行されます。
- 新しいナレッジベースレシピはこのコネクターを使用します。 ナレッジベースビューからレシピを作成すると、Upsert documentsアクションが自動的に選択されます。
- 入力フィールドは直接対応します。 Store knowledgeのドキュメントフィールド(ドキュメントID、タイトル、本文、コンテンツタイプ、URL、メタデータ、作成日時、更新日時)は、Upsert documentsの同じフィールドに対応します。
- 依存関係はナレッジベースビューに表示されます。 移行後、ナレッジベースビューには、エンタープライズコンテキスト by Workatoを通じてそのドキュメントを管理するレシピが表示されます。
制限
| 制限 | 値 |
|---|---|
| Upsert documents呼び出しあたりのドキュメント数 | 100 |
| デフォルトのページサイズ(List and Search documents) | 50 |
| 最大ページサイズ(List and Search documents) | 100 |
| レート制限 | アクションごと、Environmentごと、1分あたり100リクエスト |
レート制限を超えると、コネクターはバックオフを適用して再試行します。 Search documents呼び出しで選択された各ナレッジベースは個別のリクエストとしてクエリされるため、一度に多くのナレッジベースを検索すると、レート制限の割り当てをより多く消費します。
最終更新日: