指南#
本目录是 OpenProgram 自有编程模型的主场——这些概念你在通用的 LLM 框架教程里找不到,在此集中呈现。如果你要为 OpenProgram 编写函数(或正在 权衡是否要写),请先读这里;通用的项目文档(安装、API 索引、故障排查) 位于其他 Tab。范式的来龙去脉见理念。
学习路径#
按顺序阅读;每一步都建立在前一步之上。
| # | 文档 | 讲什么 |
|---|---|---|
| 1 | philosophy.md |
为什么是“agentic programming”——该模型背后的设计理据 |
| 2 | writing-functions/agent.md |
直接 agent() 调用、配置化 Agent 方法与方法功能 |
| 3 | writing-functions/function-metadata.md |
参数描述、占位符、隐藏参数、render_range——函数元数据的唯一可信来源 |
| 4 | writing-functions/pure-python.md |
普通确定性 Python 帮助函数 |
| 5 | embedding-in-your-own-stack.zh.md |
把这套模型当普通库嵌进你自己的应用或框架——自带 LLM 调用,状态放你自己的目录 |
选择下一步#
OpenProgram 提供三种方式来决定函数内部“接下来执行什么”。它们不是学一次就 扔掉的互斥选项——针对每个任务挑对其中一种,才是核心技能:
| 文档 | 机制 | 何时使用 |
|---|---|---|
choosing-the-next-step/fixed-order-calls.md |
Python 代码按固定顺序调用子函数 | 步骤顺序事先已知(流水线:draft → review → revise) |
choosing-the-next-step/tool-calling.md |
厂商原生 tool use:模型每一轮挑一个函数,循环直到它以文本作答 | 开放式工作,由模型决定调用多少次、调用哪些 |
choosing-the-next-step/next-step-decision.md |
decision.make(prompt, options) / agent(prompt, choices=...):一份文本选项菜单,所选项本身解析为下一个结果 |
路由 / 有限分支;选项可以是普通值,不必是函数;无需厂商 tool-use 支持 |
参考#
../../reference/api/agent.md—— Agent、Context 与兼容 API 参考../../reference/api/runtime.md——Runtime.exec()的参数与行为- Agentic function API —— 函数编写与校验规范
../../reference/design/function/calling-unification.md—— 函数调用框架的内部设计笔记(演进 / 重构计划,编写函数时无需阅读)- LLM-as-Code: Agentic Programming for Agent Harness(arXiv:2606.15874)—— 描述该范式的论文,已被 KDD 2026 AgenticSE workshop 接收
Last updated · 2026-10-10