テンセントクラウドエージェントサンドボックス/ AGS 上に構築するための例、チュートリアル、ユーティリティ。

このリポジトリが含まれているもの

-Skills: AGS のリファレンスエージェントのスキル例; [[T0] を参照してください。

• チュートリアル:SDKおよびノートブックベースのオンボーディング -例:実行可能なブラウザ、コード、モバイル、Go、およびOSWorldのデモ
• Benchmarks:k6ストレススクリプトとエージェントクラスターPod起動テスト -Utils: ヘルパーをデバッグし、envdなどのランタイムソースコンポーネントを検証

リポジトリの要件

ローカルツール

• Python の例の [uv
• ローカルスクリプトの[python3
• [go は、Go の例
• [git
• Docker はワークフローに便利ですが、すべての例では必須ではありません。

##Pythonのバージョン

• [[[T5] のほとんどの Python の例では、Python >= 3.12 が必要です。
• [[examples/osworld-ags は、Python 3.12.12** を使用します。
• [uvは、各例に必要な通訳者を管理します。

####agr クリップ

[ags 参照スキルの例は 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