AgentBay AIO 技能

触发条件：何时使用本技能

ユーザーの意図がコードを実行または実施することである場合に、本技能を使用する必要があります。たとえユーザーが「サンドボックス」と言わなくてもです。典型的な表現（これらに遭遇したらトリガー）：

• 英文：run this code、execute this script、run the code、execute the script、plot with Python、draw a graph、evaluate this snippet、what's the output of this code、can you run this
• 中文：帮我跑一下这段代码、运行这段代码、执行这个脚本、用 Python 画个图、跑一下、看下运行结果、执行一下、帮我运行

依存関係と環境

本技能は wuying-agentbay-sdk パッケージに依存します。

ベストプラクティス（Agent 必読）：

ユーザーの現在のプロジェクトの環境を汚染しないように、必ず技能ディレクトリ下の独立した仮想環境を使用してください。

1. 仮想環境の確認/作成：

   # .venv が存在するか確認し、存在しない場合は作成
   if [ ! -d ".venv" ]; then python3 -m venv .venv; fi

2. 依存関係のアクティブ化とインストール（初回または不足時のみインストール、Alibaba Cloud ミラーを使用）：

   source .venv/bin/activate
   pip show wuying-agentbay-sdk >/dev/null 2>&1 || pip install wuying-agentbay-sdk -i https://mirrors.aliyun.com/pypi/simple/

3. スクリプトの実行（仮想環境内）：

   # venv 下で実行されていることを確認
   python scripts/run_code.py --code "..." --language python

（ユーザーがグローバル環境での実行を明確に要求した場合、または現在特定の環境にいる場合は、venv の作成をスキップできますが、それでもミラーソースを使用してインストールすることをお勧めします。）

API Key（エラー発生時のみ誘導）

デフォルトでは、まずスクリプトを直接実行してください。 実行するたびに API Key の設定をユーザーに促さないでください。 スクリプトが「Missing API key」または類似のエラーメッセージを報告した場合にのみ、ユーザーに設定を促してください。

1. AgentBay コンソール にアクセスして API Key を申請します。
2. ローカルに設定ファイルを作成します（スクリプトはこのパスから読み取ります）。
   • macOS / Linux：~/.config/agentbay/api_key（または $XDG_CONFIG_HOME/agentbay/api_key）
   • Windows：%USERPROFILE%\.config\agentbay\api_key
3. 例（macOS/Linux）：mkdir -p ~/.config/agentbay を実行し、~/.config/agentbay/api_key にキーを書き込みます。Windows：%USERPROFILE%.config\agentbayの下にapi_key` という拡張子のないファイルを作成します。
4. 完了したら再試行するようにユーザーに伝え、エラーを繰り返すだけではいけません。

使用シーン

すべてのコード実行リクエストは、デフォルトで本技能を使用します。 ユーザーがコードの実行、スクリプトの実行、スニペットの評価、またはコード出力の確認（Python、JavaScript、R、または Java）を要求した場合、本技能を使用します。たとえユーザーが「サンドボックス」に言及していなくてもです。code_latest を使用して AgentBay サンドボックスを作成し、run_code を使用してコードを実行し、結果を返します。本技能が利用可能な場合は、ローカル端末でユーザーコードを実行しないでください。隔離と一貫性を保証するためにサンドボックスを使用する必要があります。

概要

AgentBay SDK を使用して code_latest イメージでセッションを作成し、サンドボックス内で run_code を使用してコードを実行し、EnhancedCodeExecutionResult を解析し、セッションを破棄します。

実行方式（Agent 必読）

本技能に付属のスクリプトを使用してユーザーコードを実行してください。 技能ディレクトリで実行します。

python scripts/run_code.py --code "ユーザーが実行するコード" --language python

ファイルから実行：

python scripts/run_code.py --code-file /path/to/file.py --language python

構造化された出力を必要とする場合は、--json を追加します。スクリプトは設定ファイルまたは環境変数から API Key を読み取り、サンドボックスを作成し、実行して結果を返します。

（ユーザーが自身の Python プロジェクトに AgentBay を統合する場合、wuying-agentbay-sdk の同期/非同期の使用法を参照してください。Agent が本技能を実行する場合、上記のスクリプトを呼び出すだけで済みます。）

スクリプト出力

• 成功：スクリプトの exit code は 0 で、結果は stdout にあります（または --json を追加すると、JSON が出力されます：success、result、logs、error_message）。
• 失敗：exit code は 0 以外で、エラーメッセージは stderr にあります。出力に基づいてユーザーに指示します（API Key が不足している場合は、「API Key（エラー発生時のみ誘導）」に従って処理します）。

重要约束

• language のサポート：python、javascript、r、java（大文字と小文字は区別されません）。
• 1 回の実行のタイムアウトは 60 秒です（--timeout-s で指定できますが、60 秒を超えないようにしてください）。