Prerequisiti
- Node.js 22.18 o successivo
- Una Venice API key
Creare un progetto Mastra
.env del progetto generato:
Creare un agente alimentato da Venice
Crea un agente e punta la configurazione del suo modello all’API Venice:id è l’etichetta di routing di Mastra. Mastra invia il resto dell’ID del modello, venice-uncensored, a Venice.
Imposta
url sull’URL base dell’API mostrato sopra. Non aggiungere /chat/completions; Mastra aggiunge quel percorso.Generare una risposta
Recupera l’agente registrato e chiamagenerate():
Streaming di una risposta
Usastream() quando vuoi visualizzare l’output man mano che arriva:
Aggiungere tool
I tool di Mastra usano schemi Zod per validare i loro input e output. Usa un modello Venice che supporti il function calling quando colleghi tool a un agente.Generare output strutturato
Passa uno schema Zod tramitestructuredOutput per ricevere dati validati:
jsonPromptInjection: true all’interno di structuredOutput per fare in modo che Mastra aggiunga lo schema al prompt.
Cambiare modello
Per usare un altro modello di testo Venice, mantieni il prefisso di routingvenice/ e sostituisci il resto dell’ID del modello:
Risoluzione dei problemi
L'API segnala che il modello non esiste
L'API segnala che il modello non esiste
Usa l’ID modello esatto mostrato nella pagina dei modelli. In Mastra, prefissalo con
venice/, ad esempio venice/venice-uncensored.Le richieste restituiscono 404 Not Found
Le richieste restituiscono 404 Not Found
Imposta l’URL del modello su
https://api.venice.ai/api/v1. Non usare l’endpoint completo /chat/completions.L'agente non chiama il suo tool
L'agente non chiama il suo tool
Scegli un modello che supporti il function calling, descrivi nelle istruzioni quando l’agente deve usare il tool e definisci il tool con
createTool().Documentazione Mastra
Scopri di più su agenti, tool e workflow di Mastra
Modelli Venice
Sfoglia i modelli e le capacità supportate