Requisitos previos
- Node.js 22.18 o posterior
- Una clave de API de Venice
Crear un proyecto de Mastra
.env del proyecto generado:
Crear un agente impulsado por Venice
Crea un agente y apunta la configuración de su modelo a la API de Venice:id es la etiqueta de enrutamiento de Mastra. Mastra envía el ID de modelo restante, venice-uncensored, a Venice.
Configura
url con la URL base de la API mostrada arriba. No agregues /chat/completions; Mastra añade esa ruta.Generar una respuesta
Obtén el agente registrado y llama agenerate():
Transmitir una respuesta
Usastream() cuando quieras mostrar la salida a medida que llega:
Agregar herramientas
Las herramientas de Mastra usan esquemas de Zod para validar sus entradas y salidas. Usa un modelo de Venice que admita function calling al adjuntar herramientas a un agente.Generar salida estructurada
Pasa un esquema de Zod a través destructuredOutput para recibir datos validados:
jsonPromptInjection: true dentro de structuredOutput para que Mastra agregue el esquema al prompt en su lugar.
Cambiar de modelo
Para usar otro modelo de texto de Venice, mantén el prefijo de enrutamientovenice/ y reemplaza el ID de modelo restante:
Solución de problemas
La API informa que el modelo no existe
La API informa que el modelo no existe
Usa el ID de modelo exacto que se muestra en la página de modelos. En Mastra, agrégale el prefijo
venice/, por ejemplo venice/venice-uncensored.Las solicitudes devuelven 404 Not Found
Las solicitudes devuelven 404 Not Found
Configura la URL del modelo como
https://api.venice.ai/api/v1. No uses el endpoint completo /chat/completions.El agente no llama a su herramienta
El agente no llama a su herramienta
Elige un modelo que admita function calling, describe en las instrucciones cuándo debe usar la herramienta el agente, y define la herramienta con
createTool().Documentación de Mastra
Aprende más sobre los agentes, herramientas y flujos de trabajo de Mastra
Modelos de Venice
Explora los modelos y sus capacidades admitidas