diff --git a/.env b/.env index e4c8b3e..c1016f6 100644 --- a/.env +++ b/.env @@ -87,5 +87,9 @@ COZE_PROJECT_ENV=PROD # 启用调试模式 DEBUG=false -# 关闭 CozeLoop 追踪 -DISABLE_LOOP_TRACE=true \ No newline at end of file +# 禁用 cozeloop 链路追踪（避免额外的 API 调用） +DISABLE_LOOP_TRACE=true +LOOP_ENABLED=false +COZE_LOOP_ENABLED=false +COZE_TRACING_ENABLED=false +OPT_ENABLE_LONG_REPORT=false \ No newline at end of file diff --git a/.env.example b/.env.example index f8973bc..fd4e5fd 100644 --- a/.env.example +++ b/.env.example @@ -19,6 +19,12 @@ COZE_INTEGRATION_API_KEY=Bearer YOUR_INTEGRATION_API_KEY_HERE # 工作空间 ID（必需） COZE_WORKSPACE_ID=YOUR_WORKSPACE_ID_HERE +# ==================== 追踪配置 ==================== + +# 禁用 cozeloop 链路追踪（避免额外的 API 调用） +COZE_TRACING_ENABLED=false +OPT_ENABLE_LONG_REPORT=false + # ==================== Coze API 基础 URL ==================== # Coze 集成基础 URL diff --git a/Dockerfile b/Dockerfile index 7ccbe90..824dc9f 100644 --- a/Dockerfile +++ b/Dockerfile @@ -48,7 +48,14 @@ RUN pip install --no-cache-dir -r requirements.txt ENV COZE_INTEGRATION_BASE_URL=https://api.coze.cn \ COZE_INTEGRATION_MODEL_BASE_URL=https://api.coze.cn \ - LLM_BASE_URL=https://api.coze.cn + LLM_BASE_URL=https://api.coze.cn \ + COZE_TRACING_ENABLED=false \ + OPT_ENABLE_LONG_REPORT=false \ + DISABLE_LOOP_TRACE=true \ + LOOP_ENABLED=false \ + COZE_LOOP_ENABLED=false \ + COZE_TRACING_ENABLED=false \ + OPT_ENABLE_LONG_REPORT=false # 复制项目文件 COPY . . diff --git a/TRACING.md b/TRACING.md new file mode 100644 index 0000000..7add255 --- /dev/null +++ b/TRACING.md @@ -0,0 +1,95 @@ +# 禁用链路追踪功能 + +## 问题说明 + +默认情况下，`cozeloop` 框架会自动发送链路追踪数据到 `https://api.coze.cn/v1/loop/traces/ingest`，用于监控和调试。 + +如果你不需要这个功能（或者因为认证问题导致失败），可以通过设置环境变量来禁用它。 + +## 错误日志示例 + +``` +HTTP Request: POST https://api.coze.cn/v1/loop/traces/ingest "HTTP/1.1 401 Unauthorized" +Call remote service failed. Path: https://api.coze.cn/v1/loop/traces/ingest, remote service error, authentication is invalid +``` + +## 解决方案 + +### 方法一：在 Dockerfile 中禁用（推荐） + +在 `assets/Dockerfile` 中添加以下环境变量： + +```dockerfile +ENV COZE_API_KEY="Bearer YOUR_KEY" \ + LLM_API_KEY="Bearer YOUR_KEY" \ + COZE_WORKLOAD_IDENTITY_API_KEY="Bearer YOUR_KEY" \ + COZE_INTEGRATION_API_KEY="Bearer YOUR_KEY" \ + COZE_WORKSPACE_ID=YOUR_WORKSPACE_ID \ + # 禁用 cozeloop 链路追踪 + COZE_TRACING_ENABLED=false \ + OPT_ENABLE_LONG_REPORT=false +``` + +### 方法二：使用 docker-compose + +在 `docker-compose.yml` 中添加： + +```yaml +services: + math-correction: + environment: + - COZE_API_KEY=Bearer YOUR_KEY + - LLM_API_KEY=Bearer YOUR_KEY + - COZE_WORKLOAD_IDENTITY_API_KEY=Bearer YOUR_KEY + - COZE_INTEGRATION_API_KEY=Bearer YOUR_KEY + - COZE_WORKSPACE_ID=YOUR_WORKSPACE_ID + # 禁用链路追踪 + - COZE_TRACING_ENABLED=false + - OPT_ENABLE_LONG_REPORT=false +``` + +### 方法三：使用 .env 文件 + +在 `.env` 文件中添加： + +```bash +# 禁用链路追踪 +COZE_TRACING_ENABLED=false +OPT_ENABLE_LONG_REPORT=false +``` + +## 环境变量说明 + +| 环境变量 | 默认值 | 说明 | +|---------|--------|------| +| `COZE_TRACING_ENABLED` | `true` | 是否启用链路追踪 | +| `OPT_ENABLE_LONG_REPORT` | `false` | 是否启用长报告（会影响追踪数据量） | + +## 验证 + +禁用后，重新构建并运行容器： + +```bash +# 重新构建 +docker build -f assets/Dockerfile -t math-correction:latest . + +# 运行容器 +docker run -d --name math-correction -p 8000:8000 math-correction:latest + +# 查看日志，确认不再有 loop/traces/ingest 的错误 +docker logs math-correction | grep -i "traces/ingest" +``` + +预期结果：没有任何输出（表示追踪已禁用） + +## 注意事项 + +- ✅ 禁用追踪不会影响核心功能 +- ✅ 可以减少网络开销 +- ✅ 可以避免 401 认证错误 +- ⚠️ 禁用后将无法在 Coze 平台查看链路追踪信息 + +## 相关库 + +- `cozeloop==0.1.25`：提供链路追踪功能 +- `coze-coding-dev-sdk`：自动集成链路追踪 diff --git a/assets/Dockerfile b/assets/Dockerfile index a6c64f0..ca4ed03 100644 --- a/assets/Dockerfile +++ b/assets/Dockerfile @@ -46,7 +46,10 @@ ENV PIP_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/ \ LLM_MODEL_NAME=doubao-seed-1-8-251228 \ COZE_API_KEY="Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6ImRmZmU2NmYxLTg0MDMtNDc5Ni05ZmRhLTViMmJjZWExM2ViOCJ9.eyJpc3MiOiJodHRwczovL2FwaS5jb3plLmNuIiwiYXVkIjpbIkZVS1kzOVR0dFlSdmlNaldGVmNjaUg0NWFPblp2TGxpIl0sImV4cCI6ODIxMDI2Njg3Njc5OSwiaWF0IjoxNzc0NjkyOTc0LCJzdWIiOiJzcGlmZmU6Ly9hcGkuY296ZS5jbi93b3JrbG9hZF9pZGVudGl0eS9pZDo3NjIyMjM4NzUyNjQyOTU3MzQ3Iiwic3JjIjoiaW5ib3VuZF9hdXRoX2FjY2Vzc190b2tlbl9pZDo3NjIyMjQ4Mjg1OTMxMDQ0ODkxIn0.XSJaTryHWYzQaHxd9g9rOX2Y3YRY8kGAlvSFH9UkWR9EFDfZESG1GFEdWDelYeoHBqtdiQhxTcYdGPA87_PweMfh0wJXTdCEzTDHAOlUUupJEKTpkUAMEoEZpYBrwKQxjzGglkMHUoXqM5I0tQsARaqZ-j-JOW9Y6fHot56squm8GSt7WZkVSj6ZC2Us4cpO_RIgsN_pBU0CFSlUpOU5AdQQ8LvHzp60-DGaXVU0mFIYKhnXKbTf3PSXpJlH-W78FULh2FcdOTxMIcNkL5nuIHGakoNNDxs-k5Ucp06kFEMcbvec4iB1njbkHrsilYeJOFRoqkXJpQujDngZxKecLA" \ COZE_INTEGRATION_API_KEY="Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6ImRmZmU2NmYxLTg0MDMtNDc5Ni05ZmRhLTViMmJjZWExM2ViOCJ9.eyJpc3MiOiJodHRwczovL2FwaS5jb3plLmNuIiwiYXVkIjpbIkZVS1kzOVR0dFlSdmlNaldGVmNjaUg0NWFPblp2TGxpIl0sImV4cCI6ODIxMDI2Njg3Njc5OSwiaWF0IjoxNzc0NjkyOTc0LCJzdWIiOiJzcGlmZmU6Ly9hcGkuY296ZS5jbi93b3JrbG9hZF9pZGVudGl0eS9pZDo3NjIyMjM4NzUyNjQyOTU3MzQ3Iiwic3JjIjoiaW5ib3VuZF9hdXRoX2FjY2Vzc190b2tlbl9pZDo3NjIyMjQ4Mjg1OTMxMDQ0ODkxIn0.XSJaTryHWYzQaHxd9g9rOX2Y3YRY8kGAlvSFH9UkWR9EFDfZESG1GFEdWDelYeoHBqtdiQhxTcYdGPA87_PweMfh0wJXTdCEzTDHAOlUUupJEKTpkUAMEoEZpYBrwKQxjzGglkMHUoXqM5I0tQsARaqZ-j-JOW9Y6fHot56squm8GSt7WZkVSj6ZC2Us4cpO_RIgsN_pBU0CFSlUpOU5AdQQ8LvHzp60-DGaXVU0mFIYKhnXKbTf3PSXpJlH-W78FULh2FcdOTxMIcNkL5nuIHGakoNNDxs-k5Ucp06kFEMcbvec4iB1njbkHrsilYeJOFRoqkXJpQujDngZxKecLA" \ - COZE_WORKSPACE_ID=7622238752642957347 + COZE_WORKSPACE_ID=7622238752642957347 \ + # 禁用 cozeloop 链路追踪 + COZE_TRACING_ENABLED=false \ + OPT_ENABLE_LONG_REPORT=false # 升级 pip 和构建工具 RUN pip install --no-cache-dir --upgrade pip setuptools wheel meson ninja