本页译自英文文档。命令、标识符和示例保持原样。运行时 7.24.4 · SDK 2.6.7。 英文原文
关于固定源文件的提问
状态:当前源码 范围:AX Trust 固定上下文提问命令 最近审阅:2026-09-18 负责人:AX Code 运行时维护者
使用 ax-code ask,通过现有的 AX Trust 连接,对显式选定的代码或文档提出独立问题:
ax-code ask --file src/value.py \
--model defai-01-ax-trust-com/openai/gpt-oss-120b \
"What does this function return?"
把提供方/模型换成你的 AX Trust 连接上已授权的模型。提供方必须是 AX Trust 连接。options.axTrust 会话亲和设置不会启用或禁用此命令。该命令在每次调用时重新读取文件,将其完整内容作为固定上下文提供,并加入网关的语义缓存契约。你不需要添加头或安装嵌入。AX Trust 必须已为你的池和运行时启用该功能;否则它可以返回普通答案。
用相同的文件和选项提出改写后的问题:
ax-code ask --file src/value.py \
--model defai-01-ax-trust-com/openai/gpt-oss-120b \
"What does the function return?"
答案进入标准输出;标准错误报告 AX Trust cache: MISS、HIT、EXACT_HIT、BYPASS 或 UNREPORTED。HIT 表示网关报告了语义复用;EXACT_HIT 表示其精确命名空间匹配。UNREPORTED 表示服务器没有提供可识别的缓存头。旁路不会为了强行命中而重试。添加 --json 可获得答案、提供方/模型身份、上下文摘要、缓存状态,以及上游实际报告时的可选请求 ID/分数和用量。缓存响应不必包含用量;缺少用量不是节省估算。
重复 --file 以加入更多上下文:
ax-code ask --file src/value.py --file docs/value.md \
--model defai-01-ax-trust-com/openai/gpt-oss-120b \
--max-tokens 1024 --json \
"How is the return value determined?"
选择回答该问题所需的全部依赖。该命令不发送对话历史、发现的仓库说明、工具、搜索结果或测试执行。它不编辑文件,也不运行命令。新的调用读取当前字节;代码或选项变化会产生不同的固定上下文。文件可能在被读取之后发生变化,因此答案描述的是所提供的快照。实时调查、编辑和测试请使用普通的 ax-code run 或 TUI。
限制:当前目录树内 1 到 14 个互不相同的常规 UTF-8 文件,文件内容合计 96 KiB,请求编码之后 128 KiB。上下文从不截断。符号链接不能逃出该目录。适用已配置默认智能体的读取权限;拒绝或未解决的询问会在模型传输之前停止。请选择被允许的文件,或使用带批准的普通会话。
问题必须是一行,最多 1024 个 UTF-8 字节。把内联代码放在文件里,而不是问题里。输出限制为 1 到 4096 个 token,默认 512;temperature 固定为零。请求是非流式的,截止时间为 90 秒,并且不会回退到另一个模型。不完整或可执行的响应会被拒绝。相似的问题仍可能含义不同:仅对答案依赖于所选固定内容的问题选择加入。
在 TUI 中,输入 /ask,或从命令面板选择 询问固定文件。它使用当前选定的模型。每行输入一个相对路径(粘贴多行以选择多个文件),然后输入你的问题。对话框显示服务器目录、答案和实际缓存状态。按 r 使用同一文件选择再问一个问题;服务器会重新读取这些文件。Escape 关闭对话框并取消待处理请求。结果留在对话框中,不会插入编码会话,也不会作为工具执行。已连接的 TUI 客户端需要带有固定上下文端点的服务器。