Skip to main content
Mastra ist ein TypeScript-Framework zum Bauen von KI-Agenten, Tools und Workflows. Verbinde es mit Venice, indem du einen benutzerdefinierten, OpenAI-kompatiblen Modell-Endpoint konfigurierst.

Voraussetzungen

Mastra-Projekt erstellen

Füge deinen Venice-API-Schlüssel in die .env-Datei des generierten Projekts ein:
Halte .env aus der Versionsverwaltung heraus. Gib deinen Venice-API-Schlüssel nicht in browserseitigem Code preis.

Einen von Venice angetriebenen Agenten erstellen

Erstelle einen Agenten und richte seine Modellkonfiguration auf die Venice-API aus:
Das erste Segment von id ist das Routing-Label von Mastra. Mastra sendet die verbleibende Modell-ID, venice-uncensored, an Venice.
Setze url auf die oben gezeigte Basis-API-URL. Hänge nicht /chat/completions an; Mastra fügt diesen Pfad automatisch hinzu.
Registriere den Agenten in deiner Mastra-Instanz:
Starte den Entwicklungsserver und öffne die im Terminal angezeigte URL, um den Agenten in Mastra Studio zu testen:

Eine Antwort generieren

Rufe den registrierten Agenten ab und rufe generate() auf:

Eine Antwort streamen

Verwende stream(), wenn du die Ausgabe anzeigen möchtest, sobald sie eintrifft:

Tools hinzufügen

Mastra-Tools verwenden Zod-Schemas, um ihre Ein- und Ausgaben zu validieren. Verwende ein Venice-Modell, das Function Calling unterstützt, wenn du einem Agenten Tools zuweist.
Weise das Tool einem Agenten zu:

Strukturierte Ausgabe generieren

Übergib ein Zod-Schema über structuredOutput, um validierte Daten zu erhalten:
Wenn das ausgewählte Modell den Structured-Output-Modus der API nicht unterstützt, setze jsonPromptInjection: true innerhalb von structuredOutput, damit Mastra das Schema stattdessen dem Prompt hinzufügt.

Modelle wechseln

Um ein anderes Venice-Textmodell zu verwenden, behalte das venice/-Routing-Präfix bei und ersetze die verbleibende Modell-ID:
Durchsuche die verfügbaren Venice-Modelle und prüfe deren Fähigkeiten, bevor du eines für Tool Calling, Vision oder strukturierte Ausgaben auswählst.

Fehlerbehebung

Stelle sicher, dass VENICE_API_KEY in der Umgebung vorhanden ist, in der Mastra läuft, und starte den Entwicklungsserver nach Änderungen an .env neu.
Verwende die exakte Modell-ID, die auf der Modelle-Seite angezeigt wird. Stelle ihr in Mastra venice/ voran, zum Beispiel venice/venice-uncensored.
Setze die Modell-URL auf https://api.venice.ai/api/v1. Verwende nicht den vollständigen /chat/completions-Endpoint.
Wähle ein Modell, das Function Calling unterstützt, beschreibe in den Instruktionen, wann der Agent das Tool verwenden soll, und definiere das Tool mit createTool().

Mastra-Dokumentation

Erfahre mehr über Mastra-Agenten, Tools und Workflows

Venice-Modelle

Modelle und unterstützte Fähigkeiten durchsuchen