惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

Martin Fowler
Martin Fowler
WordPress大学
WordPress大学
月光博客
月光博客
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
大猫的无限游戏
大猫的无限游戏
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
博客园 - 聂微东
Apple Machine Learning Research
Apple Machine Learning Research
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
雷峰网
雷峰网
小众软件
小众软件
酷 壳 – CoolShell
酷 壳 – CoolShell
博客园 - 叶小钗
美团技术团队
宝玉的分享
宝玉的分享
Hugging Face - Blog
Hugging Face - Blog
阮一峰的网络日志
阮一峰的网络日志
A
About on SuperTechFans
Jina AI
Jina AI
D
Docker
Last Week in AI
Last Week in AI
MongoDB | Blog
MongoDB | Blog
Stack Overflow Blog
Stack Overflow Blog
Microsoft Azure Blog
Microsoft Azure Blog

人人都是产品经理

为什么你的产品找不到差异化?90%的失败都卡在第一步上(下) – 人人都是产品经理, 3年从30万到1300万用户、获2200万美元融资,这个AI教育产品用“抽卡”破解了获客难题 – 人人都是产品经理, 园区招商系统怎么做才能真正帮到去化?我加了这一个功能,推广链接转发400次阅读过万 – 人人都是产品经理, AI大事件:OpenAI发完网络安全模型又搞药物研发,小鹏汽车要抓”DeepSeek时刻” – 人人都是产品经理, 电商不是卖货,是一场更残酷的产品经理实战 – 人人都是产品经理, 没想到,活动营销又回来了! – 人人都是产品经理, 为何All-in海外KOC:一场关于AI时代窗口期的豪赌 – 人人都是产品经理, 重新理解企业的内部协作 – 人人都是产品经理, 苹果的 AI 战略到底是什么? – 人人都是产品经理, 医疗智能体·第2讲——合规护城河:等保、PIPL与HIPAA的架构实战 – 人人都是产品经理, 向量知识库五步法:从“答非所问”到“精准回复” – 人人都是产品经理, 鸿蒙PC三方库构建总指挥HPKBUILD(sha)库为例 – 人人都是产品经理, 何时该用LLM?AI产品经理的LLM设计指南 – 人人都是产品经理, 医疗信息领域的需求方、决策方、准入方以及关注点(二) – 人人都是产品经理, 即梦涨价:一场被误读的「傲慢」 – 人人都是产品经理, 面试AI PM必答题:Hermes和OpenClaw的区别,如何讲清楚业务价值 – 人人都是产品经理, AI的下一张船票:世界模型——AI产品经理必须理解的技术拐点 – 人人都是产品经理, 小红书做GEO,怎么让AI信你?记住这 3 个重要信息 – 人人都是产品经理, 5 家印度 AI 初创公司,看看印度 AI 再做什么 – 人人都是产品经理, AI项目跨团队协作:产品技术业务如何不打架 – 人人都是产品经理, Agentic Workflow(智能体工作流):让AI从”答案生成器”变成”数字员工” – 人人都是产品经理, lycium_plusplus 项目全景解读:OpenHarmony 三方库构建的“大管家” – 人人都是产品经理, 从爆单救火到前置履约:两套预采策略,把生鲜大促履约效率拉满 – 人人都是产品经理, 什么时候该补货?我用一轮数据做了一个决定 – 人人都是产品经理, 从“机械兜底”到“动态分流”:AI客服重复进线治理的4大底层逻辑 – 人人都是产品经理, 抖音拼效率,红书拼洞察 – 人人都是产品经理, 全民狂欢与退潮——为什么龙虾这波热潮冷却得如此之快? – 人人都是产品经理, Stripe押注!MPP重塑全球支付 – 人人都是产品经理, 小红书GEO:AI引用你的内容,不是因为你对,而是因为你看起来可信 – 人人都是产品经理, 前百度副总裁押注办公Agent,日韩付费爆发,Manus迎来强劲对手 – 人人都是产品经理,
用XML和json撰写生产级提示词
猫猫观察员的AI思考 · 2025-07-03 · via 人人都是产品经理

在AI时代,提示词不再只是“写给模型看的话”,而是产品能力的一部分。尤其在生产环境中,提示词的结构化、可维护性与可复用性,直接影响模型表现与交付效率。本文将深入探讨如何借助 XML 与 JSON 两种数据格式,构建标准化、模块化的提示词体系,帮助你从“写得对”迈向“写得稳、写得久”的提示词工程实践。

不知道你有没有遇到过这种情况:有时候测试环境中表现还行的自然语言Prompt,在生产环境中下表现出变更脆弱性、输出的不稳定性、维护的复杂性以及与现有业务系统集成的困难,成为了制约你的AI应用安全平稳运行的瓶颈。

在我前期的提示词撰写工作中,就遇到了这些问题。为了想办法解决和缓解这些现象,我学习了如何利用XML和JSON这两种语言构建可维护、可扩展且高度可靠的生产级提示词,将自己的Prompt Engineering提升到更专业的高度。

本文我将分享给大家如何利用这两种语言来构建属于自己的生产提示词。

一、生产级提示词有更高的要求

面向企业的AI应用或agent,要求输出的可预测性、一致性和稳定性,同时需要考虑后续扩展和长期维护。而由大段非结构化自然语言构成的Prompt,在满足这些要求时存在一些缺陷:

  • 输出的不确定性: LLM对输入文本的细微变化极其敏感。一个词语的增删、一句话的语序调整,都可能导致输出格式或内容发生无法预期的偏移,这对于需要稳定API响应的业务场景来说是个问题。
  • 维护困难: 随着业务逻辑的迭代,Prompt会变得越来越长、越来越复杂。当这些“巨型Prompt”编码在业务逻辑中时,调试、版本控制将变得非常麻烦。
  • 集成的壁垒: 模型的输出有时候需要被其他系统调用。从非结构化的文本中通过正则表达式或字符串分割来提取信息,是一种脆弱且低效的集成方式,任何格式的轻微变动都可能导致下游解析逻辑的崩溃。
  • 问题定位不方便:纯自然语言构成的prompt如果在调试阶段发现输出与预期不符,如果编写的结构不够清晰,那么定位问题就会存在一定的难度,很难精确找到具体是哪一部分的哪句话或哪个词不对劲。

二、用XML重构提示词:实现语义清晰与结构化

XML(Extensible Markup Language)作为一种设计用于传输和存储数据的标记语言,核心优势在于自描述性和层次化结构。

  • 语义清晰:XML的标签结构让AI能够更好地理解不同部分的作用和重要性。相比于纯文本,XML提供了明确的语义边界。
  • 层次分明:复杂的提示词往往包含多个层次的信息,XML的嵌套结构完美契合这一需求。
  • 易于解析:现代AI模型对XML格式有很好的理解能力,能够准确识别和处理结构化信息。

将这些特性应用于提示词设计,能在一定程度上缓解上述提到的问题。

如何用XML撰写提示词

XML 指令使用“标签”进行组织,每个指令部分都用一个开放标签(例如,`<Agentinstructions>`)和一个相应的闭合标签(`</Agentinstructions>`)包裹起来,闭合标签在名称前包含一个正斜杠。

这种结构类似于打包搬家时的箱子,主标签是最大的箱子,而像“角色”、“目标”和“任务”这样的子部分则是嵌套在其中的较小的箱子。这种分层方法允许清晰的组织和模块化,人类和 AI 都能轻松阅读和处理。

XML提示词基本结构设计原则:

  • 使用语义化的标签名称
  • 保持层次结构的逻辑性
  • 将不同类型的信息分离到不同标签中
  • 使用属性来添加元数据

建议在撰写时通过缩进嵌套标签来保持结构化外观。

例子:

<Root>

<角色>你是一个专业的旅行规划师。</角色>

<目标>为我规划一个为期三天的北京家庭游。</目标>

<指令>

<步骤一>推荐3个必去景点和2个特色美食。</步骤一>

<步骤二>规划每天的详细行程,包括交通方式。</步骤二>

<步骤三>估算总预算,并按“交通/住宿/餐饮/门票”分类。</步骤三>

</指令>

<输出格式>请按照下面的模板输出内容。。。</输出格式>

</Root>

三、用JSON进行提示词的撰写

用XML编写提示词能提供一致的输出,但输出仍然是一个整体。如果需要从输出中提取多个特定字段(例如,标题、正文或其他变量),就需要用到JSON。

JSON(JavaScript Object Notation)是一种轻量级的数据交换格式,是API通信和数据交换的通用语言。通过在提示词中明确要求LLM生成符合特定JSON Schema的输出,能够解决系统集成的“最后一公里“难题。

它的核心价值在于:

  • 可靠的机器解析:应用后端可以直接将LLM返回的JSON字符串反序列化为对象或数据结构,无需任何脆弱的文本解析逻辑。这让AI的输出变得像调用一个传统的、确定性的API一样可靠。
  • 无缝的系统集成:结构化的JSON输出可以直接用于填充数据库、调用其他API、驱动前端UI渲染,或作为复杂工作流中下一步的输入。
  • 明确的数据结构定义:定义JSON Schema本身也是在向模型施加一种强大的逻辑约束,迫使其思考如何将分析结果填充到预设的字段中,这反过来也提升了输出内容的质量和完整性。
  • 示例数据提供:通过JSON格式的示例,模型能够更好地理解期望的输出格式。

用JSON撰写提示词的设计技巧

  • 使用清晰的键名
  • 合理组织数据层次
  • 提供完整的示例
  • 包含必要的元数据

以下json内容表示的是对输出格式的要求,包括输出框架和每个部分字段的数据类型。

从“玩具”到“工程”

AI的强大,不仅在于模型本身,更在于我们如何与它互动。从今天起,试着用“结构化”的方式来编写提示词吧。

把提示词当成一个严肃的工程,而不是一个随意摆弄的“玩具”。通过采用XML来结构化输入指令,并利用JSON来约束输出格式,构建一个可维护、可扩展、可预测的AI产品!

本文由 @Mrs.Data 原创发布于人人都是产品经理。未经作者许可,禁止转载

题图来自Unsplash,基于CC0协议

该文观点仅代表作者本人,人人都是产品经理平台仅提供信息存储空间服务