<img height="1" width="1" style="display:none" src="https://www.facebook.com/tr?id=139163818022217&amp;ev=PageView&amp;noscript=1"> <img height="1" width="1" style="display:none" src="https://www.facebook.com/tr?id=271598307802760&amp;ev=PageView&amp;noscript=1">

Box CLIでBox AIを使用する方法

 公開日:2025.02.06  更新日:2026.06.10

Box CLIは、ユーザーにとって使いやすいコマンドラインツールです。技術者だけでなく、技術者以外のユーザーもBox APIを利用してルーチンや一括操作を実行できるようになります。これらの操作は一連のコマンドで実行されるため、コーディングは必要ありません。バージョンv3.15.0以降では、Box AIの組み込みコマンドを使用することが可能です。このブログ記事では、設定と基本的な使用例について説明します。

Box CLIにおけるBox AIの主な機能

  1. ドキュメントのQ&Aと要約: Box AIにドキュメントの内容について質問したり、大量のドキュメントの要約を生成して要点を効率的に把握したりできます。
  2. コンテンツの生成: 自然言語のプロンプトを使用してドキュメントの下書きを作成できます。

⚠️ Box AI APIは、Enterprise PlusおよびEnterprise Advancedをご利用のすべてのお客様が利用できます。

設定

Box CLIをインストールする

Box CLIを使用するには、CLIの最新バージョンがインストールされていることを確認してください。インストール手順については、クイックスタートガイドをご覧ください。このチュートリアルでは、パッケージのインストール、Box Platformアプリの作成、認証について説明します。

ℹ️ Box AI APIコールを実行できるようにするには、下記の設定を確認してください。スコープが不十分な場合、次のエラーが発生する可能性があります。

Unexpected API Response [403 Forbidden | 0e652aca531c5ab0627abfa0f89fbf59f.0e652aca531c5ab0627abfa0f89fbf59f] insufficient_scope - The request requires higher privileges than provided by the access token.

管理コンソールでBox AIを有効にする

Box AIを使用するには、適切な設定が適用されていることを確認する必要があります。まず、管理コンソールに移動し、[Enterprise設定] に移動します。[Box AI] タブで、[すべてのユーザーに対してBox AI for APIを有効にしました] までスクロールして有効にします。

0_ySoY4Ree2wtOFisG

次に、開発者コンソールに移動し、使用するPlatformアプリを選択します。アプリの [構成] タブで、[AIを管理する] スコープを有効にします。

0_oBH29mBDSYPMgTKU

最後に、管理コンソールでPlatformアプリが承認され、有効になっていることを確認します。[統合] に移動し、[Platformアプリマネージャ] をクリックします。

0_AI6rTbnirUY9W_25

まれに、トラブルシューティングの操作としてアプリの再承認が必要になる場合があることに注意してください。すべての設定が完了したら、プロンプトの例をいくつかテストする楽しい部分に進みましょう。

Box CLIでのBox AIの使用開始

現在、Box CLIには、Box AIに関連する2つのコマンドとしてbox ai:askbox ai:text-genがあります。Box CLIで使用されるAIモデルはAzure OpenAI GPT-4o Miniです。

box ai:ask

このコマンドは、LLMAIリクエストを送信し、いくつかの追加パラメータを含む回答を返します。

今回選んだサンプルドキュメントには、「The Adventures of Huckleberry Finn (ハックルベリー・フィンの冒険)」という本の最初の数ページが含まれています。この本の著者が誰であるかをBox AIに質問してみましょう。

0_CE7meVwKZQJFLtRD

このコマンドには2つの必須パラメータとしてファイルIDとプロンプトがあります。

box ai:ask --items=id=12345678901234,type=file --prompt "Who is the author of this book?" # この本の著者は誰ですか?

Box CLIにより、AIエージェント情報など、いくつかの追加パラメータとともに回答が返されます。

box ai:ask --items=id=12345678901234,type=file --prompt "Who is the author of this book?" # この本の著者は誰ですか?
Answer: The author of the book is Mark Twain. # この本の著者はマーク・トウェインです。
Created At: '2025-01-30T03:26:12.043-08:00'
Completion Reason: done
Ai Agent Info:
    Models:
        -
            Name: azure__openai__gpt_4o_mini
            Provider: azure
    Processor: basic_text

難易度を少し上げて、この本の章の数について質問してみます。

➜  ~ box ai:ask --items=id=12345678901234,type=file --prompt "How many chapters does this is book have?" # この本は何章までありますか? 
Answer: 'The book contains a total of 43 chapters, including "THE CHAPTER LAST."' # この本は「最終章」を含めて合計43章まであります。
Created At: '2025-01-30T03:47:45.54-08:00'
Completion Reason: done
Ai Agent Info:
    Models:
        -
            Name: azure__openai__gpt_4o_mini
            Provider: azure
    Processor: basic_text

では、Box AIにドキュメントの要約の作成を依頼するとどうなるでしょうか。

box ai:ask --items=id=12345678901234,type=file --prompt "Write a document summary" # ドキュメントの要約を作成してください
Answer: >-
    "The Adventures of Huckleberry Finn" by Mark Twain follows the story of a
    young boy named Huck Finn, who is introduced as a friend of Tom Sawyer. The
    narrative begins with Huck reflecting on his life and experiences,
    particularly after finding treasure with Tom that makes them both wealthy.
    Huck struggles with the constraints of civilized life imposed by the Widow
    Douglas and her sister Miss Watson, who attempt to "sivilize" him. He feels
    trapped and longs for freedom, leading him to escape back into his old ways.
    The story captures Huck's internal conflicts regarding morality, society,
    and his desire for adventure, setting the stage for his journey along the
    Mississippi River.
Created At: '2025-01-30T05:19:03.505-08:00'
Completion Reason: done
Ai Agent Info:
    Models:
        -
            Name: azure__openai__gpt_4o_mini
            Provider: azure
    Processor: basic_text
# 日本語の出力例:
「ハックルベリー・フィンの冒険」は、マーク・トウェインによる小説で、少年ハックが友人ジムと共にミシシッピ川を旅する物語です。ハックは父親から逃げ出し、自由を求めて旅に出ます。
物語の中で、ハックはトム・ソーヤーと深い友情を持っています。トムは冒険心旺盛で、常に新しい計画を立てる性格ですが、ハックはより現実的で慎重な考え方をします。この二人の関係は、お互いの性格や価値観の違いを際立たせています。
また、ダグラス夫人とその妹ミス・ワトソンも重要なキャラクターです。ダグラス夫人はハックに対して優しく接し、彼を育てようとします。一方でミス・ワトソンは厳格な教育者として登場し、道徳や宗教について教えようとしますが、その考え方には反発する部分もあります。
旅の途中でハックとジムは様々な人々と出会い、人種差別や社会的不正義について考える機会が増えます。最終的にはジムの自由を手助けする決断を下すことで、自身の道徳観も成長していきます。この作品はアメリカ文学の古典として広く知られています。

ご覧のとおり、Box AIはドキュメントの内容のかなり広範な要約を返します。これらは基本的な例です。日々の業務の効率化にこのツールがどのように役立つか、可能性を探ってみてください。

次に、2つ目のコマンドについて説明します。

box ai:text-gen

このコマンドはLLMAIリクエストを送信し、新しいテキストの作成に特化した回答を返します。たとえば、Box AIBox CLIに関する詩の作成を依頼することができます。

box ai:text-gen --items=id=12345678901234,type=file --prompt "Write a poem about Box CLI" # Box CLIに関する詩を作成してください   

Ai Agent Info:
    Processor: basic_gen
    Models:
        -
            Name: azure__openai__gpt_4o_mini
            Provider: azure
Answer: |-
    In the realm of code where commands align,  
    Box CLI stands, a tool so fine.  
    With lines of text and options galore,  
    It opens the door to cloud's endless store. 
 
    A whisper of power in each typed command,  
    Managing files with a steady hand.  
    Upload and download with effortless grace,  
    Navigating folders in digital space.  

    Scripts come alive as you harness its might,  
    Automating tasks from morning till night.  
    Collaboration blooms with every deploy,  
    Sharing ideas brings everyone joy.  

    So here's to Box CLI, sleek and bright,  
    Empowering users to reach new heights.  
    In the world of tech where we strive to be free,  
    It's more than a tool; it's our key to unity.  
Created At: '2025-01-30T05:20:51.635-08:00'
Completion Reason: done

# 日本語の出力例:
Box CLIの力強い声、
コマンド一つで道を開く。
ファイル管理が手の中に、
効率的な作業が広がる。

シンプルな操作で進む、
データは瞬時に手元へ。
自動化の恩恵を享受し、
時間を生み出す喜び。

チームと共に築く未来、
共有も簡単に実現する。
情報が集まり、高め合い、
成果は大きく羽ばたいていく。

新しい可能性への旅路、
Box CLIと共に歩もう。
創造の扉を開きながら、
未来を切り拓いてゆこう。

詩の作成以外にも、box ai:text-genは、下書きや契約書などをターミナルから直接生成する際に役立ちます。ぜひお試しいただき、今後の機能強化にご期待ください。 🤓

🦄 Box Platformの他のエキスパートと交流したい場合は、サポートや知識共有のためのBox Developer Community (英語のみ) にご参加ください。


RECENT POST「開発者」の最新記事


開発者

Box、MCPアプリのサポート対象をChatGPT、Microsoft 365 Copilot、Gleanに拡大

開発者

AIエージェントにコンテンツの活用方法を教える: OpenAI Codex向けBox Skillの構築

開発者

Box AIとOpenAI Agents SDKで自律的なドキュメントワークフローを実行

開発者

Box CLI: 開発者とAIエージェントのためのコンテンツCLI