Docwize Forge

Docwize Forge を使うと、ユーザーはワークフローノード — Forge ファンクション — として実行されるカスタムコードをアップロードできます。ファンクションはワークフローのドキュメントとそのファイルを受け取り、ユーザー自身のロジックを実行して、ワークフローが次にどのブランチへ進むかを決める結果を返します。

New > Workflow Setup > Forge からアクセスします。

Docwize Forge の概要

利用状況の上限

ページの上部には、月次の上限を示す2つのメーターが表示されます。

メーター	内容
Runs this month	今月使用したファンクション呼び出し回数を、プランの上限（例: 0 / 10,000）と対比して示します。
Compute this month	今月使用したコンピュートの GB秒数を、プランの上限（例: 0.0 GB-s / 10,000.0 GB-s）と対比して示します。

両方のメーターは、Resets の隣に表示されている日付にリセットされます。

テンプレートから始める

Start from a template セクションでは、ダウンロード可能な4種類のスターターが提供されます。いずれもダウンロード後、アップロード前にローカルで実行できる、動作するファンクションです。

テンプレート	説明
Python 3.12	型付きの Event/Result SDK を1つのベンダー同梱ファイルにまとめたものです。最も手早く始められる方法で、システム依存が必要な場合を除きこちらを選ぶのが適切です。
Node 20	Python 版のスターターと同じ Event/Result の形を持つ、async/await ハンドラーです。依存関係はバンドルにベンダー同梱されています。
Go	依存関係のないスタティックバイナリにコンパイルされ、3つの中で最も速いコールドスタートを実現します。標準ライブラリのみを使用します。
Container (any language)	任意のベースイメージ、任意の言語、任意のシステムパッケージを持ち込めます。プログラムは標準入力で JSON を読み取り、標準出力に JSON を書き出します — SDK は不要です。付属のサンプルは、zip ベースのランタイムでは提供できない jq と poppler を使用する Bash です。

ファンクションのアップロード

ファンクションを作成したら、Upload bundle をクリックしてアップロードダイアログを開きます。

ルートに docwize.forge.json を含む zip を選択してください。ランタイム、エントリーポイント、アウトプットルート、設定キーなど、ファンクションに関するすべての情報はそのマニフェストから読み取られます。

このダイアログは、ドロップされた .zip またはファイルピッカーで選択された .zip を受け付け、docwize.forge.json の形式についてさらに詳しい情報がある The manifest リンクを含みます。

アップロードコントロールの横にある Docs と Quick start ボタンから、ファンクションの作成とパッケージ化に関する詳しいガイダンスを参照できます。

アップロード済みファンクションの管理

アップロードされた各ファンクションは、テンプレートの下にカードとして表示され、ランタイム、ステータス（例: ACTIVE）、現在のバージョン（例: v4 in use）、slug、ルート数、過去30日間の実行回数、最終実行時刻が示されます。カード上のゴミ箱アイコンでファンクションをアーカイブできます。

ファンクションのカードをクリックすると詳細ダイアログが開き、2つのタブがあります。

タブ	内容
Versions	アップロードされたファンクションのすべてのバージョンで、それぞれのステータス、アップロード時刻、バンドルサイズ、短いコミット風のハッシュが表示されます。有効なバージョンには in use の表示があり、それより古いバージョンには、そのバージョンにロールバックするための Activate ボタンが表示されます。
Runs	ファンクションの直近の呼び出し履歴で、それぞれステータスバッジ（例: COMPLETED）、一致したアウトプットルート、実行時間（ミリ秒）、タイムスタンプ、実行されたワークフローインスタンス（例: Workflow #931）、アウトプットログの行数が表示されます。

Forge ファンクション詳細 — Runs タブ

Forge ファンクションの作成と使用方法

ステップ	説明
1	Start from a template から、必要なランタイムに合ったスタータテンプレート — Python 3.12、Node 20、Go、または Container — をダウンロードします。
2	ローカルでファンクションを作成し、テストします。スターターの Event/Result の形（Container の場合は標準入出力の JSON）が、入ってくるデータと、ワークフローをどの結果ルートへ進めるかを定義します。
3	ファンクションを、ルートに docwize.forge.json マニフェストを含む .zip としてパッケージ化します。マニフェストの形式については、アップロードダイアログの The manifest リンクを参照してください。
4	Upload bundle をクリックし、.zip をドロップまたは選択します。ランタイム、エントリーポイント、アウトプットルート、設定キーはすべてマニフェストから読み取られます。
5	アップロードされると、そのファンクションはカードとして表示され、ワークフローのノードパレットの Forge Functions カテゴリでノードとして利用できるようになります。
6	そのファンクションのノードをワークフローテンプレートに追加します。アウトプットポートは、マニフェストで宣言されたルート（例: Appended、No PDF、Error）に対応します — 連携ノードを参照してください。
7	後でファンクションを更新するには、新しい .zip で再度 Upload bundle をクリックします。以前のバージョンは、そのファンクションのカードの Versions タブからロールバックできる状態で残ります。

関連する設定

• ワークフローノード — アップロードされた Forge ファンクションがワークフローのステップとして使用される場所
• ワークフローテンプレートの構築 — ノードをテンプレートに組み立てるキャンバス