POML 快速上手(Quick Start)

POML 快速上手(Quick Start)

参考官方教程:microsoft.github.io/poml/stable...

概述

本篇通过一个最小示例带你快速体验 POML 的核心用法:用结构化标记描述"角色、任务、上下文(图片)与输出格式",并在工具链中进行渲染与测试。

准备工作

  • 创建一个工作目录,并在其中放置两份文件:
    • example.poml
    • photosynthesis_diagram.png(任意一张光合作用示意图或你自己的图片,文件名保持一致)
  • 如需更好体验,可安装 VS Code 的 POML 扩展(语法高亮、预览、诊断等)。

目录结构(最小示例)

  • example.poml
  • photosynthesis_diagram.png

示例说明

该示例定义了:

  • 角色(<role>):模型应扮演耐心的教师。
  • 任务(<task>):基于提供的图片解释光合作用。
  • 图片(<img>):为模型提供视觉上下文(需与 .poml 同目录)。
  • 输出格式(<output-format>):限制风格与长度,确保结果稳定可控。

示例内容(概念展示)

将以下概念示例保存为 example.poml。为便于阅读,本示例加入了换行与缩进,语义与官方示例一致。

poml 复制代码
<poml>
  <role>
    You are a patient teacher explaining concepts to a 10-year-old.
  </role>

  <task>
    Explain the concept of photosynthesis using the provided image as a reference.
  </task>

  <img src="photosynthesis_diagram.png" alt="Diagram of photosynthesis" />

  <output-format>
    Keep the explanation simple, engaging, and under 100 words.
    Start with "Hey there, future scientist!".
  </output-format>
</poml>

运行与测试思路

  • 使用 POML 工具链进行渲染与测试(可在 VS Code 扩展中预览)。
  • 使用具备视觉能力的 LLM 进行测试(因为示例包含 <img>)。
  • 你也可以先替换为文本上下文进行测试(例如用 <document> 嵌入一段文字),再扩展到图片。

变体练习(建议)

  • 替换图片内容:用你自己的业务相关图片,观察输出差异。
  • 文本-only 版本:移除 <img>,改用 <document> 或外部文本,验证对输出的影响。
  • 输出风格控制:修改 <output-format> 中的长度、语气、段落/列表格式要求。
  • 结构化扩展:根据入门篇,尝试增加 <example><let> 变量、或样式层(<stylesheet>)来解耦逻辑与呈现。

常见问题

  • 图片找不到:确保 example.pomlphotosynthesis_diagram.png 处于同一目录,且 src 文件名一致。
  • 输出不稳定:通过 <output-format> 明确格式与长度;必要时拆分角色/任务/示例为独立片段以增强稳定性。
  • 多数据整合:使用 <document><table><img> 等组件组合多源信息;对呈现进行样式化以提高一致性。

视频与后续学习

相关推荐
镰刀韭菜8 小时前
【AI4S】DrugChat:迈向在药物分子图上实现类似ChatGPT的功能
llm·图神经网络·预训练·gnn·ai4s·drugchat·药物分子图谱
山顶夕景2 天前
【LLM-RL】GSPO算法Group Sequence Policy Optimization
llm·强化学习·rlhf·gspo
余衫马2 天前
llama.cpp:本地大模型推理的高性能 C++ 框架
c++·人工智能·llm·llama·大模型部署
yaocheng的ai分身2 天前
A16Z 大佬 Alex Rampell《Software Is Eating Labor》演讲
llm
utmhikari2 天前
【测试人生】LLM赋能游戏自动化测试的一些想法
自动化测试·游戏·ai·大模型·llm·游戏测试
智泊AI2 天前
突然发现:大模型RAG优化思路真的好清晰!
llm
玩转AGI2 天前
【必收藏】12-Factor Agents:让大模型Agent从能跑起来到能用起来的企业级设计指南
人工智能·程序员·llm
数据智能老司机2 天前
建构 AI Agent 应用——保护代理式系统
架构·llm·agent
夫子3963 天前
【深度干货】Transformer推理优化完全指南:模型压缩、推理加速与硬件调优
人工智能·llm
智泊AI3 天前
终于有人把AI大模型训练过程讲明白了!!!
llm