Prompty

GenAIScript supports running .prompty files as scripts (with some limitations).

What is prompty?

Prompty is a markdown-ish file format to store a parameterized prompts along with model information.

basic.prompty

---
name: Basic Prompt
description: A basic prompt that uses the chat API to answer questions
model:
    api: chat
    configuration:
        type: azure_openai
        azure_deployment: gpt-4o
    parameters:
        max_tokens: 128
        temperature: 0.2
inputs:
    question:
        type: string
sample:
    "question": "Who is the most famous person in the world?"
---

system:
You are an AI assistant who helps people find information.
As the assistant, you answer questions briefly, succinctly.

user:
{{question}}

{{hint}}

Running .prompty with GenAIScript

You can run a .prompty file from the cli or Visual Studio Code as any other .genai.mjs script.

GenAIScript will convert the .prompty content as a script and execute it. It supports most of the front matter options but mostly ignores the model configuration section.

This is what the basic.prompty file compiles to:

basic.prompty.genai.mts

script({
    model: "azure:gpt-4o",
    title: "Basic Prompt",
    description: "A basic prompt that uses the chat API to answer questions",
    parameters: {
        question: {
            type: "string",
            default: "Who is the most famous person in the world?",
        },
    },
    temperature: 0.2,
    maxTokens: 128,
})

$`You are an AI assistant who helps people find information.
As the assistant, you answer questions briefly, succinctly.`
$`{{question}}

{{hint}}`.jinja(env.vars)

Supported features

• name, description, temperature, max_tokens, top_p, …0

• inputs converted to parameters

• sample value populates the parameters default section

• outputs converted to responseSchema

• Jinja template engine

• model configuration uses GenAIScript .env file (see configuration).

• images are not yet supported

Extensions

Extra fields that genaiscript use:

• files to specify one or many files to populate env.files
• tests to specify one or many tests