Schnellstart

In wenigen Minuten von der Installation zu einem geparsten Agenten mit extrahierten Nachrichten.

1. Installieren

installation

go get github.com/itsatony/go-exons

2. Einen Agenten definieren

Lege eine Datei hello.exons an — YAML-Frontmatter beschreibt die Konfiguration, der Template-Body den Prompt:

hello.exons

---
name: greeter
description: A friendly greeter agent
type: agent
execution:
  provider: openai
  model: gpt-4o
  temperature: 0.7
---
{~exons.message role="system"~}
You are a friendly greeter.
{~/exons.message~}

{~exons.message role="user"~}
Say hello to {~exons.var name="user_name" default="World" /~}
{~/exons.message~}

3. Parsen und verwenden

main.go

engine := exons.MustNew()
tmpl, _ := engine.Parse(source)

// Template ausführen und strukturierte Nachrichten extrahieren
messages, _ := tmpl.ExecuteAndExtractMessages(ctx, map[string]any{
    "user_name": "Alice",
})
// messages[0] → {Role: "system", Content: "You are a friendly greeter."}
// messages[1] → {Role: "user",   Content: "Say hello to Alice"}

// Auf die geparste Spezifikation zugreifen
spec := tmpl.Spec()
fmt.Println(spec.Name)            // "greeter"
fmt.Println(spec.Execution.Model) // "gpt-4o"

Das war’s. go-exons parst und validiert die Spezifikation und extrahiert die Nachrichten — die Ausführung gegen ein LLM übernimmt deine Laufzeitumgebung.

Weiter

Konzept — warum es das Format gibt und wie es aufgebaut ist.
Format-Referenz — alle Frontmatter-Felder und Template-Tags.
Beispiele — sieben durchgearbeitete .exons-Dateien.