Passer au contenu principal
Mastra est un framework TypeScript pour construire des agents, des outils et des workflows IA. Connectez-le à Venice en configurant un endpoint de modèle personnalisé compatible OpenAI.

Prérequis

Créer un projet Mastra

Ajoutez votre clé API Venice au fichier .env du projet généré :
Ne versionnez pas .env dans le gestionnaire de sources. N’exposez pas votre clé API Venice dans du code côté navigateur.

Créer un agent propulsé par Venice

Créez un agent et pointez sa configuration de modèle vers l’API Venice :
Le premier segment de id est le libellé de routage de Mastra. Mastra envoie le reste de l’identifiant de modèle, venice-uncensored, à Venice.
Définissez url sur l’URL de base de l’API indiquée ci-dessus. N’y ajoutez pas /chat/completions ; Mastra ajoute ce chemin.
Enregistrez l’agent dans votre instance Mastra :
Démarrez le serveur de développement et ouvrez l’URL affichée dans votre terminal pour tester l’agent dans Mastra Studio :

Générer une réponse

Récupérez l’agent enregistré et appelez generate() :

Streamer une réponse

Utilisez stream() lorsque vous souhaitez afficher la sortie au fur et à mesure de son arrivée :

Ajouter des outils

Les outils Mastra utilisent des schémas Zod pour valider leurs entrées et sorties. Utilisez un modèle Venice qui prend en charge le function calling lorsque vous attachez des outils à un agent.
Attachez l’outil à un agent :

Générer une sortie structurée

Passez un schéma Zod via structuredOutput pour recevoir des données validées :
Si le modèle sélectionné ne prend pas en charge le mode de sortie structurée de l’API, définissez jsonPromptInjection: true dans structuredOutput pour que Mastra ajoute le schéma au prompt à la place.

Changer de modèle

Pour utiliser un autre modèle de texte Venice, conservez le préfixe de routage venice/ et remplacez le reste de l’identifiant de modèle :
Parcourez les modèles Venice disponibles et vérifiez leurs capacités avant d’en choisir un pour le tool calling, la vision ou la sortie structurée.

Dépannage

Vérifiez que VENICE_API_KEY est présente dans l’environnement où Mastra s’exécute, puis redémarrez le serveur de développement après avoir modifié .env.
Utilisez l’identifiant de modèle exact affiché sur la page des modèles. Dans Mastra, préfixez-le avec venice/, par exemple venice/venice-uncensored.
Définissez l’URL du modèle sur https://api.venice.ai/api/v1. N’utilisez pas l’endpoint complet /chat/completions.
Choisissez un modèle qui prend en charge le function calling, décrivez dans ses instructions quand l’agent doit utiliser l’outil, et définissez l’outil avec createTool().

Documentation Mastra

En savoir plus sur les agents, les outils et les workflows Mastra

Modèles Venice

Parcourir les modèles et les capacités prises en charge