Merge branch 'main' into feat/multimedia

Author: zakahan

.markdownlint-cli2.jsonc

@@ -11,6 +11,7 @@
     "01-tutorials/workshop/README.md",
     "01-tutorials/README.md",
     "02-use-cases/beginner/README.md",
+    "02-use-cases/customer_support/README.md",
     "**/.venv/**"
   ],
   "config": {
@@ -21,4 +22,4 @@
     // allow multiple headers with the same content
     "MD024": false
   }
-}
+}

02-use-cases/ai_coding/README.md

@@ -72,7 +72,7 @@ ai_coding/
 1. 登录 [火山引擎控制台](https://console.volcengine.com)
 2. 进入"访问控制" → "用户" -> 新建用户 或 搜索已有用户名 -> 点击用户名进入"用户详情" -> 进入"密钥" -> 新建密钥 或 复制已有的 AK/SK
    - 如下图所示
-   ![Volcengine AK/SK Management](../img/volcengine_aksk.jpg)
+   ![Volcengine AK/SK Management](../../assets/images/volcengine_aksk.jpg)
 3. 为用户配置 AgentKit运行所依赖服务的访问权限:
    - 在"用户详情"页面 -> 进入"权限" -> 点击"添加权限"，将以下策略授权给用户
    - `AgentKitFullAccess`（AgentKit 全量权限）
@@ -81,7 +81,7 @@ ai_coding/
    - 登陆[火山方舟控制台](https://console.volcengine.com/ark/region:ark+cn-beijing/overview?briefPage=0&briefType=introduce&type=new)
    - 进入"API Key管理" -> 创建 或 复制已有的 API Key，后续`MODEL_AGENT_API_KEY`环境变量需要配置为该值
    - 如下图所示
-   ![Ark API Key Management](../img/ark_api_key_management.jpg)
+   ![Ark API Key Management](../../assets/images/ark_api_key_management.jpg)
 5. 开通模型预置推理接入点
    - 登陆[火山方舟控制台](https://console.volcengine.com/ark/region:ark+cn-beijing/overview?briefPage=0&briefType=introduce&type=new)
    - 进入"开通管理" -> "语言模型" -> 找到相应模型 -> 点击"开通服务"
@@ -90,7 +90,7 @@ ai_coding/
         - `deepseek-v3-1-terminus`
         - `doubao-seed-code-preview-251028`
    - 如下图所示
-   ![Ark Model Service Management](../img/ark_model_service_management.jpg)
+   ![Ark Model Service Management](../../assets/images/ark_model_service_management.jpg)
 
 #### AgentKit 工具 ID
 
@@ -100,7 +100,7 @@ ai_coding/
    - 工具名称: `ai-coding-agent`
    - 描述: AI 编程助手工具
 4. 复制生成的工具 ID 用于配置（后续`AGENTKIT_TOOL_ID`环境变量需要配置为该值）, 如下图所示
-   ![AgentKit Sandbox Tool](../img/agentkit_sandbox_tool.jpg)
+   ![AgentKit Sandbox Tool](../../assets/images/agentkit_sandbox_tool.jpg)
 
 ### 安装依赖
 

02-use-cases/ai_coding/requirements.txt

@@ -1,4 +1,4 @@
 veadk-python==0.2.27
 agentkit-sdk-python==0.1.15
 tos>=2.8.7
-google-adk==1.18.0
+google-adk==1.18.0

02-use-cases/beginner/README.md

@@ -146,20 +146,6 @@ agentkit launch
 agentkit invoke 'your test prompt'
 ```
 
-#### 3. 部署到火山引擎 veFaaS
-
-```bash
-cd <案例目录>
-
-# 配置环境变量
-export VEFAAS_ENABLE_KEY_AUTH=false  # 仅测试用
-export VOLCENGINE_ACCESS_KEY=<Your Access Key>
-export VOLCENGINE_SECRET_KEY=<Your Secret Key>
-
-# 部署到 veFaaS
-veadk deploy --vefaas-app-name=<your-app-name> --use-adk-web
-```
-
 ## 📖 学习路径
 
 ### 路径一：基础入门（推荐新手）
@@ -366,22 +352,14 @@ Agent-to-Agent 协议，展示：
 
 ### Q4: 如何部署到生产环境？
 
-**A**: 生产环境部署建议使用 AgentKit 平台或 veFaaS：
-
-1. **AgentKit 平台部署**（推荐）：
+**A**: 生产环境部署建议使用 AgentKit 平台：
 
 ```bash
 agentkit config
 agentkit launch
 ```
 
-1. **veFaaS 部署**（需要更多配置）：
-
-   ```bash
-   veadk deploy --vefaas-app-name=<name> --use-adk-web \
-     --veapig-instance-name=<instance> \
-     --iam-role "trn:iam::<account>:role/<role>"
-   ```
+**注意**：生产环境必须启用密钥认证并配置 IAM 角色。
 
 **注意**：生产环境必须启用密钥认证并配置 IAM 角色。
 

02-use-cases/beginner/a2a_simple/README.md

@@ -180,13 +180,7 @@ brew install uv
 cd 02-use-cases/beginner/a2a_simple
 ```
 
-您可以通过 `pip` 工具来安装本项目依赖：
-
-```bash
-pip install -r requirements.txt
-```
-
-或者使用 `uv` 工具来安装本项目依赖：
+使用 `uv` 工具来安装本项目依赖：
 
 ```bash
 # 如果没有 `uv` 虚拟环境，可以使用命令先创建一个虚拟环境
@@ -195,9 +189,6 @@ uv venv --python 3.12
 # 使用 `pyproject.toml` 管理依赖
 uv sync
 
-# 使用 `requirements.txt` 管理依赖
-uv pip install -r requirements.txt
-
 # 激活虚拟环境
 source .venv/bin/activate
 ```

02-use-cases/beginner/callback/README.md

@@ -135,13 +135,7 @@ brew install uv
 cd 02-use-cases/beginner/callback
 ```
 
-您可以通过 `pip` 工具来安装本项目依赖：
-
-```bash
-pip install -r requirements.txt
-```
-
-或者使用 `uv` 工具来安装本项目依赖：
+使用 `uv` 工具来安装本项目依赖：
 
 ```bash
 # 如果没有 `uv` 虚拟环境，可以使用命令先创建一个虚拟环境
@@ -150,9 +144,6 @@ uv venv --python 3.12
 # 使用 `pyproject.toml` 管理依赖
 uv sync
 
-# 使用 `requirements.txt` 管理依赖
-uv pip install -r requirements.txt
-
 # 激活虚拟环境
 source .venv/bin/activate
 ```

02-use-cases/beginner/episode_generation/README.md

@@ -139,13 +139,7 @@ brew install uv
 cd 02-use-cases/beginner/episode_generation
 ```
 
-您可以通过 `pip` 工具来安装本项目依赖：
-
-```bash
-pip install -r requirements.txt
-```
-
-或者使用 `uv` 工具来安装本项目依赖：
+使用 `uv` 工具来安装本项目依赖：
 
 ```bash
 # 如果没有 `uv` 虚拟环境，可以使用命令先创建一个虚拟环境
@@ -154,9 +148,6 @@ uv venv --python 3.12
 # 使用 `pyproject.toml` 管理依赖
 uv sync
 
-# 使用 `requirements.txt` 管理依赖
-uv pip install -r requirements.txt
-
 # 激活虚拟环境
 source .venv/bin/activate
 ```

02-use-cases/beginner/hello_world/README.md

@@ -105,13 +105,7 @@ brew install uv
 cd 02-use-cases/beginner/hello_world
 ```
 
-您可以通过 `pip` 工具来安装本项目依赖：
-
-```bash
-pip install -r requirements.txt
-```
-
-或者使用 `uv` 工具来安装本项目依赖：
+使用 `uv` 工具来安装本项目依赖：
 
 ```bash
 # 如果没有 `uv` 虚拟环境，可以使用命令先创建一个虚拟环境
@@ -120,9 +114,6 @@ uv venv --python 3.12
 # 使用 `pyproject.toml` 管理依赖
 uv sync
 
-# 使用 `requirements.txt` 管理依赖
-uv pip install -r requirements.txt
-
 # 激活虚拟环境
 source .venv/bin/activate
 ```

02-use-cases/beginner/hello_world/requirements.txt

@@ -1,5 +1,6 @@
+veadk-python[extensions]==0.2.29
 veadk-python==0.2.29
 agentkit-sdk-python==0.1.15
 google-adk==1.18.0
 urllib3<2.0.0
-volcengine-python-sdk>=4.0.31
+volcengine-python-sdk>=4.0.33

02-use-cases/beginner/mcp_simple/README.md

@@ -118,13 +118,7 @@ brew install uv
 cd 02-use-cases/beginner/mcp_simple
 ```
 
-您可以通过 `pip` 工具来安装本项目依赖：
-
-```bash
-pip install -r requirements.txt
-```
-
-或者使用 `uv` 工具来安装本项目依赖：
+使用 `uv` 工具来安装本项目依赖：
 
 ```bash
 # 如果没有 `uv` 虚拟环境，可以使用命令先创建一个虚拟环境
@@ -133,9 +127,6 @@ uv venv --python 3.12
 # 使用 `pyproject.toml` 管理依赖
 uv sync
 
-# 使用 `requirements.txt` 管理依赖
-uv pip install -r requirements.txt
-
 # 激活虚拟环境
 source .venv/bin/activate
 ```