Build

Documentation Index

Fetch the complete documentation index at: https://docs.agentmark.co/llms.txt

Use this file to discover all available pages before exploring further.

​

What are AgentMark prompts?

• Readable — Human-friendly syntax that’s easy to review and understand
• Reusable — Share components across prompts and use variables for dynamic content
• Type-Safe — Full TypeScript support for props and outputs
• Version-Controlled — Store prompts in git alongside your code
• Testable — Run experiments with datasets and automated evaluations

​

Basic structure

​

1. Frontmatter (YAML)

---
name: example
text_config:
  model_name: gpt-4o-mini
  temperature: 0.7
---

​

2. Template content

<System>
You are a helpful assistant.
</System>

<User>
Summarize the following text: {props.text}
</User>

​

Creating prompts

• Cloud
• Local

Use the Dashboard’s visual editor to create and edit prompts — no coding or git knowledge required.The visual editor shows the frontmatter and message-tag body, a model selector, input-variable fields, and a streaming output pane — the same UI features available to someone editing the .prompt.mdx file locally.

• Write and edit prompts with syntax highlighting
• Test prompts directly in the editor
• Configure model settings through visual controls
• Preview outputs in real-time

Step-by-step guide →

Create .prompt.mdx files in your project’s agentmark/ directory:

agentmark/greeting.prompt.mdx

---
name: greeting
text_config:
  model_name: gpt-4o-mini
  temperature: 0.7
---

<System>
You are a friendly assistant.
</System>

<User>
Say hello to {props.name}.
</User>

Run it from the CLI:

npx agentmark run-prompt agentmark/greeting.prompt.mdx

Or execute it from your application — see Running Prompts.

​

Key features

​

Message tags

• <System> — System-level instructions
• <User> — User messages
• <Assistant> — Assistant responses (for few-shot examples)

​

Dynamic variables

<User>
Hello {props.userName}, you have {props.messageCount} new messages.
</User>

​

Conditional logic and loops

<User>
  <If condition={props.isPremium}>
    You have access to premium features.
  </If>

  Products:
  <ForEach arr={props.products}>
    {(product) => (
      <>- {product.name}: ${product.price}</>
    )}
  </ForEach>
</User>

You have access to premium features.

Products:
- Widget: $10
- Gadget: $20

​

Generation types

• Text — Natural language responses
• Object — Structured JSON with schema validation
• Image — Image generation
• Speech — Audio generation

​

Advanced features

• Tools & Agents — Extend prompts with function calling and multi-step agent workflows
• Components — Create shared, reusable components across prompts
• Schema References — Reuse JSON schema definitions across prompts
• File Attachments — Include images and documents in prompts
• MCP Integration — Connect to Model Context Protocol servers
• Playground — Compare prompts across multiple models side-by-side
• Version Control — Track and manage prompt versions

​

Next steps