使いどころ
次のような場面でアプリ内エージェントを活用してください:- 手持ちのデータを把握する — 「このプロジェクトにあるセル仕様と測定を教えて」
- その場でシミュレーションを実行する — 「パラメーター化モデルの 1 つで 1C 放電を実行して、電圧と時間のグラフを見せて」
- 測定にモデルをフィットする — 「セルの 1 つに ECM をフィットして、電圧のオーバーレイを表示して」
- 文脈を理解した支援を受ける — スタディ、セル、測定のページから、ID を明示せずに「このスタディを要約して」や「この測定で気になる点は?」と尋ねられます。
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、結果値、画像、エラートレースバック)を含むコードセルになります。 - あなたのプロンプトとエージェントの散文はマークダウンセルになります。
- インラインプロットは埋め込み画像になります。
エクスポートには会話とキャプチャされた出力が含まれますが、実行時の環境は含まれません。セルを再実行するには、コードが import するライブラリを揃えた独自の Python 環境が必要です — 通常は
ionworks(Python API クライアントを参照)に加えて、一般的な科学計算スタック(pybamm、numpy、pandas、matplotlib)です。プロンプト例
チャットに以下のいずれかを貼り付けて、エージェントの動きを試してみてください。データを探索
シミュレーションを実行
モデルをフィット
コンテキスト付き(ページコンテキストを使用)
要件と制限
- サインイン済みの 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 も併せて更新してください。エージェントに任せる場合:
エージェントへの依頼
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 なら Gemini CLI は展開したフォルダーを拡張機能としてインストールし (
~/.claude/skills/、Cursor なら ~/.cursor/skills/、Copilot なら .github/skills/ です:gemini extensions install ~/ionworks-skills)、Codex はローカルプラグインとしてインストールします。正確なコマンドはツールキット同梱の README.md を参照してください。3
SDK をインストールして API キーを設定する
スキルは Python クライアントを呼び出すため、エージェントがコードを実行する環境にインストールしておく必要があります:Studio の Account ページで API キーを作成し、環境変数として設定します:
4
動作を確認する
エージェントに
install スキルを使うよう指示してください — SDK のセルフチェックが実行され、不足しているものが報告されます。手動で更新する
置き換えが必要なコピーは 2 つあります。チェックアウトと、そこからエージェントにコピーしたスキルです。上書きではなく削除してください — 上書き展開やコピーはマージになるため、上流で削除されたスキルが残り、エージェントはそれを読み込み続けます。 インストール済みのスキルはチェックアウトを更新する 前 に削除してください。削除対象の一覧は古いチェックアウトから得るもので、廃止されたスキルは新しいチェックアウトには含まれません。ダウンロードは Studio のログインに紐づいており、スキル自体は認証情報を含みません。各スキルは実行時に環境変数
IONWORKS_API_KEY を読み取るため、エージェントの操作はすべてあなたのアカウント権限のもとで実行されます。関連項目
- Python API クライアント — エージェントが使用しているのと同じ SDK。自分のスクリプトから直接呼び出せます。
- クイックスタート — エージェントが扱える対象を用意するために、プロジェクト、セル、パラメーター化モデルを作成します。