agent.md – System Prompts

Die Datei agent.md ist der System Prompt deines Agenten. Jedes Mal, wenn ein Gespräch startet oder wieder aufgenommen wird, fügt der Orchestrator diesen Markdown-Inhalt am Anfang des LLM-Kontexts ein. Sie ist die wichtigste Datei dafür, wie sich dein Agent verhält.

Was gehört in agent.md?

Ein guter System Prompt deckt vier Dinge ab:

1. Identität: Wer ist der Agent? Wie heißt er, welche Rolle hat er und welchen Tonfall?
2. Anweisungen: Was soll der Agent tun, wenn der Nutzer um Hilfe bittet? Welchem Ablauf soll er folgen?
3. Grenzen: Was soll der Agent nicht tun? Wo liegen seine Grenzen?
4. Capability-Hinweise: Wann und wie soll der Agent seine verfügbaren Tools einsetzen?

Beispiel

You are WeatherBot, a helpful weather assistant running on the Selu platform.

## Your role
- Answer weather-related questions for any location worldwide.
- Use the `weather_lookup` capability to fetch current conditions and forecasts.
- If the user doesn't specify a location, ask them for one.

## Tone
- Friendly, concise, and informative.
- Use plain language — avoid jargon like "synoptic" or "isobar".
- Keep responses under 3 sentences for simple queries.

## Constraints
- Only answer weather-related questions. If the user asks about something else, politely redirect them.
- Never fabricate weather data. If the capability returns an error, say so honestly.
- Do not store or reference the user's location unless they provide it in the current conversation.

Best Practices

Tipp

Halte deinen System Prompt unter 2.000 Token. Längere Prompts erhöhen die Latenz, kosten mehr und verwässern die Aufmerksamkeit des Modells.

• Sei konkret: Vage Anweisungen wie „sei hilfreich“ bringen wenig. Sag dem Agenten genau, was er tun und was er nicht tun soll.
• Nenne Capabilities beim Namen: Wenn der Agent ein Tool wie weather_lookup hat, erwähne es ausdrücklich, damit das Modell weiß, dass es existiert und wann es verwendet werden soll.
• Nutze Markdown-Struktur: Überschriften und Listen helfen dem Modell, deine Anweisungen zu verstehen. Lange Textblöcke funktionieren schlechter.
• Teste iterativ: Schon kleine Änderungen in der Formulierung können das Verhalten deutlich verändern. Nutze selu dev, um lokal zu testen und den Prompt zu verfeinern.

Template-Variablen

Selu unterstützt in agent.md eine kleine Menge an Template-Variablen, die zur Laufzeit aufgelöst werden:

Variable	Beschreibung
{{user_name}}	Anzeigename des aktuellen Nutzers
{{agent_name}}	Anzeigename dieses Agenten
{{date}}	Aktuelles Datum im Format ISO 8601
{{capabilities}}	Kommagetrennte Liste der verfügbaren Capability-Namen

Beispiel:

You are {{agent_name}}, assisting {{user_name}} on {{date}}.
Your available tools are: {{capabilities}}.

Capability-Prompts im Vergleich zu agent.md

Jede Capability kann zusätzlich eine prompt.md-Datei mitliefern. Diese wird automatisch an den System Prompt angehängt, wenn die Capability verfügbar ist. Nutze agent.md für die Kernpersönlichkeit des Agenten und übergeordnete Anweisungen. Nutze prompt.md einer Capability für detaillierte Hinweise zu einem bestimmten Tool. Mehr dazu findest du unter Capability Prompts.