ナレッジベース by Workato ​

ナレッジベース by Workatoコネクターは、ビルダーがWorkatoのナレッジベース内のドキュメントをレシピネイティブな方法で管理できるようにします。これを使用して、プログラムによってドキュメントを挿入、更新、削除、一覧表示、検索し、Genieが取得するコンテキストをソースシステムの最新状態に保ちます。

このコネクターは、ナレッジベース内のコンテンツを管理します。ナレッジベース自体の作成、削除、設定は行いません。これらのタスクについては、ナレッジベースの管理を参照してください。

コネクション設定 ​

ナレッジベース by Workatoは、組み込みのファーストパーティコネクターです。ワークスペースレベルの認証情報を使用してWorkato独自の検索サービスに対して認証するため、外部認証やコネクション設定は必要ありません。レシピにコネクターを追加すると、自動的にワークスペースにスコープ設定されます。

サポートされているナレッジベース ​

ナレッジベース by Workatoアクションは、コンテンツがレシピまたは直接アップロードから取得されるナレッジベースに対して動作します。

Workato GOデータソース（Google Drive、Confluence、SharePoint、NotionなどのMatrix接続ソース）によって入力されたナレッジベースは個別に管理され、このコネクターでは変更できません。これにより、それらのデータソースが提供する権限を考慮した取得が維持されます。

各アクションは、ナレッジベースURLに表示されるハンドルでナレッジベースを識別します。レシピエディターで、リストからナレッジベースを選択します。

ドキュメント ​

ドキュメントとは、ナレッジベースに格納されるコンテンツの単位です。各ドキュメントには、次のフィールドがあります。

サポートされているファイルタイプ ​

プレーンテキストに加えて、ナレッジベース 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です：

移行時には、次の点が適用されます。

• 既存のレシピには影響しません。 Store knowledgeアクションは非推奨ですが、削除されたわけではありません。すでにそれを使用しているレシピは、変更なしで引き続き実行されます。
• 新しいナレッジベースのレシピではこのコネクタが使用されます。 ナレッジベースビューからレシピを作成すると、Upsert documents アクションが自動的に選択されます。
• 入力フィールドは直接対応します。 Store knowledgeのドキュメントフィールド（ドキュメントID、タイトル、本文、コンテンツタイプ、URL、メタデータ、作成日時、更新日時）は、Upsert documentsの同じフィールドに対応します。
• 依存関係はナレッジベースビューに表示されます。 移行後、ナレッジベースビューには、ナレッジベース by Workatoを通じてそのドキュメントを管理するレシピが表示されます。

クォータ ​

レート制限を超えると、コネクターはバックオフを適用して再試行します。 Search documents 呼び出しで選択された各ナレッジベースは個別のリクエストとしてクエリされるため、一度に多くのナレッジベースを検索すると、レート制限の上限をより多く消費します。