修正 live stream 工具验收的运行口径并补进运维文档
Project CI / Frontend tests (pull_request) Failing after 1m2s
Project CI / Backend tests (pull_request) Failing after 1m12s
Project CI / Repository checks (pull_request) Failing after 2m24s
Project CI / Native shell tests (pull_request) Failing after 7m56s

仓库根目录没有 Cargo.toml,测试注释里的命令补上 --manifest-path server-rs/Cargo.toml
运维文档补充四个 PLATFORM_LLM_LIVE_* 变量、bash 与 PowerShell 两种执行方式,以及逐协议切换才算覆盖完整的口径
明确凭据只从进程环境变量读取,不读 .env.secrets.local,真实 API Key 不得提交进仓库

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-27 03:24:47 +00:00
parent 5af8d59404
commit 5eee11ac0b
2 changed files with 19 additions and 1 deletions
@@ -655,6 +655,20 @@ OpenTelemetry 现阶段默认开启 OTLP traces / metrics / logs,但本地日
验收证据分为两类:`cargo test -p platform-llm` 的确定性用例验证 checked-in SSE fixture 的 parser 行为;默认忽略的 `tests/live_stream_tool_calls.rs` 只对真实端点做归一后的工具调用 smoke,检查最终工具名、id、完整参数 JSON 和文本增量字符数。该 smoke 不录制或逐事件比较原始 SSE,fixture 即使来源于真实抓包也不能据此宣称转录无偏差。
真实端点 smoke 由四个环境变量驱动,缺任一个直接失败:`PLATFORM_LLM_LIVE_BASE_URL`、`PLATFORM_LLM_LIVE_API_KEY`、`PLATFORM_LLM_LIVE_MODEL`、`PLATFORM_LLM_LIVE_API_KIND`(取值 `anthropic` / `openai_chat` / `openai_responses`,其它值按 `openai_responses` 处理)。仓库根目录没有 `Cargo.toml`,必须显式指定 workspace manifest:
```bash
PLATFORM_LLM_LIVE_BASE_URL=https://api.example.com/anthropic \
PLATFORM_LLM_LIVE_API_KEY=<从密钥管理处取,勿写入仓库> \
PLATFORM_LLM_LIVE_MODEL=<模型名> \
PLATFORM_LLM_LIVE_API_KIND=anthropic \
cargo test -p platform-llm --manifest-path server-rs/Cargo.toml --test live_stream_tool_calls -- --ignored --nocapture
```
PowerShell 下先用 `$env:PLATFORM_LLM_LIVE_API_KEY = '...'` 赋值再执行同一条 `cargo test`。切换 `PLATFORM_LLM_LIVE_API_KIND` 逐个跑三种协议,才算覆盖完整;`--nocapture` 会打印解析出的工具名、id 和参数,便于核对。
该用例只从进程环境变量读取凭据,不读 `.env.secrets.local`,也不会写入任何文件。真实 API Key 一律不得提交进仓库,也不要写进 `docs/`、脚本默认值或测试 fixture;临时密钥用完应在上游及时吊销。
创意 Agent `gpt-5` 文本链路已从 APIMart 切到 VectorEngine:`api-server` 读取 `VECTOR_ENGINE_BASE_URL` / `VECTOR_ENGINE_API_KEY` 构造 OpenAI-compatible LLM client,并自动补齐 `/v1` 前缀用于 Responses 协议。排查或切换密钥后,可在本地运行:
创意 Agent `gpt-5.4-mini` 文本链路已从 APIMart 切到 VectorEngine:`api-server` 读取 `VECTOR_ENGINE_BASE_URL` / `VECTOR_ENGINE_API_KEY` 构造 OpenAI-compatible LLM client,并自动补齐 `/v1` 前缀后请求 `/chat/completions`。通用 `/api/llm/chat/completions` 代理使用 `GENARRATIVE_LLM_PROVIDER=openai-compatible`、`GENARRATIVE_LLM_BASE_URL=https://api.vectorengine.cn/v1`、`GENARRATIVE_LLM_MODEL=gpt-5.4-mini`,未单独配置 `GENARRATIVE_LLM_API_KEY` 时可复用 `VECTOR_ENGINE_API_KEY`。排查或切换密钥后,可在本地运行: