Agent SDK发布：用Markdown和TypeScript定义AI代理

AI代理的开发方式正在经历一次范式转变。最新发布的Agent SDK允许开发者以代码形式定义代理，用Markdown编写提示词、用TypeScript构建工具，并选择托管或自托管部署。内置的评估功能让每次改动都可度量，推动代理持续迭代。

从零散脚本到工程化开发

过去构建AI代理，提示词往往散落在代码字符串中，工具逻辑与业务逻辑交织，调试和版本管理困难。Agent SDK将代理拆解为清晰的组件：提示词以Markdown文件独立管理，工具用TypeScript函数实现，整个代理则通过代码声明式定义。

这种分离带来直接好处：提示词可以像文档一样审阅和修改，工具函数享受TypeScript的类型检查，代理配置纳入版本控制。开发团队可以像维护普通软件项目一样维护AI代理。

核心能力解读

声明式代理定义

开发者通过SDK提供的接口定义代理的角色、可用工具和交互流程。代理不再是黑盒，而是可读、可测试的代码实体。这与传统在提示词中“堆砌指令”的做法形成鲜明对比，代理的行为边界更加明确。

声明式（declarative）是与命令式（imperative）相对的编程范式：命令式描述“如何一步步执行”，声明式只描述“期望的结果或结构”，由底层系统负责实现细节。在代理开发中，声明式定义意味着开发者用结构化配置描述代理的角色、可用工具集、交互约束，而不用手写调度逻辑、消息拼接和循环控制。这与Kubernetes的YAML清单、React的组件声明思路一致，好处是配置可被静态分析、可序列化、可复用，也便于SDK在运行时统一注入日志、重试和权限控制。相比在提示词里堆砌自然语言指令，声明式定义的代理边界更明确，行为更容易被测试和审计，也更容易在不同模型之间迁移。

Markdown提示词管理

将提示词移到Markdown文件中，最大的价值在于协作。产品经理、领域专家可以直接编辑Markdown调整代理行为，无需触碰TypeScript代码。提示词变更也能通过代码审查流程追踪，避免随意改动引发的意外行为漂移。

TypeScript工具集成

工具是代理与外部世界交互的桥梁。用TypeScript编写工具意味着完整的类型安全和IDE支持，工具的参数、返回值、错误处理都可以在编译期发现。对于已经在TypeScript生态中的团队，接入成本显著降低。

部署与自托管的选择

Agent SDK提供两种运行方式：部署到官方托管基础设施，或运行在自有环境中。托管方案适合快速验证和上线，省去运维负担；自托管则满足数据合规、网络隔离等企业级需求。这种灵活性让同一套代理代码可以跨越不同环境使用，避免供应商锁定带来的迁移成本。

内置评估：让改进有据可依

内置的评估功能是Agent SDK区别于简单封装库的关键。每次修改提示词或工具逻辑后，开发者可以运行评估来衡量代理表现的变化。代理开发由此进入“修改—测量—迭代”的闭环，而非凭感觉调参。

评估数据还能积累为回归测试集，防止后续改动破坏已有能力。对于需要长期维护的代理产品，这种工程化能力比单次效果提升更有价值。

回归测试集（regression test set）源自传统软件工程，指一组固定输入与预期输出的用例集合，用于在每次改动后快速发现“改一处坏一片”的问题。对AI代理而言，由于模型输出具有不确定性，评估通常不追求逐字比对，而是采用评分器（grader）判定：可以是精确匹配、规则校验、关键词或结构检查，也可以让另一个模型充当裁判（LLM-as-a-judge）按 rubric 打分。一个实用的评估集应覆盖典型任务、边界情况和历史失败案例，并定期补充线上暴露的新问题。指标上常见通过率、任务完成率、工具调用正确率与平均延迟等。评估集本身也需要版本管理，与提示词、工具代码一并纳入仓库，才能形成真正可追溯的迭代闭环。

对开发者的意义

Agent SDK将AI代理开发从“提示词工程”推向“软件工程”。Markdown与TypeScript的组合降低了协作门槛，托管与自托管的双选项覆盖了从个人项目到企业部署的场景，内置评估则补上了代理迭代中缺失的度量环节。对于正在将AI能力产品化的团队，这套工具链值得纳入技术选型评估。