docs: document AIA_TOOL_FUNCTION_STRICT and add env example

Add ENVIRONMENT_VARIABLES entry, changelog note, and _local/system.env.example placeholder for OpenAI-style tools function.strict toggling.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
oliver 2026-05-13 15:09:17 +08:00
parent 1d7282a0a2
commit 48190afbc1
3 changed files with 10 additions and 0 deletions

View file

@ -271,6 +271,8 @@ OCLAW_OPS_AI_SHARED_TOKEN=
AIA_OPENAI_TOOLS_MAX_JSON_CHARS=
AIA_SHRINK_OPENAI_TOOLS=
AIA_SHRINK_OPENAI_TOOLS_MAX_JSON=
# OpenAI 兼容 /chat/completions:默认在每个 tools[].function 写入 strict: true;网关因未知字段 400 时设为 0。
AIA_TOOL_FUNCTION_STRICT=
AIA_REPLAY_POLICY_ENABLED=
AIA_REPLAY_REPAIR_TOOL_PAIRING=

View file

@ -146,6 +146,13 @@
- 作用:可选的 host 子串黑名单,强制走 prompt-tool 模式
- 生效:`oclaw/platform/llm/chat_models.py`
- `AIA_TOOL_FUNCTION_STRICT`
- 默认:未设置即 **开启**(在发往 OpenAI 兼容 **`/chat/completions`** 的请求里,为每个 **`tools[].function`** 写入 **`strict: true`**)
- 作用:设为 `0` / `false` / `no` / `off`(大小写不敏感)时关闭,避免少数网关因未知字段校验失败返回 400
- 说明:与具体模型无关;若使用 DeepSeek 文档中的 **strict(Beta)工具模式**,还需 **`/beta`** base URL 与符合规范的 JSON Schema,参见 [DeepSeek Tool Calls](https://api-docs.deepseek.com/zh-cn/guides/tool_calls)
- 示例:`_local/system.env.example`
- 生效:`svc/llm/transports/openai_chat_completions.py`
## 工具执行与安全
- `AIA_DISABLE_TOOL_CONFIRM`

View file

@ -60,6 +60,7 @@
## 2026-05-10 / Unreleased
### Added
- `AIA_TOOL_FUNCTION_STRICT`:控制 OpenAI 兼容 chat completions 是否在 **`tools[].function`** 上默认加 **`strict: true`**;`0`/`false`/`no`/`off` 关闭;默认开启。影响模块:`svc/llm/transports/openai_chat_completions.py`。示例占位:`_local/system.env.example`。
- `AIA_IMAGE_EXPERT_API_KEY`、`AIA_IMAGE_EXPERT_BASE_URL`、`AIA_IMAGE_EXPERT_MODEL`、`AIA_IMAGE_EXPERT_CHAT_ENDPOINT`:图片专家(`send_legacy_image_messages`)专线,与 **`AIA_OCR_*`** 互不继承。
- `AIA_IMAGE_EXPERT_REQUEST_EXTRA`:图片专家顶层 JSON;旧名 **`AIA_LEGACY_IMAGE_REQUEST_EXTRA`** 仍作别名可读。
- `DASHSCOPE_IMAGE_*`(零散变量):由 `image_legacy_client` 映射为请求体顶层字段。