Amazon KendraのQuipコネクタを使用して、インテリジェントな検索でQuipドキュメントの知識を検索します

組織は Salesforce などの共同ドキュメント作成ソリューションを使用しています 鞭 Salesforce レコード内にリアルタイムの共同ドキュメントを埋め込むことができます。 Quip は Salesforce の生産性プラットフォームであり、企業の共同作業の方法を変革し、あらゆるデバイス間で安全かつ簡単に最新のコラボレーションを実現します。 Quip リポジトリは、組織の貴重な知識を共同ドキュメントやワークフローの形で収集します。 ただし、この組織の知識は、Box や Amazon シンプル ストレージ サービス (Amazon S3)、難しい場合があります。 さらに、共同ワークフローの会話的な性質により、情報が複数の場所に断片化され分散しているため、従来のキーワードベースの検索アプローチは効果的ではありません。

をご利用いただけるようになりましたことをお知らせいたします。 アマゾンケンドラ Quip リポジトリ内のメッセージやドキュメントを検索するための Quip 用コネクタ。 この投稿では、機械学習を活用した Amazon Kendra のインテリジェントな検索機能を使用して、Quip リポジトリで必要な情報を見つける方法を説明します。

ソリューションの概要

Amazon Kendra を使用すると、複数の設定を行うことができます データソース ドキュメント リポジトリ全体を検索するための中心的な場所を提供します。 このソリューションでは、Quip 用の Amazon Kendra コネクタを使用して Quip リポジトリを検索インデックスのデータソースとして設定する方法を示します。

次のスクリーンショットは、Quip リポジトリの例を示しています。

この例のワークスペースには、共有されていないプライベート フォルダーがあります。 このフォルダーには、経費領収書を保管するために使用されるサブフォルダーがあります。 example.com という別のフォルダーは他のユーザーと共有され、チームとの共同作業に使用されます。 このフォルダーには、開発用のドキュメントを保持する XNUMX つのサブフォルダーがあります。

Quip コネクタを設定するには、まず Quip リポジトリのドメイン名、フォルダー ID、およびアクセス トークンを記録します。 次に、Amazon Kendra インデックスを作成し、Quip をデータソースとして追加します。

前提条件

Amazon Kendra の Quip コネクタの使用を開始するには、Quip リポジトリが必要です。

Quip から情報を収集する

Quip データソースを設定する前に、リポジトリに関するいくつかの詳細が必要です。 事前に集めておきましょう。

ドメイン名

ドメイン名を調べます。 たとえば、Quip URL の場合は、 https://example-com.quip.com/browse、ドメイン名は quip。 組織内でのシングル サインオン (SSO) の設定方法に応じて、ドメイン名は異なる場合があります。 後で使用するためにこのドメイン名を保存します。

フォルダーID

Quip のフォルダーには一意の ID が関連付けられています。 正しいフォルダー ID を指定して、適切なフォルダーにアクセスできるように Quip コネクタを構成する必要があります。 この投稿では、フォルダーにインデックスを付けます example.com.

フォルダーの ID を確認するには、フォルダーを選択します。 URL が変更され、フォルダー ID が表示されます。

この場合のフォルダIDは、 xj1vOyaCGB3u。 スキャンするフォルダー ID のリストを作成します。 コネクタを構成するときにこれらの ID を使用します。

アクセストークン

Quip にログインして開きます https://{subdomain.domain}/dev/token Webブラウザで。 次の例では、次の場所に移動します。 https://example-com.quip.com/dev/token。 それから、 パーソナルアクセストークンを取得する.

後の手順で使用するためにトークンをコピーします。

これで、データ ソースを構成するために必要な情報が得られました。

AmazonKendraインデックスを作成する

Amazon Kendra インデックスを設定するには、次の手順を実行します。

1. にサインインする AWSマネジメントコンソール そして、Amazon Kendra コンソールを開きます。

Amazon Kendra を初めて使用する場合は、次のスクリーンショットが表示されるはずです。

2. 選択する インデックスを作成する.
   
3. インデックス名、 入る my-quip-example-index.
4. Description、オプションの説明を入力します。
5. IAMの役割、既存のロールを使用するか、新しいロールを作成します。
6. 選択する Next.
   
7. アクセス制御設定選択 いいえ すべてのインデックス付きコンテンツをすべてのユーザーが利用できるようにします。
8. ユーザーグループの拡張選択 なし.
9. 選択する Next.
   

プロビジョニングエディションは、コンテンツの量やアクセス頻度に応じて XNUMX つのオプションから選択できます。

10. この投稿では、 開発者版.
11. 選択する 創造する.
    

ロールの作成には約 30 秒かかります。 インデックスの作成には最大 30 分かかる場合があります。 完了すると、Amazon Kendra コンソールでインデックスを表示できます。

Quip をデータソースとして追加する

次に、Quip をデータソースとしてインデックスに追加しましょう。

1. Amazon Kendraコンソールで、 データ管理 ナビゲーション ペインで、 データソース.
2. 選択する コネクタを追加 下 鞭.
   
3. データソース名、 入る my-quip-data-source.
4. Description、オプションの説明を入力します。
5. 選択する Next.
   
6. 前に保存した Quip ドメイン名を入力します。
7. シークレット、選択する 新しい Secrets Manager シークレットを作成して追加する.
8. 秘密の名前、シークレットの名前を入力します。
9. Quip トークン、先ほど保存したアクセス トークンを入力します。
10. 選択する シークレットを保存して追加.
    
11. IAMの役割、ロールを選択するか、新しいロールを作成します。
12. 選択する Next.
    
13. 同期スコープ、用 クロールするフォルダー ID を追加する、先ほど保存したフォルダーIDを入力します。
14. 同期実行スケジュールために 周波数選択 オンデマンドで実行.
15. 選択する Next.
    

Quip コネクタを使用すると、作成者、カテゴリ、フォルダー名などの追加フィールドをキャプチャできます (必要に応じて名前を変更することもできます)。

16. この投稿では、フィールド マッピングを構成しません。
17. 選択する Next.
    
18. すべてのオプションを確認し、データ ソースを追加します。

データ ソースは数分で準備が整います。

19. データソースの準備ができたら、選択します 今すぐ同期.
    

Quip リポジトリ内のデータのサイズに応じて、このプロセスには数分から数時間かかる場合があります。 同期は XNUMX 段階のプロセスです。 まず、ドキュメントがクロールされて、インデックスを付けるドキュメントが決定されます。 次に、選択したドキュメントにインデックスが作成されます。 同期速度に影響を与える要因には、リポジトリのスループットとスロットリング、ネットワーク帯域幅、ドキュメントのサイズなどがあります。

同期が完了すると、同期ステータスは成功と表示されます。 これで Quip リポジトリが接続されました。

Amazon Kendra で検索を実行する

いくつかの検索を実行して、コネクタをテストしてみましょう。

1. Amazon Kendraコンソールで、 データ管理 ナビゲーション ペインで、 インデックス付きコンテンツを検索.
   
2. 検索フィールドに検索内容を入力します。 この投稿では、次のように検索します EC2 on Linux.

次のスクリーンショットは、結果を示しています。

制限事項

データ ソースの取り込みには既知の制限がいくつかあります。 一部の制限は、一部のコンテンツにアクセスするための管理者アクセスの必要性によるものであり、他の制限は特定の実装の詳細によるものです。 それらは次のとおりです。

• フル クロールのみがサポートされます。 コネクタで変更ログ クロールをサポートする場合は、管理 API アクセスが必要であり、Quip Web サイトで管理 API を有効にする必要があります。
• 共有フォルダーのみがクロールされます。 管理者ユーザーの個人アクセス トークンを使用した場合でも、他のユーザーのプライベート フォルダー内のデータをクロールすることはできません。
• Quip はファイルの種類の拡張子を保存せず、ファイル名のみを保存するため、このソリューションでは包含および除外するファイルの種類の指定はサポートされていません。
• リアルタイム イベントにはサブスクリプションと管理 API アクセスが必要です。

まとめ

Quip 用の Amazon Kendra コネクタを使用すると、組織は Amazon Kendra によるインテリジェントな検索を使用して、Quip ドキュメントに保存されている貴重な情報をユーザーが安全に利用できるようになります。 このコネクタは、作成者、ファイルタイプ、ソース URI、作成日、親ファイル、カテゴリなどの Quip リポジトリ属性のファセットも提供するため、ユーザーは探しているものに基づいて検索結果を対話的に絞り込むことができます。

Quip リポジトリからコンテンツを取り込むときにカスタムドキュメントエンリッチメントを使用してデータとメタデータを作成、変更、削除する方法の詳細については、次を参照してください。 取り込みプロセス中のドキュメントメタデータのカスタマイズ および コンテンツとメタデータを強化して、AmazonKendraのカスタムドキュメント強化で検索エクスペリエンスを強化します.

---

著者について

アシシュ・ラグワンカー AWSのシニアエンタープライズソリューションアーキテクトです。 彼の主な関心事には、AI / ML、サーバーレス、コンテナテクノロジーが含まれます。 Ashishはマサチューセッツ州ボストンに拠点を置き、読書、アウトドア、家族との時間を楽しんでいます。

ヴィカス・シャー アマゾンウェブサービスのエンタープライズソリューションアーキテクトです。 彼は、顧客が複雑なビジネス上の課題に対する革新的なソリューションを見つけるのを支援することを楽しんでいるテクノロジー愛好家です。 彼の関心分野は、ML、IoT、ロボット工学、ストレージです。 余暇には、ロボットの製作、ハイキング、旅行を楽しんでいます。

• コインスマート。 ヨーロッパで最高のビットコインと暗号通貨取引所。
• Platoblockchain。 Web3メタバースインテリジェンス。 知識の増幅。 出入り自由。
• CryptoHawk。 アルトコインレーダー。 無料トライアル。
• 出典: https://aws.amazon.com/blogs/machine-learning/search-for-knowledge-in-quip-documents-with-intelligent-search-using-the-quip-connector-for-amazon-kendra/