关于腾讯云代理沙盒/AGS构建的示例、教程和实用工具。

这个收回物箱包含什么

• 技能：参考AGS特工技能示例;参见skills/README.md
• 教程：SDK和基于笔记本的入门
• **示例：可运行浏览器、代码、移动端、Go 和 OSWorld 演示
• 基准测试：k6压力脚本和代理集群舱启动测试
• 工具：调试辅助工具和验证的运行时源组件，如 envd

仓库要求

本地工具

• uv 用于 Python 示例
• python3 用于本地文字
• go 围棋示例
• git
• Docker 对某些工作流程有用，但并非所有示例都必须使用

Python 版本

• examples/ 中的大多数 Python 示例要求 Python >= 3.12
• examples/osworld-ags 使用 Python 3.12.12
• uv 管理每个示例所需的解释器。

AGR CLI

ags 参考 Skill 示例使用 agr CLI：

首次设置凭证时，请遵循以下步骤 官方AGR CLI配置指南， 然后在开始示例前运行 agr status 和 agr doctor。

常见环境变量

AGS / E2B 兼容运行时

腾讯云控制平面示例

Agent Sandbox Cookbook

Examples, tutorials, and utilities for building on Tencent Cloud Agent Sandbox / AGS.

What this repo contains

• Skills: reference Agent Skill example for AGS; see skills/README.md
• Tutorials: SDK and notebook-based onboarding
• Examples: runnable browser, code, mobile, Go, and OSWorld demos
• Benchmarks: k6 stress scripts and Agent Cluster Pod startup tests
• Utils: debugging helpers and validated runtime source components such as envd

Repository requirements

Local tools

• uv for Python examples
• python3 for local scripts
• go for Go examples
• git
• Docker is useful for some workflows, but not required for every example

Python versions

• Most Python examples in examples/ require Python >= 3.12
• examples/osworld-ags uses Python 3.12.12
• uv manages the required interpreter for each example.

agr CLI

The ags reference Skill example uses the agr CLI:

# One-line install (macOS / Linux)
curl -fsSL https://github.com/TencentCloudAgentRuntime/ags-cli/releases/latest/download/install.sh | sh

# Or via go install
go install github.com/TencentCloudAgentRuntime/ags-cli/cmd/agr@latest

agr version -o json

For first-time credential setup, follow the official AGR CLI configuration guide, then run agr status and agr doctor before starting an example.

Common environment variables

AGS / E2B-compatible runtime

export E2B_API_KEY="your_ags_api_key"
export E2B_DOMAIN="ap-guangzhou.tencentags.com"

Tencent Cloud control-plane examples

Some Go examples use Tencent Cloud API credentials:

export TENCENTCLOUD_SECRET_ID="your_secret_id"
export TENCENTCLOUD_SECRET_KEY="your_secret_key"
export TENCENTCLOUD_REGION="ap-guangzhou"

Quick start

1. Browse available examples

make examples-list

2. Run a specific example

Most examples provide a local make run target:

make example-setup EXAMPLE=mini-rl
make example-run EXAMPLE=mini-rl

You can also enter an example directory directly and run its local make setup / make run targets.

Example overview