refactor: 移除 crewai agent 架构相关代码并更新 LLM 配置
This commit is contained in:
@@ -786,72 +786,6 @@
|
||||
|
||||
---
|
||||
|
||||
## Agent
|
||||
|
||||
### POST /agent/runs
|
||||
|
||||
创建 Agent 运行(需要认证,SSE 响应)。
|
||||
|
||||
**Request (RunAgentInput):**
|
||||
```json
|
||||
{
|
||||
"threadId": "string",
|
||||
"runId": "string",
|
||||
"parentRunId": "string?",
|
||||
"state": {},
|
||||
"messages": [],
|
||||
"tools": [],
|
||||
"context": [],
|
||||
"forwardedProps": {},
|
||||
"resume": null
|
||||
}
|
||||
```
|
||||
|
||||
**Response:** 200 OK (`text/event-stream`)
|
||||
|
||||
**Errors:**
|
||||
- 401: 未认证
|
||||
- 422: 请求参数无效
|
||||
|
||||
### POST /agent/runs/{run_id}/resume
|
||||
|
||||
恢复被中断运行(需要认证,SSE 响应)。
|
||||
|
||||
**Request (RunAgentInput):**
|
||||
```json
|
||||
{
|
||||
"threadId": "string",
|
||||
"runId": "string",
|
||||
"state": {},
|
||||
"messages": [],
|
||||
"tools": [],
|
||||
"context": [],
|
||||
"forwardedProps": {},
|
||||
"resume": {
|
||||
"interruptId": "string",
|
||||
"payload": {}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**State Snapshot Contract:**
|
||||
- `state_snapshot` 仅支持 `version = 2`
|
||||
- 顶层必须包含 `run_context` 与 `pending_tool_call`
|
||||
- 旧格式或缺失字段会被拒绝
|
||||
|
||||
**Resume Semantics:**
|
||||
- 同一 `interrupt_id` 并发恢复仅允许一个请求成功
|
||||
- `expires_at` 超时后会标记为 `EXPIRED`,恢复请求不再生效
|
||||
|
||||
**Errors:**
|
||||
- 401: 未认证
|
||||
- 404: 会话不存在
|
||||
- 409: `run_id` 或 `interrupt_id` 冲突,或状态已被消费
|
||||
- 410: 挂起调用已过期
|
||||
- 422: `state_snapshot` 非法或版本不匹配
|
||||
|
||||
---
|
||||
|
||||
## Infra
|
||||
|
||||
### GET /infra/health
|
||||
|
||||
@@ -159,22 +159,6 @@ curl -sS "${WEB_BASE_URL}/api/v1/profile/me" \
|
||||
|
||||
通过标准:接口返回符合预期的 2xx 或受控业务错误,无 5xx。
|
||||
|
||||
### L3 可选(Agent Chat 回归)
|
||||
|
||||
```bash
|
||||
PYTHONPATH=backend/src uv run pytest backend/tests/unit -k agent_chat -q
|
||||
PYTHONPATH=backend/src uv run pytest backend/tests/integration -k agent_chat -q
|
||||
PYTHONPATH=backend/src uv run pytest backend/tests/e2e/test_agent_chat_flow.py backend/tests/e2e/test_agent_chat_recent_session_home.py -q
|
||||
|
||||
curl -sS -X POST "${WEB_BASE_URL}/api/v1/agent" \
|
||||
-H 'Content-Type: application/json' \
|
||||
-d '{"message":"hello"}'
|
||||
```
|
||||
|
||||
通过标准:测试通过,`/api/v1/agent` 返回有效 `session_id` 与事件序列。
|
||||
|
||||
---
|
||||
|
||||
## Incident Playbook
|
||||
|
||||
### 1) 迁移未生效(常见于旧镜像)
|
||||
@@ -195,13 +179,7 @@ curl -sS -X POST "${WEB_BASE_URL}/api/v1/agent" \
|
||||
- 定位:核对 `.env` 中 Supabase JWT 配置与签发方设置。
|
||||
- 修复:修正配置后重启 web 进程并执行 L1/L2 验证。
|
||||
|
||||
### 4) Agent Chat 启动后异常
|
||||
|
||||
- 症状:`/api/v1/agent` 返回 5xx 或事件不完整。
|
||||
- 定位:先跑 L3 测试,再看 `logs/errors/web.error.log`。
|
||||
- 修复:先恢复到可用版本,再排查迁移、配置与依赖差异。
|
||||
|
||||
### 5) Auth 邮件模板未生效 / 注册返回超时但邮件已发送
|
||||
### 4) Auth 邮件模板未生效 / 注册返回超时但邮件已发送
|
||||
|
||||
- 症状:
|
||||
- 收到默认英文模板(非 `infra/mail-templates`)。
|
||||
@@ -261,7 +239,7 @@ docker compose --env-file .env -f infra/docker/docker-compose.yml up -d --force-
|
||||
| 2026-02-25 | 补充迁移防遗漏规则:容器迁移命令统一追加 --build;开发调试优先使用本地 CLI 一次性迁移脚本 |
|
||||
| 2026-02-25 | Auth 注册切换为 OTP 三段式:signup/start、signup/verify、signup/resend;邮件模板改为纯验证码展示 |
|
||||
| 2026-02-25 | 清理未使用配置类:删除 WebSettings/GunicornSettings/WorkerSettings/WorkerGroupSettings(脚本仍使用环境变量启动服务) |
|
||||
| 2026-02-25 | 新增 Agent Chat 验证章节:bootstrap gate、分层测试命令与 run 接口 smoke 示例 |
|
||||
| 2026-03-04 | Agent 运行时进入硬切重构:移除旧 Agent Chat 验证章节,待新方案落地后补充 |
|
||||
| 2026-02-25 | 简化启动方式:dev-app-up -> app-up,分离 bootstrap 与服务启动 |
|
||||
| 2026-02-25 | 重构为运维分层手册:Bootstrap Gate、分层验证、故障与回滚流程 |
|
||||
| 2026-02-25 | 新增配置漂移故障条目:修复 Auth 邮件模板失效与 signup 超时场景 |
|
||||
|
||||
Reference in New Issue
Block a user