agentbay-aio-skills

name	agentbay-aio-skills
description	用于任何「运行/执行/评估代码」的请求（如 run this code、execute script、用 Python 画图、跑代码/画图/执行脚本）。通过 AgentBay SDK 创建 code_latest 沙箱，调用 run_code 执行并返回结果。支持 Python、JavaScript、R、Java。

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. 激活并安装依赖（仅首次或缺失时安装，使用阿里云镜像）：

   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（不区分大小写）。
• 单次执行超时 60 秒（可用 --timeout-s 指定，不超过 60）。