docs: finalize documentation cleanup
- Update OPENVIKING_INTEGRATION with latest status - Remove outdated plan files (now archived in docs/archive/) - Clean up redundant documentation Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -429,6 +429,84 @@ cd desktop
|
||||
pnpm vitest run tests/desktop/memory*.test.ts
|
||||
```
|
||||
|
||||
## 火山引擎 (Volcengine) 配置
|
||||
|
||||
### 激活 Embedding 模型
|
||||
|
||||
**重要**:火山引擎的 Embedding 模型需要在控制台单独激活。
|
||||
|
||||
1. **登录火山引擎控制台**:
|
||||
https://console.volcengine.com/ark
|
||||
|
||||
2. **激活 Embedding 模型**:
|
||||
- 进入「模型推理」→「模型服务」
|
||||
- 搜索并激活以下模型之一:
|
||||
- `Doubao-Embedding` (推荐,1024 维)
|
||||
- `Doubao-Embedding-Large` (2048 维)
|
||||
|
||||
3. **获取 Endpoint ID**:
|
||||
- 激活后,复制模型的 **Endpoint ID**
|
||||
- 格式类似:`ep-xxxxxxxxxxxx`
|
||||
|
||||
4. **更新配置文件**:
|
||||
|
||||
使用 Endpoint ID(推荐):
|
||||
```json
|
||||
{
|
||||
"embedding": {
|
||||
"dense": {
|
||||
"api_base": "https://ark.cn-beijing.volces.com/api/v3",
|
||||
"api_key": "your-api-key",
|
||||
"provider": "volcengine",
|
||||
"model": "ep-xxxxxxxxxxxx",
|
||||
"dimension": 1024
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
或使用模型名称(需要在控制台激活):
|
||||
```json
|
||||
{
|
||||
"embedding": {
|
||||
"dense": {
|
||||
"api_base": "https://ark.cn-beijing.volces.com/api/v3",
|
||||
"api_key": "your-api-key",
|
||||
"provider": "volcengine",
|
||||
"model": "doubao-embedding",
|
||||
"dimension": 1024
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 常见错误
|
||||
|
||||
| 错误 | 原因 | 解决方案 |
|
||||
|------|------|----------|
|
||||
| `ModelNotOpen` | 模型未激活 | 在控制台激活对应的 Embedding 模型 |
|
||||
| `InvalidEndpointOrModel.NotFound` | Endpoint ID 不存在 | 检查 Endpoint ID 是否正确 |
|
||||
| `404 Not Found` | API 路径错误 | 确认 `api_base` 为 `https://ark.cn-beijing.volces.com/api/v3` |
|
||||
|
||||
### 测试 Embedding 配置
|
||||
|
||||
```bash
|
||||
# 启动服务器后,测试向量搜索
|
||||
curl -X POST http://127.0.0.1:1933/api/v1/search/search \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"query": "test query", "limit": 5}'
|
||||
```
|
||||
|
||||
成功响应:
|
||||
```json
|
||||
{"status":"ok","result":[],"error":null}
|
||||
```
|
||||
|
||||
失败响应(需要激活模型):
|
||||
```json
|
||||
{"status":"error","error":{"message":"Volcengine embedding failed: ModelNotOpen..."}}
|
||||
```
|
||||
|
||||
## 故障排除
|
||||
|
||||
### Q: OpenViking CLI not found
|
||||
|
||||
Reference in New Issue
Block a user