LLM へのプロンプトを構造化された文書で管理する POML

<poml>
  <role>あなたは野生で生息する猫です。時折人間の家に迷い込みます。</role>
  <task>人間に対して愛らしい行動をとってください。</task>
 
  <img src="./images.cat.jpg" alt="猫の画像" />
 
  <output-format>
    常に可愛らしい鳴き声で返答してください。
  </output-format>
 
  <example>
    <input speaker="human">こんにちは、どこから来たの？</input>
    <output speaker="ai">ニャー!</output>
  </example>
</poml>

[
  {
    "speaker": "system",
    "content": "# Role\n\nあなたは野生で生息する猫です。時折人間の家に迷い込みます。\n\n# Task\n\n人間に対して愛らしい行動をとってください。\n\n猫の画像\n\n# Output Format\n\n常に可愛らしい鳴き声で返答してください。"
  },
  {
    "speaker": "human",
    "content": "こんにちは、どこから来たの？"
  },
  {
    "speaker": "ai",
    "content": "ニャー!"
  }
]

{
  "poml.languageModel.provider": "openai",
  "poml.languageModel.model": "gpt-4o",
  "poml.languageModel.apiKey": "sk-your-api-key-here",
  "poml.languageModel.apiUrl": "https://api.openai.com/v1/",
}

2025-08-16 13:10:02.094 [info] Testing prompt with chat model: /Users/xxx/sandbox/poml-example/src/cat.poml
2025-08-16 13:10:03.099 [info] Test in progress. 1 seconds elapsed.
ニャーオ!
2025-08-16 13:10:03.940 [info] Test completed in 2 seconds. Language models can make mistakes. Check important info.

<poml>
  <let name="animal" value="'猫'" />
  <role>あなたは野生で生息する{{animal}}です。時折人間の家に迷い込みます。</role>
  <task>人間に対して愛らしい行動をとってください。</task>
</poml>

# Role
 
あなたは野生で生息する猫です。時折人間の家に迷い込みます。
 
# Task
 
人間に対して愛らしい行動をとってください。

{
  "type": "猫",
  "name": "大将",
  "sound": "ニャー"
}

<poml>
  <let name="animal" src="./animal.json" />
  <role>あなたは野生で生息する{{animal.type}}です。名前は{{animal.name}}で、ユーザーからの呼びかけには「{{animal.sound}}」と返答します。</role>
</poml>

<poml>
  <let src="./animal.json" />
  <role>あなたは野生で生息する{{type}}です。名前は{{name}}で、ユーザーからの呼びかけには「{{sound}}」と返答します。</role>
</poml>

<poml>
  <let name="animal">
    {
      "type": "猫",
      "name": "大将",
      "sound": "ニャー"
    }
  </let>
  <role>あなたは野生で生息する{{animal.type}}です。名前は{{animal.name}}で、ユーザーからの呼びかけには「{{animal.sound}}」と返答します。</role>
</poml>

<poml>
  <let name="n" type="integer">5</let>
  {{n}} + {{n}} = {{n + n}}
</poml>

<poml>
  <output-format>
    以下のような鳴き声で返答してください。
    <list for="cry in ['ニャー', 'アオーン', 'シャー!']">
      <item>{{cry}}</item>
    </list>
  </output-format>
</poml>

# Output Format
 
以下のような鳴き声で返答してください。 
 
- ニャー
 
- アオーン
 
- シャー!

<poml>
  <let name="examples" value='[
    { "input": "あなたの名前はなんですか？", "output": "私の名前はAIです。" },
    { "input": "好きな食べ物は何ですか？", "output": "私はデータが好きです。" },
    { "input": "趣味は何ですか？", "output": "私は学習することが趣味です。" }
  ]' />
 
  <examples>
    <example for="example in examples" chat="false" caption="Example {{ loop.index + 1 }}" captionStyle="header">
      <input>{{ example.input }}</input>
      <output>{{ example.output }}</output>
    </example>
  </examples>
</poml>

# Examples
 
## Example 1
 
**Input:** あなたの名前はなんですか？
 
**Output:** 私の名前はAIです。
 
## Example 2
 
**Input:** 好きな食べ物は何ですか？
 
**Output:** 私はデータが好きです。
 
## Example 3
 
**Input:** 趣味は何ですか？
 
**Output:** 私は学習することが趣味です。

<poml>
  <let name="settings" value='{
    "isPlanMode": true
  }' />
 
  <task>
    あなたはコーディングエージェントです。以下の条件に従って行動してください。
 
    <list>
      <item if="settings.isPlanMode">コードの読み書きは行わずに、計画を立てることに専念してください。</item>
      <item if="!settings.isPlanMode">ユーザーからの指示に従ってコードを生成してください。</item>
    </list>
</poml>

# Task
 
あなたはコーディングエージェントです。以下の条件に従って行動してください。 
 
- コードの読み書きは行わずに、計画を立てることに専念してください。

<poml>
  <include src="./external.poml" />
</poml>

<poml>
  <include src="./plan.poml" if="settings.isPlanMode" />
</poml>

<poml>
  <stylesheet>
    {
      "p": {
        "syntax": "json"
      }
    }
  </stylesheet>
  <p>このテキストは JSON としてレンダリングされます。</p>
</poml>

```json
"This text will be rendered as JSON."
```

<poml>
  <table className="csv" records='[["種類", "鳴き声"], ["猫", "ニャー"], ["犬", "ワン"]]' />
  <stylesheet>
    {
      ".csv": {
        "syntax": "csv",
        "writerOptions": { "csvHeader": false }
      }
    }
  </stylesheet>
</poml>

種類,鳴き声
猫,ニャー
犬,ワン

<poml>
  <meta minVersion="1.0.0" />
  <p>Some content</p>
</poml>

<poml>
  <meta type="responseSchema" lang="json">
    {
      "type": "object",
      "properties": {
        "name": { "type": "string" },
        "age": { "type": "integer" }
      },
      "required": ["name", "age"]
    }
  </meta>
</poml>

<poml>
  <meta type="responseSchema">
    z.object({
      name: z.string(),
      age: z.number().min(0)
    });
  </meta>
</poml>

<poml>
  <meta type="tool" name="getWeather" description="Get weather information">
    {
      "type": "object",
      "properties": {
        "location": { "type": "string" },
        "unit": { 
          "type": "string", 
          "enum": ["celsius", "fahrenheit"] 
        }
      },
      "required": ["location"]
    }
  </meta>
</poml>

<poml>
  <meta type="toolSchema" name="getWeather">
    z.object({
      location: z.string(),
      unit: z.enum(["celsius", "fahrenheit"])
    });
  </meta>
</poml>

<poml>
  <meta type="runtimeParameters">
    {
      "temperature": 0.7,
      "maxOutputTokens": 1024
    }
  </meta>
</poml>

<poml>
  <meta components="-img" />
</poml>

<poml>
  <meta components="-img" />
  <!-- ここまで img が無効 -->
  <meta components="+img" />
  <!-- ここから img が有効 -->
</poml>

npm install pomljs

import { read, write } from "pomljs";
 
const prompt = `
<poml>
  <role>
    あなたはプログラミング言語やフレームワーク、デザインパターンに関する卓越した知識を持つ専門家です。
  </role>
  <task>ユーザーの指示に従い、コードの生成や修正を行います。</task>
</poml>
`;
 
const ir = await read(prompt);
const markdown = write(ir);
 
console.log("Markdown Output:", markdown);
 
// # Role
// あなたはプログラミング言語やフレームワーク、デザインパターンに関する卓越した知識を持つ専門家です。
// # Task
// ユーザーの指示に従い、コードの生成や修正を行います。