Примеры, учебные пособия и утилиты для создания на Tencent Cloud Agent Sandbox / AGS.

Что содержит репо

** Навыки **: справка Агент Навык пример для AGS; см. skills/README.md Tutorials: SDK и ноутбуки на основе бортинга Примеры: управляемый браузер, код, мобильный, Go и демоверсия OSWorld Бенчмарки: скрипты напряжения k6 и тесты запуска Agent Cluster Pod Утилиты: отладочные помощники и проверенные компоненты источника среды выполнения, такие как envd

##Резервные требования

Местные инструменты

uv для примеров Python

• [[Т2]] для местных скриптов
• [[Т3]] для примеров Go
• [[Т4]] Докер полезен для некоторых рабочих процессов, но не требуется для каждого примера.

Python версии

Большинство примеров Python в examples/ требуют Python >= 3.12

• examples/osworld-ags использует Python 3.12.12 [[Т7]] управляет требуемым переводчиком для каждого примера.

####КЛИ

ags Ссылочный пример Навыка использует agr CLI:

Для первой настройки учетных данных, следуйте официальное руководство по конфигурации AGR CLI, [10] и [11] перед началом [[11]].

##Общие переменные среды

AGS / E2B-совместимая среда выполнения

Примеры плоскости управления Tencent Cloud

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