agentbay-aio-skills

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 パッケージに依存します。

ベストプラクティス（エージェント必読）：

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

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 を解析し、セッションを破棄します。

実行方法（エージェント必読）

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

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 の同期／非同期の使用方法を参照できます。エージェントがこのスキルを実行する際は、上記のスクリプトを呼び出すだけで構いません。）

スクリプトの出力

• 成功：スクリプトの exit code は 0 で、結果は stdout に出力されます（--json を追加した場合は、success、result、logs、error_message を含む JSON が出力されます）。
• 失敗：exit code は 0 以外で、エラーメッセージは stderr に出力されます。出力に応じてユーザーに案内してください（API Key が不足している場合は「API Key（エラー時のみ案内）」に従ってください）。

重要な制約

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