Tencent Cloud Agent Sandbox / AGS에 구축하는 예제, 튜토리얼 및 유틸리티.

이 repo가 포함 된 것

• Skills: AGS에 대한 참조 에이전트 기술 예제; skills/README.md]
• Tutorials: SDK 및 노트북 기반 내장 -Examples: 실행 가능한 브라우저, 코드, 모바일, 이동, OSWorld 데모
• Benchmarks: k6 스트레스 스크립트 및 에이전트 클러스터 포드 시작 테스트
• Utils: 디버깅 돕기 및 envd와 같은 검증된 런타임 소스 구성품

저장소 필요조건

# 현지 도구

• uv Python 예제
• python3 로컬 스크립트에 대한
• go Go 예제
• [T4]]
• Docker는 일부 워크플로우에 유용하지만, 모든 예시에는 필요하지 않습니다.

파이썬 버전

• examples/의 대부분의 파이썬 예제는 Python >= 3.12가 필요합니다.
• examples/osworld-ags **Python 3.12.12 **
• uv는 각 예제에 필요한 해석기를 관리합니다.

agr 클립

ags 참조 스킬 예제는 agr CLI를 사용합니다.

처음으로 credential 설정을 위해, 따르십시오 공식 AGR CLI 구성 가이드, 그런 다음 agr status]과 agr doctor]을 실행합니다.

일반적인 환경 변수

# 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