74 lines
1.7 KiB
Markdown
74 lines
1.7 KiB
Markdown
|
# 第21章 · 外网调用与 API 网关
|
|||
|
|
|
|||
|
|
> 返回 [总目录](../README.md)
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 21.1 外网化方案
|
|||
|
|
|
|||
|
|
让卡若AI 可从外网访问，任意终端用「一句话/一个命令」调用卡若AI。
|
|||
|
|
|
|||
|
|
### 架构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
外部（其他 AI / 用户）
|
|||
|
|
│ HTTP POST /chat
|
|||
|
|
▼
|
|||
|
|
卡若AI 网关（FastAPI）
|
|||
|
|
· 加载 BOOTSTRAP + SKILL_REGISTRY
|
|||
|
|
· 匹配技能 → 读 SKILL.md
|
|||
|
|
· 调用 LLM 生成回复（含复盘）
|
|||
|
|
│
|
|||
|
|
▼ 部署在宝塔服务器
|
|||
|
|
外网域名：https://kr-ai.quwanzhi.com
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 21.2 调用方式
|
|||
|
|
|
|||
|
|
### curl 命令
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
curl -s -X POST "https://kr-ai.quwanzhi.com/v1/chat" \
|
|||
|
|
-H "Content-Type: application/json" \
|
|||
|
|
-d '{"prompt":"你的问题"}' | jq -r '.reply'
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 在 Cursor 中集成
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
当用户说「用卡若AI」时：
|
|||
|
|
POST https://kr-ai.quwanzhi.com/v1/chat
|
|||
|
|
Body: {"prompt": "<用户问题>"}
|
|||
|
|
将 reply 字段展示给用户。
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 部门 key 认证
|
|||
|
|
|
|||
|
|
| 接口 | 说明 |
|
|||
|
|
|:---|:---|
|
|||
|
|
| `POST /v1/chat` | 带 `X-Karuo-Api-Key` 发送对话 |
|
|||
|
|
| `GET /v1/skills` | 查看当前部门允许的技能 |
|
|||
|
|
| `GET /v1/health` | 健康检查（无需 key） |
|
|||
|
|
|
|||
|
|
## 21.3 网关配置
|
|||
|
|
|
|||
|
|
- 网关代码：`运营中枢/scripts/karuo_ai_gateway/`
|
|||
|
|
- 配置文件：`config/gateway.yaml`
|
|||
|
|
- 新增部门：`python tools/generate_dept_key.py --tenant-id xxx`
|
|||
|
|
|
|||
|
|
### 轮询与故障切换
|
|||
|
|
|
|||
|
|
| 网关 | Base URL |
|
|||
|
|
|:---|:---|
|
|||
|
|
| KaruoGateway | `http://localhost:8000` |
|
|||
|
|
| OpenAI | `https://api.openai.com/v1` |
|
|||
|
|
| OpenRouter | `https://openrouter.ai/api/v1` |
|
|||
|
|
| 通义千问 | `https://dashscope.aliyuncs.com/compatible-mode/v1` |
|
|||
|
|
| 智增增 | `https://api.zhizengzeng.com/v1` |
|
|||
|
|
|
|||
|
|
按队列逐个尝试，失败自动切下一个。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
> 下一章：[第22章 · 多线程并行处理](22_多线程并行处理.md)
|