見出し画像

Boxに蓄えられた膨大な自社コンテンツを使ってLLMをファインチューニングする(ために文字情報を取り出す) その1


はじめに

突然ですが、Boxに保存した膨大な自社コンテンツを利用してLLMをファインチューニングしたいと思ったことはないですか?自社・自組織の業務用語や業務ナレッジが満載のドキュメントを使ってLLMをファインチューニングすれば、更に生成AIの業務活用が進むのに…と妄想したことはありませんか?

そんな妄想を叶えるべく、今回から数回に分けて、「Box内のコンテンツのテキスト情報をスクリプトで取得する」方法をご説明していきたいと思います。スクリプト言語はPythonでご説明しますが、BoxはPython以外の環境のSDKもあります。また、Box CLIというコマンドラインインターフェースが準備されていますので、PowerShellやシェルスクリプトで作成することも可能です。

まず第一回の今回は、「スクリプトからBoxにアクセスするための下準備」です。

  • 前提

    • Box有償アカウントが使えること

  1. Boxの開発者アカウントを準備し、「BoxDEV」Box developerドキュメントサイトにアクセスする

  2. 「Box開発者コンソール」画面で、JWT認証の「Boxカスタムアプリ」を作成・構成する

  3. 作成した「Boxカスタムアプリ」をテナント管理者が承認する

  4. ダウンロードしたJSONファイルの保存を確認する

それではさっそく始めましょう!

1. Boxの開発者アカウントを準備し、「BoxDEV」Box developerドキュメントサイトにアクセスする

自分のBoxアカウントでBoxにログインしている状態で、下記「BoxDEV」サイトにアクセスしてください。

画面右上の「マイアプリ」をクリックしてください。

Box Dev画面で「マイアプリ」をクリック

「開発者コンソール」が表示されます。

開発者コンソール

2.「Box開発者コンソール」画面で、JWT認証の「Boxカスタムアプリ」を作成・構成する

「Box開発者コンソール」画面の「アプリの新規作成」をクリックします。

「アプリの新規作成」をクリック

「アプリの新規作成」画面で「カスタムアプリ」をクリックします。

「カスタムアプリ」をクリック

「カスタムアプリの作成」で、「アプリ名」と「目的」を入力して「次へ」をクリックします。アプリ名は任意の文字列でOKです。目的は何を選んでもカスタムアプリの挙動に関係ありません。

3つのアプリの違いについては下記Box Developerドキュメントをご参照ください。

「カスタムアプリを作成」画面

続く画面で「サーバー認証(JWT使用)」を選択して「アプリの作成」をクリックします。

「カスタムアプリを作成」画面

カスタムアプリが作成されます。 

カスタムアプリが作成される

作成したカスタムアプリの画面の「構成」タブ→「アプリアクセスレベル」を「アプリ+Enterpriseアクセス」に設定します。
「Enterpriseアクセス」があることで、この「カスタムアプリ」を使って作成されたのではないコンテンツにもアクセスできるようになります。

「アプリ+Enterpriseアクセス」を選択

「アプリアクセスレベル」のすぐ次のセクション「アプリケーションスコープ」で、「コンテンツ操作」の「Boxに格納されているすべてのファイルとフォルダの読み取り」が有効かつグレーアウトしていることを確認します。

「アプリケーションスコープ」を確認

更にスクロールダウンすると「公開キーの追加と管理」セクションがあります。サーバー認証カスタムアプリはBoxへの認証に、秘密キーが記載されたJSONファイルを用いますが、そのJSONファイルをここで作成します。「公開/秘密キーペアを生成」をクリックし、ポップアップの「OK」をクリックするとJSONファイルがダウンロードされます。

jsonファイルが生成される

「構成」タブの画面最上部に戻り、「変更を保存」をクリックします。

「変更を保存」をクリック

カスタムアプリが保存されます。

カスタムアプリが保存される

「承認」タブに移動し、「確認を送信」をクリックして、作成・構成したカスタムアプリを利用可能にするために、テナント管理者へ承認を申請します。

「確認して送信」をクリック
「アプリの説明」を入力して「送信」をクリック
承認状況表示画面に遷移する

3. 作成した「Boxカスタムアプリ」をテナント管理者が承認する

カスタムアプリの承認は、テナント管理者が実施する必要があります。テナント管理者権限をお持ちでない場合は、テナント管理者にカスタムアプリの承認をお願いしましょう。

※ テナント管理者にコンタクトができない場合、カスタムアプリの認証設定を(「サーバー認証(JWT使用)」ではなく)「ユーザー認証(OAuth 2.0)」にする方法がありますが、「ユーザー認証(OAuth 2.0)」は自動化用途で利用することはBoxの規約違反となりますのでご注意ください。

テナント管理者でBoxにログインし、「管理コンソール」→「アプリ」→「カスタムアプリマネージャ」タブを表示します。

カスタムアプリマネージャ画面

作成したカスタムアプリの行の右端の「・・・」メニューから「アプリを承認」をクリックします。

「アプリを承認」をクリック

「アプリを承認」ポップアップで内容を確認して「承認」をクリックします。

「承認」をクリック

カスタムアプリが承認されます。

「アプリ承認を追加しました」が表示される

4. ダウンロードしたJSONファイルの保存を確認する

手順2.でダウンロードしたJSONファイルの保存を再度確認しておいてください。作成したカスタムアプリを使ってBoxにアクセスする際に必要になるファイルです。

あわせて、カスタムアプリの「承認」画面で「承認ステータス」が「承認済み」に、「有効化ステータス」が「有効」になっていることを確認しておきましょう。

作成したカスタムアプリが承認されている

これで、スクリプトからBoxにアクセスするための事前準備が終わりました。次回は、BoxにアクセスするPythonスクリプトを実際に記述し実行してみます。

ご覧頂きましてありがとうございました。

この記事が気に入ったらサポートをしてみませんか?