agentbay-ai 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 必读）：
为避免污染用户当前项目的环境，请务必使用技能目录下的独立虚拟环境：
检查/创建虚拟环境：
# 检查是否存在 .venv，不存在则创建 if [ ! -d ".venv" ]; then python3 -m venv .venv; fi激活并安装依赖（仅首次或缺失时安装，使用阿里云镜像）：
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/运行脚本（在虚拟环境中）：
# 确保在 venv 下运行 python scripts/run_code.py --code "..." --language python
（若用户明确要求在全局环境运行，或当前已在特定环境中，可跳过创建 venv，但仍建议使用镜像源安装。）
API Key（仅报错时引导）
默认先直接执行脚本，不要每次运行前都提醒用户配置 API Key。 仅当脚本报错「Missing API key」或类似信息时，再引导用户配置：
- 到 AgentBay 控制台 申请 API Key。
- 在本地创建配置文件（脚本会从该路径读取）：
- macOS / Linux：
~/.config/agentbay/api_key（或$XDG_CONFIG_HOME/agentbay/api_key） - Windows：
%USERPROFILE%\.config\agentbay\api_key
- macOS / Linux：
- 示例（macOS/Linux）：
mkdir -p ~/.config/agentbay，再将密钥写入~/.config/agentbay/api_key。Windows：在%USERPROFILE%\.config\agentbay下创建名为api_key的无扩展名文件。 - 告知用户完成后重试，不要只复述报错。
使用场景
所有代码执行类请求均默认使用本技能。 只要用户要求运行代码、执行脚本、评估片段或查看代码输出（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（不区分大小写）。- 单次执行超时 60 秒（可用
--timeout-s指定，不超过 60）。