Skip to main content
Ionworks Agent は、Ionworks Studio に組み込まれた電池モデリングアナリストです。実際の電気化学シミュレーションを実行し、モデルをフィットし、プロジェクト内のデータを探索します — すべてが、現在開いているページに固定されたチャットパネル内で行われます。 Agent はホスト型で提供されます。インストールも API キーの設定も不要 — チャットを開いてすぐに質問を始められます。自分のコーディングエージェントで作業したい場合は、自分のエージェントを使う を参照してください。

使いどころ

次のような場面でアプリ内エージェントを活用してください:
  • 手持ちのデータを把握する — 「このプロジェクトにあるセル仕様と測定を教えて」
  • その場でシミュレーションを実行する — 「パラメーター化モデルの 1 つで 1C 放電を実行して、電圧と時間のグラフを見せて」
  • 測定にモデルをフィットする — 「セルの 1 つに ECM をフィットして、電圧のオーバーレイを表示して」
  • 文脈を理解した支援を受ける — スタディ、セル、測定のページから、ID を明示せずに「このスタディを要約して」や「この測定で気になる点は?」と尋ねられます。
スクリプト化された繰り返し作業(CI、バッチパラメーター化、無人で再実行したいものなど)には、代わりに Python API クライアント を使用してください。

2 つの開き方

フローティングチャットウィジェット

すべてのダッシュボードページの右下にあるチャットバブルです。クリックすると現在のビューの上にパネルが開きます — エージェントは現在のページを把握しており、ID を明示しなくても「このスタディ」や「このセル」といった参照を解決できます。

フルエージェントページ

Studio サイドバーの Ionworks Agent から、左側にセッション一覧、右側にアクティブな会話が表示されるフル体験を開けます。大きなプロットやコード出力にも十分なスペースがあります。
どちらのビューも同じセッションを共有します — フローティングウィジェットから開始した会話はフルエージェントページからも利用でき、その逆も同様です。

エージェントができること

エージェントはお使いのアカウントと同じ認証済み API を通じてプロジェクトデータにアクセスします。したがってすべての操作は組織の行レベル権限に従います。
  • パラメーター化モデルで PyBaMM シミュレーションを実行 し、結果をチャット内にインラインでプロット。
  • すでにアップロード済みの測定に対して 等価回路モデルや物理ベースモデルをフィット
  • データをクエリ — プロジェクト、セル、測定、スタディ、モデル、パイプラインを一覧表示し、質問するだけでどれでも開けます。
  • サンドボックス環境で Python を実行。コードはチャット内で読み取り専用のノートブックセルとして実行され、stdout、結果、画像も含まれます。各セルは新しいインタプリタで実行されるため、セル間で状態は引き継がれません。エージェントは毎回インポートと client の再生成を行います。
  • ファイルを添付 — 50 MB までの任意のファイルをチャットにドラッグして、エージェントに検査や処理を依頼できます。添付ファイルは会話に保持されるため、以降のターンで添付し直す必要はありません。MATLAB の .mat エクスポートも利用できますが、-v7.3(HDF5)形式で保存されたファイルはサンドボックスでは読み取れません。
  • アプリ内へリンクバック — エージェントがリソースを指し示すときは「このページを開く」ボタンが表示され、チャットを閉じずに移動できます。
  • 操作場所を案内 — 操作方法や場所を尋ねると、エージェントが該当ページへ移動させ、到着後に説明の続きを行います。

ページコンテキスト

/projects/<id>/studies/<id> のようなページやセルインスタンスの測定ページからフローティングウィジェットを開くと、エージェントは現在位置を記述した小さな構造化ノートを受け取ります — ページ名と、表示中のプロジェクト、スタディ、セル仕様、セルインスタンス、測定、モデル、パイプラインの ID が含まれます。 これにより、プロンプトに ID を貼り付けなくても「このスタディ」や「見ている測定」と言うだけで、エージェントが正しく解決してくれます。
送信されるのは ID とページラベルのみで、URL、クエリ文字列、自由形式のページ内容は含まれません。バックエンドはモデルに届く前にノートを再サニタイズします。

セッション

各会話は独立したセッションであり、アカウントに保存されるため、後から再開したり別のデバイスから開いたりできます。セッションはプロジェクト単位にスコープされます — どちらのビューも、現在開いているプロジェクトに属するセッションのみを一覧表示します。
  • フローティングウィジェット は中断したところから再開します。再度開くと、そのプロジェクトで最後に使用したセッションを復元し、それがない場合は最も新しく更新されたセッションにフォールバックします。新しいチャットの開始や過去のセッションへの切り替えは、ウィジェットのセッションメニューから行えます。
  • フルエージェントページ は、そのプロジェクトのセッションを左側の一覧に表示します。いずれかをクリックして再開するか、ヘッダーから新しいチャットを開始します。
実行中のターンはいつでも停止できます — エージェントは現在のツールステップを完了させたうえで、制御をあなたに戻します。

会話をノートブックとしてエクスポート

フルエージェントページのすべての会話には ノートブックをエクスポート(.ipynb) アクションがあります。ダウンロードすると、次のような Jupyter ノートブックが得られます:
  • すべての run_python ステップは、キャプチャされた出力(stdout/stderr、結果値、画像、エラートレースバック)を含むコードセルになります。
  • あなたのプロンプトとエージェントの散文はマークダウンセルになります。
  • インラインプロットは埋め込み画像になります。
結果として、エージェントが生成した解析の完全な記録が得られます — Jupyter で開いて内容を確認し、調整し、あるいは同僚に渡してください。
エクスポートには会話とキャプチャされた出力が含まれますが、実行時の環境は含まれません。セルを再実行するには、コードが import するライブラリを揃えた独自の Python 環境が必要です — 通常は ionworks(Python API クライアントを参照)に加えて、一般的な科学計算スタック(pybammnumpypandasmatplotlib)です。

プロンプト例

チャットに以下のいずれかを貼り付けて、エージェントの動きを試してみてください。
データを探索
シミュレーションを実行
モデルをフィット
コンテキスト付き(ページコンテキストを使用)

要件と制限

  • サインイン済みの Ionworks Studio ユーザーなら誰でも利用可能。追加インストール不要。
  • シミュレーション、フィット、データクエリは あなたの プロジェクトデータに対してアカウント権限のもとで実行されます — すでにアクセス権のあるセル、測定、モデルのみが表示されます。
  • Python 実行はステートレスです。各セルは新しいインタプリタで動作するため、変数は次のセルに引き継がれません。添付ファイルや作業ディレクトリに書き込まれた内容は会話の間は保持されますが、会話をまたいで永続することはありません。
  • 非常に長い会話はモデル側で切り詰められます。完全な記録を保存したい場合は、新しいセッションを開始する前にノートブックにエクスポートしてください。

自分のエージェントを使う

Ionworks Agentic Toolkit は、お使いのコーディングエージェントに Ionworks の操作を教えるものです。アプリ内チャットに切り替えることなく、普段の環境のまま作業できます。データ処理、検証、アップロード、セルと装置の管理、モデルフィット、シミュレーション、パイプライン、レポート作成まで、R&D の一連の流れをカバーします。 実体は Python API クライアント を呼び出す SKILL.md ファイル群のフォルダーです。起動しておくサーバーも、同期を保つ必要のあるものもありません。Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot に対応しています。

エージェント自身にインストールさせる

ダウンロード用エンドポイントは API キーでも認証できるため、エージェント自身にインストールを任せることもできます。Studio の Account ページで API キーを作成し、次のプロンプトをエージェントに貼り付けてください:
エージェントへの依頼
このエンドポイントは認証が必須です(上記の X-API-Key ヘッダー、またはログイン済みの Studio セッションによるダウンロードボタン)。認証なしのリクエストは 401 を返すため、キーがないとコマンドは動作しません。

更新する

ionworks skills update だけで完了しますが、スキルは現行 API に追従するため SDK も併せて更新してください。エージェントに任せる場合:
エージェントへの依頼
現在のツールキットのバージョンは Bring your own agent タブで確認できます。

CLI を自分で実行する

Python SDK には ionworks コマンドが含まれており、ツールキットを取得して検出したエージェントにインストールします。まず Studio の Account ページで API キーを作成してください。
スコープとエージェントの指定は npx skills と同じ規約に従います。既定はプロジェクト単位、-g でユーザーレベルのディレクトリ、-a claude-code cursor で自動検出の代わりにエージェントを明示できます。ionworks skills list でインストール済みの内容とバージョンを確認できます。 更新も同じコマンドの再実行です (ionworks skills update も同一の動作)。新しいスキルを配置する前に前回インストールしたスキルを削除するため、上流で廃止されたスキルが残り続けることはありません。自分で作成したスキルはそのまま保持されます。

手動でインストールする

1

ツールキットをダウンロードする

Studio のサイドバーで Ionworks Agent を開き、Bring your own agent タブに切り替えて、Download ionworks-skills.zip をクリックします。任意の安定した場所に展開してください:
アーカイブ自体が ionworks-skills/ フォルダーを含むため、これで ~/ionworks-skills が作成されます。後から更新する方法は下記の 手動で更新する を参照してください。
2

エージェントに読み込ませる

スキルをエージェントのスキルディレクトリにコピーします — Claude Code なら ~/.claude/skills/、Cursor なら ~/.cursor/skills/、Copilot なら .github/skills/ です:
Gemini CLI は展開したフォルダーを拡張機能としてインストールし (gemini extensions install ~/ionworks-skills)、Codex はローカルプラグインとしてインストールします。正確なコマンドはツールキット同梱の README.md を参照してください。
3

SDK をインストールして API キーを設定する

スキルは Python クライアントを呼び出すため、エージェントがコードを実行する環境にインストールしておく必要があります:
Studio の Account ページで API キーを作成し、環境変数として設定します:
4

動作を確認する

エージェントに install スキルを使うよう指示してください — SDK のセルフチェックが実行され、不足しているものが報告されます。

手動で更新する

置き換えが必要なコピーは 2 つあります。チェックアウトと、そこからエージェントにコピーしたスキルです。上書きではなく削除してください — 上書き展開やコピーはマージになるため、上流で削除されたスキルが残り、エージェントはそれを読み込み続けます。 インストール済みのスキルはチェックアウトを更新する に削除してください。削除対象の一覧は古いチェックアウトから得るもので、廃止されたスキルは新しいチェックアウトには含まれません。
スキルのパスは使用するエージェントに合わせて調整してください。Gemini の拡張機能や Codex のプラグインとしてインストールした場合は、ファイルをコピーする代わりにアンインストールと再インストールを行ってください。
展開が済んだら、あとはエージェントに任せられます。~/ionworks-skills/README.md を読ませ、そのエージェント自身に対応するローカルチェックアウト用のインストール手順に従うよう指示してください。
ダウンロードは Studio のログインに紐づいており、スキル自体は認証情報を含みません。各スキルは実行時に環境変数 IONWORKS_API_KEY を読み取るため、エージェントの操作はすべてあなたのアカウント権限のもとで実行されます。

関連項目

  • Python API クライアント — エージェントが使用しているのと同じ SDK。自分のスクリプトから直接呼び出せます。
  • クイックスタート — エージェントが扱える対象を用意するために、プロジェクト、セル、パラメーター化モデルを作成します。