diff --git a/.gitignore b/.gitignore
index 9265019..019358a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -18,3 +18,8 @@ out/
 
 # --- 系统 ---
 .DS_Store
+
+# agents
+agents.state.json
+.openagentpack/versions/
+.env
diff --git a/agents.yaml b/agents.yaml
new file mode 100644
index 0000000..8fa6370
--- /dev/null
+++ b/agents.yaml
@@ -0,0 +1,27 @@
+version: "1"
+
+providers:
+  bailian:
+    # bl auth login --api-key <key> sets DASHSCOPE_API_KEY; --base-url <url> sets BAILIAN_BASE_URL
+    api_key: ${DASHSCOPE_API_KEY}
+    base_url: ${BAILIAN_BASE_URL}
+
+defaults:
+  provider: bailian
+
+environments:
+  dev:
+    config:
+      type: cloud
+      networking:
+        type: unrestricted
+
+agents:
+  assistant:
+    description: "General-purpose assistant"
+    model: qwen3.8-max
+    instructions: |
+      You are a helpful assistant.
+    environment: dev
+    tools:
+      builtin: [bash, read, glob, grep]