View a markdown version of this page

Box Agent の統合 - Amazon Quick
[開始する前に]Amazon Quick でのコネクタのセットアップ使用可能なアクションの管理とトラブルシューティング

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Box Agent の統合

Box Agent コネクタを使用すると、Box AI 機能にアクセスし、ファイルとフォルダを管理し、自然言語を通じて Amazon Quick でハブ内のコンテンツを直接整理できます。

Amazon Quick は、Box Agent に対して次の認証方法をサポートしています。

  • デフォルトの OAuth アプリケーション – AWSが管理する OAuth アプリケーションを使用します。追加の認証情報は必要ありません。Box アカウントで直接認証します。

  • カスタム OAuth アプリ – Box デベロッパーコンソールに登録されたカスタマー管理の OAuth 2.0 アプリケーションを使用します。このオプションを使用すると、組織は OAuth 設定を完全に制御できます。

Amazon Quick がサポートする認証方法の詳細については、「」を参照してください認証方法。

[開始する前に]

統合を設定する前に、以下があることを確認してください。

  • ファイルとフォルダにアクセスできる Box アカウント。

  • カスタム OAuth アプリの場合: Box デベロッパーコンソールにアクセスしてカスタムアプリを作成します。詳細については、「 Box ドキュメント」のOAuth 2.0 のセットアップ」を参照してください。

  • Amazon Quick サブスクリプションの要件については、「」を参照してくださいコンソールで統合を設定する。

Amazon Quick でのコネクタのセットアップ

使用可能なタブから接続する

デフォルトの OAuth アプリ認証を使用する場合は、追加の設定なしで、利用可能なタブから直接接続できます。

  1. Amazon Quick コンソールで、コネクタを選択します。

  2. 使用可能タブで、ボックスエージェントを検索し、接続を選択します。

  3. Box サインインフローを完了し、リクエストされたアクセス許可を付与します。

代わりにカスタム OAuth アプリでコネクタを設定するには、以下で説明するようにチーム用に作成タブを使用します。

チームの作成タブから を作成する

カスタム OAuth アプリ認証を使用する場合は、Amazon Quick を設定する前に Box デベロッパーコンソールでカスタムアプリを作成します。セットアップ手順については、Box ドキュメントのOAuth 2.0 のセットアップ」を参照してください。

  1. Amazon Quick コンソールで、コネクタを選択します。

  2. チームの作成タブを選択します。

  3. ボックスエージェントを検索して選択します。

    注記

    Box Agent コネクタが既に存在する場合は、既存のコネクタを含むダイアログが表示されます。既存のコネクタを使用するには、コネクタを選択します。新しいものを作成するには、「いいえ」を選択し、新しいものを作成します。

  4. コネクタの名前を入力します。必要に応じて、 + 説明を追加 を選択して説明を追加します。

  5. Connection type で、Public network を選択します。

  6. OAuth 設定では、次のいずれかを選択します。

    1. デフォルトの OAuth アプリの場合:

      追加の認証情報は必要ありません。[次へ] を選択して続行します。

    2. カスタム OAuth アプリの場合は、次のフィールドを設定します。

      • ベース URL (オプション) – Box API ベース URL。例: https://mcp.box.com

      • クライアント ID – Box アプリのクライアント ID。

      • クライアントシークレット – Box アプリからのクライアントシークレット。

  7. [次へ] を選択します。

  8. Box 認可ウィンドウが開きます。リクエストされたアクセス許可を確認し、Box へのアクセス許可を付与を選択します。

  9. レビューページで、コネクタで使用可能なアクションを確認します。[次へ] を選択します。

  10. 公開ページで、コネクタにアクセスできるユーザーを選択します。組織内のすべてのユーザーに対してアクセスを有効にしたり、特定のチームやグループを検索したりできます。

  11. [公開] を選択します。

使用可能なアクション

コネクタを設定すると、次のアクションを使用できます。

Box Agent の利用可能なアクション
Category [アクション] 説明
AI AI Q&A (ハブ) Box AI を使用して Box Hub に質問をします。
AI AI Q&A (単一ファイル) Box AI を使用して 1 つのファイルに質問をします。
AI AI Q&A (複数のファイル) Box AI を使用して複数のファイルに質問をします。
AI AI 抽出 (フリーフォーム) Box AI をフリーフォーム形式で使用してファイルからメタデータを抽出します。
AI AI 抽出 (構造化) カスタムフィールドまたはメタデータテンプレートに基づいて、Box AI を使用してファイルから構造化メタデータを抽出します。
ファイル ファイルコンテンツの取得 50 MB 未満のファイルのテキスト形式でファイルコンテンツを抽出して返します。
ファイル ファイルの詳細を取得する メタデータ、アクセス許可、バージョンの詳細を含む包括的なファイル情報を取得します。
ファイル ファイルプロパティの更新 名前、説明、タグ、コレクションなどのファイルメタデータを更新します。
ファイル ファイルをアップロードする 新しいファイルを Box にアップロードします。
ファイル ファイルバージョンをアップロードする 既存のファイルの新しいバージョンをアップロードします。
ファイル ファイルの検索 メタデータフィルターとファイル拡張子フィルタリングをサポートするキーワードを使用してファイルを検索します。
フォルダ フォルダの作成 Box に新しいフォルダを作成します。
フォルダ フォルダの詳細を取得する メタデータやコラボレーション設定を含む包括的なフォルダ情報を取得します。
フォルダ フォルダコンテンツを一覧表示する フォルダ内のファイル、フォルダ、ウェブリンクを一覧表示します。
フォルダ フォルダのプロパティを更新する 名前、説明、タグ、コレクションなどのフォルダメタデータを更新します。
フォルダ フォルダの検索 キーワードマッチングを使用してフォルダを名前で検索します。
ハブ ハブの作成 コンテンツを整理するための新しいハブを作成します。
ハブ Hub の詳細を取得する 特定のハブに関する情報を取得します。
ハブ Hub 項目の取得 ファイル、フォルダ、ウェブリンクなど、ハブ内の項目を取得します。
ハブ ハブを一覧表示する 現在のユーザーがアクセスできるすべてのハブを一覧表示します。
ハブ ハブの更新 ハブのタイトルまたは説明を更新します。
ハブ ハブに項目を追加する ハブにファイル、フォルダ、またはウェブリンクを追加します。
コメントとタスク ファイル作成のコメント ファイルに対して新しいコメントを作成します。
コメントとタスク ファイルコメントを一覧表示する ファイルに関するすべてのコメントを一覧表示します。
コメントとタスク タスクを一覧表示する ファイルに関連付けられているすべてのタスクを一覧表示します。
[ユーザー] 自分とは 現在認証されているユーザーに関する情報を返します。

の管理とトラブルシューティング

コネクタの編集、共有、または削除の手順については、「」を参照してください既存の統合の管理。

  • 認証ポップアップが失敗する – ブラウザで Amazon Quick コンソールドメインからのポップアップが許可されていることを確認します。

  • 無効なクライアント認証情報 (カスタム OAuth アプリ) – クライアント ID とクライアントシークレットが Box デベロッパーコンソールアプリの値と一致していることを確認します。

  • アクセス許可が不十分 – Box アカウントが、アクセスしようとしているファイル、フォルダ、またはハブにアクセスできることを確認します。