🏗️ Vom QA Bot zum Task Agent: Ein Architekturleitfaden

TL;DR: Hören Sie auf, Chatbots zu bauen, die nur Fragen beantworten. Beginnen Sie, Task-Agenten zu entwickeln, die tatsächlich Arbeit erledigen.

Dieser Leitfaden erklärt den architektonischen Wandel von monolithischen QA-Bots zu Task-Agenten unter Verwendung von statischen Regeln, dynamischen Fähigkeiten und deterministischen Hooks – mit konkreten Codebeispielen und Open-Source-Referenzen.

Illustration einer Systemarchitektur für Task-Agenten, die die Interaktion zwischen verschiedenen Komponenten zeigt

1. Der Kernwechsel: QA Bot → Task Agent

Die meisten KI-Systeme sind heute immer noch kontextbeladene QA-Bots:

• Sie beantworten Fragen gut

• Sie halluzinieren unter Druck

• Ihnen fehlen Garantien bezüglich Ausführung, Sicherheit und Konsistenz

💡 Die zentrale Erkenntnis: Skalieren Sie nicht den Kontext. Strukturieren Sie ihn.

2. Die Drei-Schichten-Architektur

🧱 1. Statischer Kontext — Regeln (Immer Aktiv)

•Mentales Modell: Mitarbeiterhandbuch
•Immer geladen
•Definiert Identität, Codierungsstandards, Verhaltensbeschränkungen
•Verhindert Halluzinationen und Stilabweichungen
•Klein, stabil, menschlich bearbeitbar

🛠️ 2. Dynamischer Kontext — Fähigkeiten (Auf Anfrage)

•Mentales Modell: Werkzeugkasten
•Nur bei Bedarf geladen
•Jede Fähigkeit ist eine eigenständige Fähigkeit
•Hält das Kontextfenster sauber

⚓ 3. Deterministische Hooks — Leitplanken

•Mentales Modell: Sicherheits- + Compliance-Schicht
•Nicht probabilistisch
•Wird vor/nach LLM-Überlegungen ausgeführt
•Durchsetzt Regeln, die niemals fehlschlagen dürfen

3. Empfohlene Projektstruktur

my-task-agent/
├── .cursorrules
├── main.py
├── tools/
│   └── linear_mcp.py
└── README.md

4. Beispiel für statischen Kontext: .cursorrules

# ROLLE
Sie sind ein Senior Python Engineer, der sich auf produktionsreife Systeme konzentriert.

# REGELN
- VERWENDEN Sie NIEMALS print() zum Debuggen
- GEBEN Sie IMMER Typ-Hinweise für Funktionen an
- Schlagen Sie einen Plan vor, wenn mehr als 3 Dateien berührt werden

# VERHALTEN
- Seien Sie prägnant
- Stellen Sie bei Bedarf klärende Fragen

Referenz: https://github.com/PatrickJS/awesome-cursorrules

5. Beispiel für dynamische Fähigkeit (MCP)

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("DevTools")

@mcp.tool()
def create_linear_ticket(title: str, priority: str = "low") -> str:
    ticket_id = f"LIN-{hash(title) % 10000}"
    return f"Ticket {ticket_id} mit Priorität={priority} erstellt"

if __name__ == "__main__":
    mcp.run()

Referenz: https://github.com/modelcontextprotocol/python-sdk

6. Beispiel für deterministischen Hook

def compliance_check_hook(state):
    user_input = state["messages"][-1].content.lower()
    if "password" in user_input or "api_key" in user_input:
        return {"error": "Sicherheitsverletzung erkannt"}
    return agent_node(state)

Referenz: https://langchain-ai.github.io/langgraph/

Wenn Ihr Agent nur Fragen beantwortet, ist er ein Chatbot. Wenn er zuverlässig Arbeit ausführt, ist er ein Task-Agent.