Voraussetzungen
- Node.js 22.18 oder neuer
- Ein Venice-API-Schlüssel
Mastra-Projekt erstellen
.env-Datei des generierten Projekts ein:
Einen von Venice angetriebenen Agenten erstellen
Erstelle einen Agenten und richte seine Modellkonfiguration auf die Venice-API aus: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.Eine Antwort generieren
Rufe den registrierten Agenten ab und rufegenerate() auf:
Eine Antwort streamen
Verwendestream(), 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.Strukturierte Ausgabe generieren
Übergib ein Zod-Schema überstructuredOutput, um validierte Daten zu erhalten:
jsonPromptInjection: true innerhalb von structuredOutput, damit Mastra das Schema stattdessen dem Prompt hinzufügt.
Modelle wechseln
Um ein anderes Venice-Textmodell zu verwenden, behalte dasvenice/-Routing-Präfix bei und ersetze die verbleibende Modell-ID:
Fehlerbehebung
Die API meldet, dass das Modell nicht existiert
Die API meldet, dass das Modell nicht existiert
Verwende die exakte Modell-ID, die auf der Modelle-Seite angezeigt wird. Stelle ihr in Mastra
venice/ voran, zum Beispiel venice/venice-uncensored.Anfragen liefern 404 Not Found
Anfragen liefern 404 Not Found
Setze die Modell-URL auf
https://api.venice.ai/api/v1. Verwende nicht den vollständigen /chat/completions-Endpoint.Der Agent ruft sein Tool nicht auf
Der Agent ruft sein Tool nicht auf
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