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/plainapplication/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呼び出しで選択された各ナレッジベースは個別のリクエストとしてクエリされるため、一度に多くのナレッジベースを検索すると、レート制限の割り当てをより多く消費します。

最終更新日: