> ## Documentation Index > Fetch the complete documentation index at: https://developer.box.com/llms.txt > Use this file to discover all available pages before exploring further. > 独自の自動化インフラストラクチャを稼働させることなく、管理されたエージェント型コンテンツワークフローを構築します。 # インテリジェントなワークフロー export const RelatedLinks = ({title, items = []}) => { const getBadgeClass = badge => { if (!badge) return "badge-default"; const badgeType = badge.toLowerCase().replace(/\s+/g, "-"); return `badge-${badge === "ガイド" ? "guide" : badgeType}`; }; if (!items || items.length === 0) { return null; } return
{}

{title}

{}
{items.map((item, index) => {} {item.badge} {} {item.label} )}
; }; export const Link = ({href, children, className, ...props}) => { const localizedHref = localizeLink(href); return {children} ; }; Boxはコンテンツ中心のインテリジェントなワークフロー向けに構築されています。Box AutomateはBoxの権限、コラボレーション、リテンション、監査の設定をそのまま継承しているファイルやフォルダ上で、トリガー、AIエージェント、人、ドキュメント処理を連携させます。Box Doc Genはテンプレートからビジネスドキュメントを生成し、管理された同じコンテンツレイヤーに書き戻します。コンテンツを別の自動化システムやAIシステムにコピーするのではなく、すでに使用しているドキュメントを中心に業務を設計する方法を説明します。 [Box Automate](https://developer.box.com/guides/box-automate/index)と[Box Doc Gen](https://developer.box.com/guides/docgen)は無料のDeveloperプランに含まれません。 ## インテリジェントなワークフローにBoxが最適な理由 ワークフローの信頼できる唯一の情報源が**エンタープライズコンテンツ**であり、そのコンテンツレイヤーから移動することなく自動化、AI活用、ドキュメント作成を行う必要がある場合は、Boxがおすすめです。 * **コンテンツガバナンスの確保** — ワークフローはBoxのファイルとフォルダに対して実行されます。アクセストークンとコラボレーションは引き続き適用されます。APIを使用してウォーターフォール権限を回避することはできません。セキュリティの概要を参照してください。 * **イベント駆動型および人間駆動型のトリガー** — Box Automateのワークフローは、ファイル/フォルダイベント、メタデータ、タスク、ファイルリクエスト、Box Sign、フォーム、手動開始、HTTPSから開始できます。 * **ワークフローステップとしてのAI** — AutomateでBox AIを使用して、メタデータの抽出、コンテンツの要約、質問への回答を行い、その結果に基づいてワークフローをルーティングします。 * **ドキュメント作成** — Box Doc Genを使用し、API JSON (またはBox Automateの結果) からMicrosoft Wordテンプレートに入力して、生成された`docx`または`pdf`ファイルをBoxに書き戻します。 * **製品間の引き継ぎ** — 1つのBox Automateフローでアップロード、メタデータ、Box Doc Gen、Sign、タスク、通知、外部HTTPSコネクタを組み合わせることができます。 * **開発者コントロール** — Platformアプリは標準的なBox認証での認証、コンテンツAPIに対するコール、手動ワークフローの開始、(有効化されている場合は) Box AutomateとBox Doc Genのエンドポイントに対するコールを実行します。 Boxはファイルに一切触れない任意のSaaSとSaaSを接続する汎用iPaaSでは**ありません**。プロセスがドキュメント中心 (アクセス権限が維持され、監査可能な状態にしておく必要があるコンテンツの取り込み、分類、生成、レビュー、署名、ルーティング、アーカイブ) の場合に、Boxは最も力を発揮します。 ### インテリジェントなワークフローの機能 Boxコンテンツのネイティブなエージェント型ワークフロー自動化 — トリガー、AIエージェント、結果、分岐、ループ、変数を利用可能で、新しいインテリジェントなワークフローに最適です。 テンプレートと構造化データからテンプレートベースのドキュメントを生成します。 `GET /workflows`と`POST /workflows/:id/start`を使用して既存の手動開始Box Relayワークフローのリストを取得、開始します。 **新規**作成には、**Box Automate**を使用します。手動開始Box Relayワークフローのリストを取得または開始する既存のアプリケーションでは、今後もこれらのAPIを使用できます。新規プロジェクトではAutomateを利用してください。 ### 適切な機能の選択 Box Automateから始めます。1回の実行にトリガー、AI、分岐、人間によるレビューが含まれるエージェント型オーケストレーションを作成できます。トリガー、結果、ロジックを参照してください。 Box Automateから始めます。コンテンツを識別可能なトリガーや外部トリガーによって、カスタムワーカーを用意しなくても統制された実行を開始できます。トリガー、結果、ロジックを参照してください。 Box Automateの手動開始またはBox Relayの手動開始フローを使用します。どちらもプログラムによる開始をサポートしています。Box Automateが有効な場合は、新規作成にBox Automateを使用してください。 Box Doc Genから始めます。これは目的特化型の生成APIであり、Boxフォルダに出力が格納されます。ドキュメントの生成を参照してください。 Box Automate + Box Doc Genを使用します。Automateでは結果としてドキュメント生成を含めることができ、Doc Gen APIに対しては引き続き直接コールを実行できます。 Box Relayを使用します。`GET /workflows`でワークフローのリストを取得し、`POST /workflows/:id/start`でワークフローを実行します。 ## エンドツーエンドのインテリジェントなコンテンツワークフロー Boxの基礎レイヤーであるBox Automate内で実行されているトリガー、AIエージェント、結果を示した図。HTTPコネクタも表示されています。 インテリジェントなコンテンツワークフローの**基礎レイヤーはBox Automate**です。トリガー、AIエージェント、結果は、管理されたBoxコンテンツで実行されるAutomateワークフローのステップです。 * **トリガー** — コンテンツまたはフォーム入力が届いたときに、フォルダとファイルのイベントおよびBox FormsによってAutomate実行が開始されます。 * **AIエージェント** — カスタムエージェント、Box Extract、Box AIによって、同じAutomateワークフロー内のコンテンツの優先順位付けと充実が図られます。 * **結果** — メタデータの追加、タスクの割り当て、ファイルとフォルダのアクションの実行、Box Signによる署名リクエスト、Box Doc Genによるドキュメント生成、またはHTTPコネクタを通じた外部システムの呼び出しを行います。 Automate自体は**Box**上にあり、セキュリティとコンプライアンス、コンテンツプラットフォーム、コラボレーション、統合は、すべての実行の基盤として機能します。 関連する機能が、同じソリューション設計に組み込まれることもよくあります。 ワークフローの途中または後で行う電子サインをリクエストします。 取り込みでBox Automateをトリガーできます。 Box Automate AI機能が有効な場合に使用できるカスタムエージェントを作成します。 構造体がトリガー、分岐、抽出に使用されます。 ビルダーの外部にあるカスタムアプリ向けに、別の方法または補完的な方法でイベントを配信する機能です。 ## Box Automate Box Automateは、Box上にネイティブに構築されたワークフロー自動化プラットフォームです。方向性のあるグラフとして**ワークフロー**を設計します。ワークフローは、**トリガー**により実行が始まり、フローが終了するまで**結果**を実行します。ビルダーは条件付き分岐、ループ、変数、ステップ間で渡されるデータ (AIエージェントの出力を含む) をサポートしています。 ### Box Automateで作成すべき理由 Webhook、カスタムワーカー、直接のBox APIコールを組み合わせて同じ結果を実現できますが、**管理された自動化**が必要な場合は、他のシステムを使うよりもBox Automateの方がデフォルトで適しています。 * ワーカー、キュー、再試行、スケジューリングをホストする * 各ステップに権限チェックを再実装する * 複数のサービスにまたがる監査証跡を自分で構築する * AI、ルーティング、タスク、Doc Genを手作業で実装する * 新しいコンテンツイベントそれぞれにカスタム連携処理を追加する * 管理が必要な自動化インフラストラクチャなしで、Boxによってワークフローが実行される * ステップが既存の権限とコラボレーションを継承する * アクティビティはBoxのコンテンツ上に維持され、エンタープライズレベルの監査とガバナンスが適用される * エージェントと人間によるステップが1つのビジュアルワークフローに含まれる * コンテンツを認識するトリガーにより自動的に実行される 単一のアクションをアプリ側で細かく制御する必要がある場合は、Platform APIを使用します。製品が自前のオーケストレーション基盤を使わずに安全性、監視性、保守性を確保する必要のある**プロセス** (マルチステップのコンテンツを中心とした作業) である場合は、Automateを使用してください。 ### Box Automateによるエージェント型オーケストレーション Box Automateの戦略的差別化要因は**エージェント型オーケストレーション** (決められたルールに基づいてファイルを移動させるだけでなく、AIエージェントを呼び出し、その出力を処理して、判断が必要な場合はユーザーやシステムに引き継ぐワークフロー) です。 実際には、以下のことが可能になります。 * **フロー内でカスタムエージェントを実行する** — 企業で有効化されている場合、AutomateのAI機能は、ナレッジソース、引用情報、推論のトレースを利用するカスタムエージェントと連携します。Box AI StudioおよびBox Automateの概要を参照してください。 * **Boxコンテンツに基づいてエージェントを動作させる** — 抽出、要約、Q\&Aは、データのコピーを別途参照するのではなく、ワークフロー内のファイルやフォルダに対して実行されます。 * **エージェントの出力に基づいて処理を分岐させる** — 構造化されたAIの結果は、その後の結果 (ルーティング、メタデータの強化、ドキュメントの生成、タスクの割り当て、または外部APIの呼び出し) における変数や条件となります。 * **人間をワークフローに組み込む** — 承認タスクや一般タスクをエージェントのステップと並べて配置することで、元に戻すことができない操作 (削除、外部との共有、法務部門への送付) についてはレビューを必須にできます。結果の検証が必要な場合は、AIのステップの後にレビューステップを配置することをお勧めします。 * **コンテンツライフサイクル全体を調整する** — 1つのワークフローの中で、取り込み、エージェントによるトリアージ、Doc Gen、Sign、コラボレーション、通知、HTTPSコネクタを組み合わせ、Boxのガバナンスの下で運用することができます。 エージェント、コンテンツの権限、永続的なワークフローロジックを組み合わせることで、インテリジェントなエージェント型ワークフローのための強力なプラットフォームが実現されます。また、1つのワークフローの中で、取り込み、エージェントによるトリアージ、Doc Gen、Sign、コラボレーション、通知、HTTPSコネクタを組み合わせ、Boxのガバナンスの下で運用することもできます。 ### トリガー、結果、ロジック 正確なトリガーと結果の種類は、プランや構成によって異なります。 * **ファイルイベント** — アップロード、移動、コピー、ダウンロード、削除、プレビュー、ロック/ロック解除、電子すかしの削除、コラボレータの追加、分類の適用、メタデータを含むファイルに関する操作。 * **フォルダイベント** — 作成、移動、コピー、ダウンロード、削除、コラボレータの追加。 * **タスク** — 一般タスクまたは承認タスクの完了 (承認/拒否の場合を含む)。 * **ファイルリクエスト** — コンテンツをフォルダに保存するフォーム入力の完了。 * **Box Sign** — 完了、拒否、期限切れ、キャンセル。 * **メタデータ** — テンプレートの適用、ファイルまたはフォルダに関するフィールドの変更。 * **手動開始** — ユーザーがBoxウェブアプリから開始 (API経由での開始も可能)。 * **フォームの送信** — ご利用のプランでBox Formsが有効になっている場合。 * **HTTPSリクエスト** — ワークフローに割り当てられた一意のURLを介して、外部システムが実行を開始。 * **ファイルとフォルダ** — 移動、コピー、名前の変更、削除、ロック/ロック解除、電子すかし、コラボレーション、分類、および関連する操作。 * **タスクと通知** — 承認タスクや一般タスクの割り当て、変数を利用した動的なコンテンツを含むメールの送信。 * **メタデータ** — メタデータの適用、更新、抽出 (AIを活用したものを含む)。 * **AIとエージェント** — メタデータ抽出、要約、Q\&A。ナレッジソース、引用情報、および推論トレース (有効になっている場合) を利用するカスタムエージェント。構造化されたAI出力を後続の条件で利用。 * **ドキュメントの生成と署名** — Box Doc GenおよびBox Signの結果 (有効になっている場合)。 * **外部システム** — カスタムHTTPSリクエストの結果 (コネクタ、認証、ヘッダー、JSON本文)。管理者の許可リストの対象。 * 条件に基づく分岐 (例えば、承認タスクが承認されたか拒否されたか、AIによる分類の結果)。 * **For Each**によるユーザー、ファイル、またはフォルダコンテンツのループ処理、最大回数を指定した**ループバック**。 * 変数と並列パス後の結合。 * HTTPS経由で連携する際の、ネストされたペイロードに対するJSONPath形式での読み取り。 詳細については、トリガー、結果、ロジックを参照してください。 ### 開発者による統合 Box管理者と連携して、Box Automate (およびBox AI Studioなどの関連製品) を有効にします。詳細については、Box Automateの使い方を参照してください。 フォルダの \[手動で開始] ワークフローのリストを取得し、ファイルおよび実行時フィールドを使用してワークフローをトリガーします (リクエストごとに最大20ファイル)。 AutomateワークフローAPIベータ版 (`v2026.0`): 呼び出し可能なBox Automateワークフローのリストを取得し、Box Automateワークフローを開始します。 ## Box Doc Gen Box Doc Genは、Boxに保存されている**Box Doc Genテンプレート**から、ビジネスドキュメント (採用通知書、契約書、請求書、合意書など) を生成します。テンプレートは、Microsoft Word ([アドイン](https://docs.box.com/en/box-doc-gen/box-doc-gen-installation/installing-the-box-doc-gen-template-creator-add-in-for-microsoft-word)または[タグ付けスクリプト](https://docs.box.com/en/box-doc-gen/box-doc-gen-templates/template-tags-reference-guide-and-examples)) で作成されています。APIは、タグ付きフィールドにJSONの値を設定し、保存先フォルダに出力を書き込みます。 Box Doc Gen APIは、**Enterprise Advanced**アカウントでのみ使用できます。現在、テンプレートタグは英語のみに対応しています。実稼働環境で使用する前に、言語の要件を確認してください。BoxではMicrosoft Wordのライセンス管理を行っていないため、テンプレートを作成する際のMicrosoft Wordへのアクセスはご自身で管理してください。 ### APIの機能 ファイルをBox Doc Genテンプレートとして設定します。 テンプレートやAPIの入力に基づいて、ドキュメントを (単一または一括で) 生成します。 テンプレートおよびドキュメント生成ジョブを調査します。 Box Doc Gen APIのすべてのリクエストでは、`box-version`ヘッダーを`2025.0`に設定する必要があります。Box APIのバージョン管理を参照してください。 ### 一般的な生成フロー あらかじめ定義されたサンプルテンプレートを使用するか、Box Doc Genの[アドイン](https://docs.box.com/en/box-doc-gen/box-doc-gen-installation/installing-the-box-doc-gen-template-creator-add-in-for-microsoft-word)または[タグ付けスクリプト](https://docs.box.com/en/box-doc-gen/box-doc-gen-templates/template-tags-reference-guide-and-examples)を使用してテンプレートを作成します。 作成したファイルをBoxにアップロードするか、Box Doc Genテンプレートとして設定します。 テンプレートファイルID、`input_source: api`、JSON `user_input`、`output_type` (`docx`または`pdf`)、および保存先フォルダを指定して、`POST /2.0/docgen_batches`を呼び出します。 詳細については、次の開発者向けガイドを参照してください: 使い方、テンプレートとして設定、テンプレート、ジョブ。 ## 詳細情報 Boxのコンテンツを対象として、トリガー、AI、分岐、統合機能を使用するエージェント型ワークフロー。 Box Automateを有効にし、APIから \[手動で開始] ワークフローをトリガーします。 トリガーの種類、結果、分岐、ループ、および変数。 WordテンプレートとAPIデータからビジネスドキュメントを生成します。 AutomateおよびBox AIで使用されるカスタムAIエージェントを作成および管理します。