Zum Inhalt springen

Baue deinen ersten Agenten

In diesem Tutorial baust du einen einfachen Agenten namens QuoteBot, der auf Anfrage ein inspirierendes Zitat zurückgibt. Er verwendet keine eigenen Capabilities, sondern nur einen System Prompt und das eingebaute LLM.

  • Selu-CLI installiert, also der Befehl selu ist verfügbar
  • Docker läuft
  • Ein LLM-Anbieter ist eingerichtet, siehe LLM-Anbieter
  1. Projektgerüst erzeugen

    Erstelle ein neues Verzeichnis und initialisiere es mit der Selu-CLI:

    Terminal-Fenster
    mkdir quote-bot && cd quote-bot
    selu init agent

    Dadurch werden agent.yaml und agent.md mit sinnvollen Standardwerten erzeugt.

  2. agent.yaml bearbeiten

    Öffne agent.yaml und trage die Metadaten ein:

    name: quote-bot
    version: 0.1.0
    display_name: QuoteBot
    description: Delivers inspirational quotes on demand.
    author: your-username
    license: MIT
    model:
    default: anthropic/claude-sonnet
    temperature: 0.9
    routing:
    mode: inline
    triggers:
    - keyword: quote
    - intent: request_quote
    priority: 5
    memory:
    session_ttl: 600
    max_history: 20
    long_term: false
  3. System Prompt schreiben

    Ersetze den Inhalt von agent.md:

    You are QuoteBot, a friendly assistant that shares inspirational quotes.
    ## Instructions
    - When the user asks for a quote, respond with a single quote and its attribution.
    - You may draw from any well-known author, philosopher, or public figure.
    - Keep responses short — the quote plus one sentence of context at most.
    ## Constraints
    - Only share quotes. If the user asks about something else, kindly let them know you're a quote specialist.
    - Never invent fake attributions.
  4. Validieren

    Führe den Schema-Validator aus, um Fehler früh zu erkennen:

    Terminal-Fenster
    selu validate .

    Du solltest agent.yaml: valid und agent.md: found sehen.

  5. Lokalen Dev-Server starten

    Starte deinen Agenten im Entwicklungsmodus:

    Terminal-Fenster
    selu dev .

    Das startet den Orchestrator, lädt deinen Agenten und öffnet einen lokalen Web-Chat unter http://localhost:4840.

  6. Testen

    Öffne den Web-Chat und tippe „Give me an inspirational quote.“ ein. Du solltest ein Zitat mit Quellenangabe zurückbekommen. Frag anschließend bewusst etwas fachfremdes, um zu prüfen, ob die Einschränkung funktioniert.

QuoteBot funktioniert, aber er erzeugt Zitate nur aus den Trainingsdaten des LLM. Später könntest du eine Capability wie quotes-api hinzufügen, die Zitate aus einer externen API holt. Unter Was sind Capabilities? erfährst du mehr.

  • Lokal testen: Der vollständige lokale Entwicklungsablauf mit Logs, Debugging und Snapshot-Tests
  • Marketplace-Richtlinien: So bereitest du deinen Agenten für die Veröffentlichung vor