AI によるプロトコル作成

​

表示される場所

• プロトコル未読み込み — Enter prompt to generate protocol using AI, e.g. "1C/1C cycling for 100 cycles between 4.2 V and 2.5 V"
• プロトコルが既に読み込まれている場合 — Enter prompt to change protocol using AI, e.g. "make it 200 cycles"

​

良いプロンプトの書き方

• C レートまたは電流 — 1C、C/3、10 A
• 電圧範囲 — between 4.2 V and 2.5 V
• サイクル数、休止時間、温度
• 電圧範囲以外の 終了条件（容量劣化、時間上限など）

​

例

1C/1C cycling for 200 cycles between 4.2 V and 2.5 V with 10-minute rests
between charge and discharge.

GITT at C/10 with 20 discharge pulses, 30 minutes each, followed by 2 hours
of rest.

Formation: three CC-CV charge/discharge cycles at C/20 between 4.2 V and 3.0 V.

​

セル仕様のコンテキスト

​

明確化のための質問

​

保存済みプロトコルの提案

​

説明と前提

• Explanation — プロトコルが行う内容を 1 文で説明します。
• Assumed: — 明示していないのにジェネレーターが選んだ値 （標準的な休止時間、既定温度など）が列挙されます。実行前に必ず 確認してください。同意できない項目は、編集プロンプトを 1 回打てば 修正できます。

​

AI で修正

​

API

curl -X POST "https://api.ionworks.com/protocols/generate" \
  -H "Authorization: Bearer $IONWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "1C/1C cycling for 200 cycles between 4.2 V and 2.5 V with 10-minute rests",
    "cell_specification_id": "cell-spec-id"
  }'

import httpx

response = httpx.post(
    "https://api.ionworks.com/protocols/generate",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "prompt": (
            "1C/1C cycling for 200 cycles between 4.2 V and 2.5 V "
            "with 10-minute rests"
        ),
        "cell_specification_id": "cell-spec-id",
    },
    timeout=120,
)
result = response.json()

​

リクエスト

​

レスポンス

​

エラー

• 422 — 不正なリクエスト（空プロンプト、フィールド過大、 clarifications が 20 件超など）。これらはリクエストモデルの検証エラーで あり、BAD_REQUEST ではなく FastAPI 標準の検証レスポンスとして返ります。
• 502 — モデルが有効なプロトコルを生成できませんでした。試験内容を 言い換えるか、プロトコルビルダー で 構築してください。

​

制限とヒント

• prompt は 4000 文字、任意の UCP ペイロードは 100,000 文字、 回答は 1 セッションあたり 20 ラウンドが上限です。それを超える場合は リクエストを分割するか、値をご自身で確定してください。
• ジェネレーターは呼び出しごとにフロンティアモデルを使用します。良い プロトコルができたら実験テンプレート として保存してください。再利用は無料です。
• 完全に決定論的に作成したい場合（モデルを介したくない場合）は、 プロトコルビルダー を使うか、UCP YAML を直接記述してください。

​

次のステップ