Skip to main content
Mastra è un framework TypeScript per creare agenti AI, tool e workflow. Collegalo a Venice configurando un endpoint modello personalizzato compatibile con OpenAI.

Prerequisiti

Creare un progetto Mastra

Aggiungi la tua Venice API key al file .env del progetto generato:
Mantieni .env fuori dal controllo di versione. Non esporre la tua Venice API key in codice lato browser.

Creare un agente alimentato da Venice

Crea un agente e punta la configurazione del suo modello all’API Venice:
Il primo segmento di 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.
Registra l’agente nella tua istanza Mastra:
Avvia il server di sviluppo e apri l’URL mostrato nel terminale per testare l’agente in Mastra Studio:

Generare una risposta

Recupera l’agente registrato e chiama generate():

Streaming di una risposta

Usa stream() 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.
Collega il tool a un agente:

Generare output strutturato

Passa uno schema Zod tramite structuredOutput per ricevere dati validati:
Se il modello selezionato non supporta la modalità di output strutturato dell’API, imposta 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 routing venice/ e sostituisci il resto dell’ID del modello:
Sfoglia i modelli Venice disponibili e verifica le loro capacità prima di sceglierne uno per tool calling, vision o output strutturato.

Risoluzione dei problemi

Verifica che VENICE_API_KEY sia presente nell’ambiente in cui Mastra viene eseguito, poi riavvia il server di sviluppo dopo aver modificato .env.
Usa l’ID modello esatto mostrato nella pagina dei modelli. In Mastra, prefissalo con venice/, ad esempio venice/venice-uncensored.
Imposta l’URL del modello su https://api.venice.ai/api/v1. Non usare l’endpoint completo /chat/completions.
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