Nexa 3.0 中的 2.4 兼容路径

本页说明保留的 2.4 语言与运行时路径，无版本声明的源码继续使用此入口。新 Open Programs 从 Nexa 3.0 开始，合同差异见迁移指南。

工具、Protocol 与 Python 扩展

用 @tool 声明参数与输出，用 uses 控制 Agent 的工具暴露集。python! 让受信任的本地代码参与工具实现。

完整工具程序

将下面的程序保存为 calculator.nx，配置模型后运行 uv run nexa run calculator.nx。Agent 可调用 add(a=2, b=3)；工具返回整数 5，模型再将结果组织为回复。

@tool("Add two integers")
fn add(a: int, b: int): int {
    python! """return a + b"""
}
agent Calculator uses add { prompt: "Calculate with the supplied tool." }
flow main { result = Calculator.run("2 + 3"); }

工具参数由 schema 验证。未暴露工具、非法 JSON、类型不符和多余字段会被拒绝。对会写文件或请求外部系统的工具，按审批指南声明风险，并处理未知结果。

结构化输出

下面的完整程序要求模型返回带整数 value 的对象，例如 {"value": 42}。返回值通过 Protocol 验证后可按字段访问。

protocol Answer { value: int }
agent Reader implements Answer { prompt: "Return the answer as structured data." }
flow main { result = Reader.run("Return 42"); }

Protocol 输出、流式输出与缓存路径都接受运行时输出校验。结构符合 schema 后，业务上的正确性仍由明确的验证条件判断。

扩展边界

python! 执行受信任代码，遵循进程权限。sandbox: true 需要真实隔离后端；Rust WASM有独立的模块执行范围。MCP 工具使用官方 SDK 会话，见生态与标准库。

---

来源与验证 · tools / types