agentbay-aio-skills
用于任何「运行/执行/评估代码」的请求(如 run this code、execute script、用 Python 画图、跑代码/画图/执行脚本)。通过 AgentBay SDK 创建 code_latest 沙箱,调用 run_code 执行并返回结果。支持 Python、JavaScript、R、Java。
How do I install this agent skill?
npx skills add https://github.com/agentbay-ai/agentbay-skills --skill agentbay-aio-skillsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides code execution capabilities via the AgentBay SDK, allowing users to run code within an isolated sandbox environment. It follows secure practices for managing configuration and API keys, using dedicated local configuration files or environment variables. No malicious behavior or security risks were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
2/2 files flagged
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
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)。
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/agentbay-ai/agentbay-skills/agentbay-aio-skills">View agentbay-aio-skills on skillZs</a>