Nexa 3.0 中的 2.4 兼容路径

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

使用 2.4 兼容路径

先运行一个无需模型的程序，再编译 Agent。本文使用已发布的 Nexa v3.0.0。

1. 安装运行时

需要 Git、Python 3.10+ 和 uv。在工作目录中取得发行源码，并安装锁定的依赖：

发行 tag v3.0.0 对应已验证的 commit 2743796。

git clone --branch v3.0.0 --depth 1 https://github.com/Nexa-Language/Nexa.git
cd Nexa
uv sync --locked
uv run nexa --version

确认输出为 Nexa v3.0.0。后续命令均在这个源码目录执行。

2. 运行第一个程序

保存为 hello.nx。本例的编译和执行都无需凭据，结果为 12。

flow main {
    first = 3;
    print(first * 4);
    result = first * 4;
}

uv run nexa validate hello.nx --json
uv run nexa run hello.nx

validate 返回结构化诊断；run 编译并执行程序。需要查看生成物时运行 uv run nexa build hello.nx，生成 hello.py。

3. 定义第一个 Agent

保存为 analyst.nx。这是完整声明模块，编译不访问模型。

agent Analyst {
    prompt: "Work from evidence. State assumptions explicitly."
    timeout: 120
    max_tool_calls: 4
}

uv run nexa build analyst.nx
uv run nexa inspect analyst.nx --format json

执行 Agent 前，完成首次 provider 配置：创建含 endpoint 和模型 ID 的 secrets.nxs，通过环境或隐藏输入提供密钥。协议差异见模型协议。下面的命令使用已配置的环境发起模型请求，并将运行状态写入 .nexa/runs.sqlite3。

uv run nexa agent analyst.nx Analyst "Explain the supplied evidence" --timeout 120

完成时返回 status: completed。等待工具审批时返回 waiting_approval，按审批与恢复处理；其他停止状态按执行与预算排查。

4. 选择下一步

• 学习语言基础和工具声明。
• 用checkpoint保存与恢复任务。
• 通过工具链接入 Nexa Code 或 VS Code。
• 从旧版本迁移时，先核对2.4 迁移清单。

---

来源与验证 · compilation / execution

完整 Agent flow

这个兼容示例可以在本地编译；执行需要配置模型。

agent Analyst {
    prompt: "Work from evidence."
    timeout: 120
}

flow main {
    result = Analyst.run("Explain.");
    verify result satisfies string;
}