Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 7 additions & 18 deletions apps/coze/.env
Original file line number Diff line number Diff line change
@@ -1,30 +1,19 @@
W9_REPO="cozedev/coze-studio-web"
W9_DIST='community'
W9_VERSION='latest'
W9_POWER_PASSWORD='o91DD8ys!I7p10ZQ'
W9_POWER_PASSWORD='fem!17NVbvU9H1bz'

# Environments which for user settings when create application
# Named expression: W9_xxx_xxx_SET, xxx refer to file fields
W9_HTTP_PORT_SET='9001'

# Model Configuration - Users can configure their AI model provider
W9_MODEL_PROTOCOL_SET='ark'
W9_MODEL_NAME_SET='deepseek-reasoner'
W9_MODEL_ID_SET='deepseek-reasoner'
W9_MODEL_API_KEY_SET='sk-be9b46a22a19470681173e9417676b2d'
W9_MODEL_BASE_URL_SET='https://api.deepseek.com'

#### -- Not allowed to edit below environments when recreate app based on existing data -- ####
W9_ID='coze'

# W9_HTTP_PORT or W9_HTTPS_PORT is need at leaset and used for proxy for web application
W9_HTTP_PORT=80

W9_LOGIN_USER=admin
W9_LOGIN_PASSWORD=$W9_POWER_PASSWORD

# Container name's suffix must use one of the value
W9_DB_EXPOSE="mysql,redis,elasticsearch,minio,etcd,milvus"
W9_DB_EXPOSE="mysql"

# It is used when the application APP needs to set an external URL, which can be IP(or domain), IP:PORT
W9_URL='internet_ip:$W9_HTTP_PORT_SET'
Expand Down Expand Up @@ -88,12 +77,12 @@ ARK_EMBEDDING_DIMS="2048" # (int, required) Ark embedding dimensions
ARK_EMBEDDING_API_TYPE="" # (string, optional) Ark embedding api type, should be "text_api" / "multi_modal_api". Default "text_api".

# Model Configuration for Agent & Workflow
MODEL_PROTOCOL_0="${W9_MODEL_PROTOCOL_SET:-ark}"
MODEL_PROTOCOL_0=""
MODEL_OPENCOZE_ID_0="100001"
MODEL_NAME_0="${W9_MODEL_NAME_SET:-}"
MODEL_ID_0="${W9_MODEL_ID_SET:-}"
MODEL_API_KEY_0="${W9_MODEL_API_KEY_SET:-}"
MODEL_BASE_URL_0="${W9_MODEL_BASE_URL_SET:-}"
MODEL_NAME_0=""
MODEL_ID_0=""
MODEL_API_KEY_0=""
MODEL_BASE_URL_0=""

# Built-in Chat Model for Knowledge Base
BUILTIN_CM_TYPE="ark"
Expand Down
58 changes: 12 additions & 46 deletions apps/coze/Notes.md
Original file line number Diff line number Diff line change
@@ -1,32 +1,6 @@
# Coze Studio

## Configuration Requirements

### Required Configuration

在使用coze之前,你需要提供至少一个AI模型供应商:

1. **适用于代理和工作流**:通过环境变量配置模型设置:
- `W9_MODEL_PROTOCOL_SET`: 模型协议 (如: "ark", "openai", "ollama")
- `W9_MODEL_NAME_SET`: 模型显示名称
- `W9_MODEL_ID_SET`: 用于 API 调用的模型 ID
- `W9_MODEL_API_KEY_SET`: 用于认证的 API 密钥
- `W9_MODEL_BASE_URL_SET`: 模型 API 的基础 URL
(以上配置在安装前会被要求输入,并且代入到以下配置:)
```
MODEL_PROTOCOL_0="${W9_MODEL_PROTOCOL_SET:-ark}"
MODEL_OPENCOZE_ID_0="100001"
MODEL_NAME_0="${W9_MODEL_NAME_SET:-}"
MODEL_ID_0="${W9_MODEL_ID_SET:-}"
MODEL_API_KEY_0="${W9_MODEL_API_KEY_SET:-}"
MODEL_BASE_URL_0="${W9_MODEL_BASE_URL_SET:-}"
```
(你可以通过复制并修改后面的数字以及内容来配置多个模型)


2. **用于知识库(嵌入)**:配置嵌入设置:
- `EMBEDDING_TYPE`: 嵌入提供商类型 (ark/openai/ollama/gemini)
- 特定于提供商的设置 (API key, base URL, model name, dimensions)
官方文档:https://www.coze.cn/open/docs/guides

### 支持的模型提供商

Expand All @@ -43,22 +17,14 @@
### 怎么配置模型?

1. 在应用页面点击编排-马上修改,进入.env文件
2. 修改模型配置相关变量 (W9_MODEL_*)
3. 重建应用

### 故障排查

**服务没有启动:**
- 检查所有必需的环境变量是否已配置
- 验证 Docker 是否分配了足够的资源
- 检查日志: `docker logs coze_{ID}-server`

**知识库无法使用:**
- 确保嵌入配置设置正确
- 验证嵌入式 API 密钥是否有效
- 检查 Milvus 和 Elasticsearch 是否正在运行

**模型无响应:**
- 验证模型 API 密钥和基础 URL
- 检查与模型提供商的网络连接
- 查看服务器日志中的错误信息
2. 修改模型配置相关变量
以deepseek为例:
```
MODEL_PROTOCOL_0="ark"
MODEL_OPENCOZE_ID_0="100001"
MODEL_NAME_0="deepseek" # 模型名称(可自定义)
MODEL_ID_0="deepseek-reasoner" # 供应商给出的模型ID
MODEL_API_KEY_0="sk-xxxxxxxxxxxxxxxxxxxxxxx" # API密钥
MODEL_BASE_URL_0="https://api.deepseek.com" # 模型基础url
```
如果需要配置多个模型,可将上述内容复制一份,修改0为其他数字并修改相应的值
3 changes: 2 additions & 1 deletion apps/coze/docker-compose.yml
Original file line number Diff line number Diff line change
Expand Up @@ -354,8 +354,9 @@ services:
image: cozedev/coze-studio-web:latest
container_name: $W9_ID
restart: unless-stopped
env_file: .env
ports:
- 0.0.0.0:$W9_HTTP_PORT_SET:80
- $W9_HTTP_PORT_SET:80
volumes:
- ./src/nginx/nginx.conf:/etc/nginx/nginx.conf:ro # Main nginx config
- ./src/nginx/conf.d/default.conf:/etc/nginx/conf.d/default.conf:ro # Proxy config
Expand Down