ProgramAsWeights (PAW) は何をしますか?
ProgramAsWeightsは、短い自然言語の仕様を、テキスト入力を受け取りテキスト出力を返す小さなニューラル関数(「ニューラルソフトウェア」)にコンパイルし、ローカルで実行します。ホスト型APIで一度コンパイルすれば、その後はローカルかつ完全にオフラインで動作し続けます。
- ウェブサイト: https://programasweights.com
- ドキュメント: https://programasweights.readthedocs.io
使用するタイミング
PAWは、タスクがあいまいな text -> text であり、安価で高速、ローカル、かつ再現可能な結果を求める場合に最適です。
- 分類 / カテゴリ化 - 感情、緊急度、意図、トピック、スパム、または
ALERT対QUIETのログ行など。 - 抽出 - メールアドレス、名前、日付、ID、または乱雑/非構造化テキストからフィールドを抽出します。
- フォーマット修復 / 正規化 - 壊れたJSONの修正、日付の正規化、一貫性のない入力をクリーンアップします。
- ファジーマッチング - タイポ耐性のあるマッチング、近似重複検出、フレーズを最も近いオプションにマッピングします。
- トリアージ / ルーティング - ログからノイズを除去したり、リクエストを適切なハンドラにルーティングします。
これは、脆弱な正規表現や高価なアイテムごとのLLM呼び出しを、コンパイル後は約0.05〜0.5秒でローカルかつネットワーク不要で動作する小さな関数に置き換えます。
使用してはいけない場合
- 長文またはオープンエンドな生成(エッセイ、コード、チャット) - 代わりにフルLLMを使用してください。
- 複数ステップの推論、数学、または幅広い世界知識を必要とするタスク。
- 単一テキスト入力 → 単一テキスト出力ではないもの。関数はステートレスであり、仕様 + 入力 + 出力で約2048トークンのウィンドウを共有します。
使用方法(ワークフロー)
1. まずハブを確認する。 誰かが既に関数を公開しているかもしれません。コンパイル前にスラッグを試してください。
import programasweights as paw
fn = paw.function("email-triage") # 一度ダウンロードし、その後はローカルで実行
fn("緊急: サーバーがダウンしています!") # "immediate"
fn("ニュースレター: 春のピクニック") # "wait"
2. さもなければ自分でコンパイルする。 良い仕様とは、説明に加えて、いくつかの Input: ... Output: ... の例と明示的な出力制約です。
import programasweights as paw
fn = paw.compile_and_load("""
サポートチケットを分類します。以下の中から一つだけ返してください: billing, bug, feature, other.
Input: 今月2回請求されました
Output: billing
Input: エクスポートボタンが動作しません
Output: bug
Input: ダークモードを追加してください
Output: feature
""")
fn("私のカードが再度引き落とされました") # "billing"
3. テストケースで反復する - 最も重要なプラクティス。 最初の結果を受け入れないでください。小さな入力/期待値のペアを作成し、精度を測定し、表現と例を洗練させて再コンパイルし、十分な精度になるまで繰り返します。ソフトウェアのように扱ってください。テスト、特定の失敗をデバッグし、仕様を修正し、再テストします。最小限の評価ループ:
import programasweights as paw
tests = [
{"input": "今月2回請求されました", "expected": "billing"},
{"input": "エクスポートボタンが動作しません", "expected": "bug"},
{"input": "ダークモードを追加してください", "expected": "feature"},
]
fn = paw.compile_and_load(open("spec.txt").read())
results = [(t, fn(t["input"]).strip()) for t in tests]
misses = [(t, got) for t, got in results if got != t["expected"]]
print(f"精度: {(len(tests) - len(misses)) / len(tests):.0%}")
for t, got in misses: # 失敗を調査し、仕様を修正して再コンパイル
print("FAIL:", t["input"], "-> 取得", repr(got), "期待", repr(t["expected"]))
references/writing-good-specs.md を参照して、失敗をデバッグする方法を確認してください。
4. プログラムIDまたはスラッグを保存し、ローカルで再利用する。 最初のアセットダウンロード後、推論にサーバーは不要です。
インストール
pip install programasweights --extra-index-url https://pypi.programasweights.com/simple/
ブラウザ / JavaScript: npm install @programasweights/web。compiler="paw-4b-gpt2" でコンパイルされた関数は、WebAssemblyを介してクライアントサイドで実行されます。references/browser-sdk.md を参照してください。
どこで何が実行されるか(データフロー - 使用前に読んでください)
- コンパイル は、仕様をホスト型PAW API (
https://programasweights.com) に送信し、プログラムIDを返します。仕様に機密情報を入れないでください。 - 推論はローカルで実行 され、SDKを通じて最初のダウンロード後はオフラインでも動作します。
- 認証はオプション - 匿名使用も可能です。より高いコンパイルレート制限や名前付きスラッグが必要な場合のみサインインしてください (
export PAW_API_KEY=paw_sk_...)。
詳細(必要に応じて参照)
- 完全なAPI、コンパイラ、バージョニング、チェイニング、認証:
references/api.md - 仕様の作成とデバッグ:
references/writing-good-specs.md - ブラウザ / JavaScript SDK:
references/browser-sdk.md - 一般的なエラーと修正:
references/troubleshooting.md - 実際のケーススタディ(ログ監視、セマンティック検索、ツール呼び出し): https://programasweights.readthedocs.io