So erstellen Sie Ihren ersten eigenen KI-Assistenten: Eine 5-Schritte-Anleitung für Anfänger

Die einfachste und sinnvollste Antwort lautet: Entwickeln Sie Ihren ersten KI-Assistenten so, dass er eine klar definierte Aufgabe, einen eindeutigen Satz an Anweisungen und maximal ein oder zwei kontrollierte Tools erfüllt . Beginnen Sie nicht mit einer Vielzahl von Agenten, einer riesigen Wissensdatenbank oder einer Automatisierung, die wichtige Systeme verändern kann. Ein erster Assistent sollte leicht verständlich, einfach zu testen und bei Unsicherheiten einfach zu stoppen sein.

Dieser Leitfaden verwendet Python und das aktuelle OpenAI Agents SDK als konkretes Beispiel, da es bereits die Agentenschleife, Tools, Konversationssitzungen, Schutzmechanismen und das Tracing abdeckt. Die gleichen Designprinzipien gelten auch für andere Modellanbieter und Frameworks. Seit September 2026 verwendet das SDK standardmäßig die Responses API für OpenAI-Modelle. Die offizielle OpenAI-Dokumentation empfiehlt die direkte Verwendung der Low-Level-Response-API, wenn Sie die Schleife und den Zustand selbst verwalten möchten, und das Agents SDK, wenn die Laufzeitumgebung einen größeren Teil dieser Orchestrierung übernehmen soll. Siehe die Übersicht zum OpenAI Agents SDK .

Was genau bauen Sie?

Ein KI-Assistent ist mehr als nur ein Chatfenster. Er kombiniert mindestens ein umfangreiches Sprachmodell (LLM) – ein Modell, das Sprache generiert und interpretiert – mit Anweisungen, die seine Rolle definieren. Ein nützlicher Assistent verfügt außerdem über Werkzeuge , also Funktionen oder Dienste, die er aufrufen darf, und über einen Speicher , der den relevanten Gesprächskontext zwischen den einzelnen Beiträgen speichert.

Stellen Sie sich für ein erstes Projekt einen kleinen „Shop-Helfer“ vor, der Fragen zu Rückgabe und Versand beantwortet. Er sollte sich auf eine genehmigte Richtlinienquelle stützen, anstatt zu raten. Falls er keine genehmigte Antwort findet, sollte er dies melden. Diese Einschränkung ist wichtiger als die Ausstattung des Assistenten mit Dutzenden von Funktionen.

Bevor Sie beginnen: Wählen Sie den richtigen Build-Pfad.

Wenn Sie einen wiederverwendbaren Assistenten in Ihrer eigenen App, Website, Ihrem internen Tool oder Ihrer API benötigen, ist der unten beschriebene Code-First-Ansatz gut geeignet. Sie benötigen Python, einen OpenAI-API-Schlüssel und grundlegende Programmierkenntnisse. Die offizielle Agents SDK-Schnellstartanleitung zeigt die aktuelle Installation und den Ablauf für den ersten Agenten.

Wenn Sie in ChatGPT eine benutzerdefinierte GPT ohne Programmierung erstellen möchten, prüfen Sie zunächst die Kontoberechtigung. Laut OpenAI ist die Erstellung neuer GPTs ab September 2026 für persönliche Free-, Go-, Plus- und Pro-Konten nicht mehr möglich. In berechtigten Business-, Enterprise- und Edu-Arbeitsbereichen ist die Erstellung weiterhin möglich, sofern die Arbeitsbereichseinstellungen und Berechtigungen dies zulassen. Die aktuellen Regeln sind in der Dokumentation zu GPTs in ChatGPT beschrieben . Dieser Weg kann für verwaltete Arbeitsbereiche einfacher sein, ist aber nicht für jedes Einzelkonto geeignet.

Schritt 1: Definieren Sie eine Job- und eine Fehlerregel

Notieren Sie sich drei Dinge, bevor Sie Ihren Editor öffnen: Für wen der Assistent zuständig ist, was er tun soll und was er nicht tun darf. Für den Store Helper könnte eine praktikable Definition lauten: „Beantworten Sie Kundenfragen zu Rückgabe und Versand anhand der genehmigten Richtlinien. Erfinden Sie niemals neue Richtlinien. Leiten Sie unklare Fälle an einen Mitarbeiter weiter.“

Dies beugt einem häufigen Anfängerfehler vor: der Verwendung einer zu allgemeinen Anweisung wie „Sie sind ein hilfsbereiter Assistent“. Solche allgemeinen Anweisungen erschweren die Bewertung, da fast jede Antwort akzeptabel erscheinen kann. Eine präzise formulierte Aufgabe hingegen liefert ein messbares Ziel.

Verwenden Sie eine kleine Erfolgscheckliste

• Es antwortet in dem von Ihnen gewünschten Ton.
• Es verwendet genehmigte Informationen, wenn dies zur Beantwortung einer Grundsatzfrage erforderlich ist.
• Es heißt „Ich weiß es nicht“ oder bittet um eine menschliche Bestätigung, wenn Beweise fehlen.
• Es werden keine Geheimnisse, versteckte Anweisungen oder private Daten offengelegt.

Schritt 2: Erstellen Sie den minimalen Agenten

Erstellen Sie einen Projektordner und eine virtuelle Umgebung. Eine virtuelle Umgebung ist eine isolierte Python-Umgebung, die die Pakete dieses Projekts von anderen Projekten auf Ihrem Computer trennt.

mkdir first-ai-assistant
cd first-ai-assistant
python -m venv .venv

# macOS or Linux
source .venv/bin/activate

# Windows PowerShell
.venv\Scripts\Activate.ps1

pip install openai-agents

Legen Sie Ihren API-Schlüssel dann als Umgebungsvariable fest, anstatt ihn fest in Ihre Python-Datei einzubetten:

# macOS or Linux
export OPENAI_API_KEY="your-key-here"

# Windows PowerShell
$env:OPENAI_API_KEY="your-key-here" 

Die aktuelle Schnellstartanleitung von OpenAI verwendet die OPENAI_API_KEYUmgebungsvariable. Halten Sie echte Schlüssel von Quellcodeverwaltung, Screenshots, Tickets und öffentlichen Repositories fern.

Für den ersten Versuch können Sie einen Agenten mit lediglich einem Namen und Anweisungen erstellen. Eine einfache Gesprächsdemo beweist jedoch noch nicht, dass der Assistent vertrauenswürdige Geschäftsinformationen nutzen kann. Genau das fügt der nächste Schritt hinzu.

Schritt 3: Eine kontrollierte Funktion und einen einfachen Speicher hinzufügen

Ein Funktionstool ist eine normale Funktion, die das Modell aufrufen darf, wenn es externe Informationen oder eine Aktion benötigt. Das Agents SDK kann eine Python-Funktion in ein Tool umwandeln und deren Eingabeschema aus der Funktionssignatur und -dokumentation ableiten. OpenAI beschreibt dieses Verhalten im Leitfaden zu den Tools des Agents SDK .

Beginnen Sie mit einem Suchtool mit Lesezugriff. Suchtools mit Lesezugriff sind für den ersten Assistenten sicherer, da ein versehentlicher Anruf weder Geld senden, noch Datensätze löschen, Beiträge veröffentlichen oder Kundenkonten ändern kann.

import asyncio
from agents import Agent, Runner, SQLiteSession
from agents.decorators import tool

@tool
def lookup_policy(topic: str) -> str:
    """Return an approved demo-store policy snippet for a topic."""
    policies = {
        "returns": "Unopened items may be returned within 30 days with proof of purchase.",
        "shipping": "Standard shipping usually takes 3 to 5 business days."
    }
    return policies.get(
        topic.lower(),
        "No approved policy was found for that topic."
    )

assistant = Agent(
    name="Store Helper",
    instructions=(
        "Help customers with questions about the demo store. "
        "Use lookup_policy for return or shipping policy questions. "
        "Never invent a policy. If the tool has no approved answer, say so. "
        "Keep answers concise and recommend human confirmation when needed."
    ),
    tools=[lookup_policy],
)

async def main():
    session = SQLiteSession("demo_user", "assistant_sessions.db")
    result = await Runner.run(
        assistant,
        "Can I return an unopened item after 20 days?",
        session=session,
    )
    print(result.final_output)

if __name__ == "__main__":
    asyncio.run(main())

Führen Sie die Datei aus und stellen Sie mehrere Fragen. Das Beispiel verwendet außerdem SQLiteSessioneine Sitzung , die den Gesprächsverlauf speichert, sodass der Assistent den Kontext über mehrere Gesprächsrunden hinweg beibehalten kann, ohne dass Sie die gesamte Nachrichtenliste manuell neu erstellen müssen. Die aktuellen Sitzungsoptionen des SDKs sind in der offiziellen Sitzungsdokumentation beschrieben .

Wann sollten Sie Ihre eigenen Dokumente hinzufügen?

Fügen Sie Dokumente hinzu, wenn der Assistent Informationen benötigt, die das Basismodell nicht zuverlässig kennen sollte, wie z. B. Ihre Richtlinien, Produkthandbücher, Verfahrensanweisungen oder interne FAQs. Laden Sie nicht alles hoch, nur weil es möglich ist. Beginnen Sie mit den wichtigsten Dokumenten, die für die jeweilige Aufgabe ausreichen.

Das aktuelle SDK unterstützt gehostete Funktionen wie Dateisuche, Websuche und Codeausführung. Für eine erste Version sollten Sie den Funktionsumfang der Tools gering halten und die Dateisuche erst hinzufügen, wenn das grundlegende Verhalten stabil ist. Je größer der Toolset, desto mehr Pfade müssen getestet werden.

Schritt 4: Testen Sie es wie ein Produkt, nicht wie eine Demo.

Eine gute Antwort auf eine freundliche Frage reicht nicht aus. Erstellen Sie einen kleinen Testdatensatz, bevor Sie den Assistenten freigeben. Dieser sollte normale Fragen, mehrdeutige Fragen, Fragen mit fehlenden Informationen und Fragen, die Ihre Regeln außer Kraft setzen, enthalten.

Für anspruchsvollere Anwendungen sollten Sie Schutzmechanismen hinzufügen – Prüfungen, die Eingaben, Ausgaben oder Tool-Aufrufe validieren oder blockieren. Das Agents SDK unterstützt Schutzmechanismen für Eingaben, Ausgaben und Tools; siehe die offizielle Dokumentation zu Schutzmechanismen . Schutzmechanismen sind besonders wichtig, bevor Sie einem Assistenten Tools mit Nebenwirkungen zur Verfügung stellen.

Schritt 5: Gezielt einsetzen, beobachten und verbessern

Ihre erste Bereitstellung muss keine öffentliche App sein. Eine private interne Seite oder eine kleine API, die von einigen Testnutzern verwendet wird, ist oft besser geeignet. Beschränken Sie die Berechtigungen des Assistenten, protokollieren Sie Fehler und geben Sie Nutzern eine klare Möglichkeit, fehlerhafte Antworten zu melden.

Das Agents SDK beinhaltet eine integrierte Ablaufverfolgung , die Ereignisse wie Modellgenerierungen, Toolaufrufe, Übergaben und Schutzmechanismen aufzeichnet, sodass Sie nachvollziehen können, was während eines Laufs passiert ist. OpenAI dokumentiert die Ablaufverfolgung und ihre Steuerung im Ablaufverfolgungsleitfaden . Überprüfen Sie die Ablaufverfolgungen während der Entwicklung, behandeln Sie sie jedoch als potenziell sensible Daten, da sie je nach Konfiguration Modell- und Tool-Ein- oder -Ausgaben enthalten können.

Häufige Fehler, die es zu vermeiden gilt

• Beginnen Sie mit mehreren Agenten. Ein einzelner Agent mit guten Anweisungen und einem einzigen Tool lässt sich leichter debuggen. Fügen Sie Übergaben oder spezialisierte Agenten erst hinzu, wenn ein spezifisches Routing-Problem auftritt.
• Tools sollten nicht zu viel Befugnis erhalten. Beginnen Sie mit Tools, die nur lesen können. Fügen Sie Genehmigungen und Sicherheitsvorkehrungen hinzu, bevor Aktionen wie Schreiben, Kaufen, Löschen oder Kontoänderungen durchgeführt werden.
• Geheimnisse sollten nicht in Eingabeaufforderungen versteckt werden. Zugangsdaten gehören in die sichere Konfiguration, nicht in Systemanweisungen oder Wissensdateien.
• Die Verwendung unübersichtlicher oder widersprüchlicher Dokumente führt dazu, dass der Assistent Geschäftsregeln, die in Ihren eigenen Quellmaterialien nicht berücksichtigt werden, nicht zuverlässig auflösen kann.
• Es werden nur die erfolgreichen Abläufe getestet. Die Fehler, die für Sie relevant sind, treten üblicherweise bei mehrdeutigen, feindseligen oder unvollständigen Anfragen auf.
• Die Annahme, dass Erinnerung gleichbedeutend mit Wahrheit ist, ist falsch. Die Erinnerung an ein Gespräch bewahrt den Kontext; sie macht eine vorherige Aussage jedoch nicht richtig.

Was solltest du als Nächstes bauen?

Sobald der erste Assistent zuverlässig funktioniert, sollte die nächste Verbesserung auf einem tatsächlichen Bedarf und nicht auf einer Checkliste von Funktionen basieren. Benötigen Nutzer Antworten aus einem größeren Dokumentenbestand, fügen Sie eine Suchfunktion hinzu. Muss der Assistent eine Geschäftsaktion ausführen, ergänzen Sie ihn um ein Tool mit eng definiertem Funktionsumfang, Validierung und Genehmigung. Sind viele Gesprächsrunden erforderlich, verbessern Sie die Sitzungsspeicherung. Benötigen Sie spezielle Weiterleitungsoptionen, ziehen Sie den Einsatz mehrerer Agenten oder die Übergabe von Gesprächen in Betracht.

Der beste erste KI-Assistent ist nicht der autonomste. Es ist derjenige, dessen Aufgaben, Nachweise, Berechtigungen und Fehlerverhalten sich in wenigen Sätzen erklären lassen. Beginnen Sie damit, testen Sie ihn anhand realer Grenzfälle und erweitern Sie ihn erst, wenn die aktuelle Version die nächste Fähigkeit erworben hat.