前置条件
- Node.js 22.18 或更高版本
- 一个 Venice API 密钥
创建 Mastra 项目
.env 文件中:
创建由 Venice 驱动的智能体
创建一个智能体,并将其模型配置指向 Venice API:id 的第一段是 Mastra 的路由标签。Mastra 会将剩余的模型 ID venice-uncensored 发送给 Venice。
将
url 设置为上面显示的基础 API 地址。不要附加 /chat/completions;Mastra 会自动添加该路径。生成响应
获取已注册的智能体并调用generate():
流式响应
当您想要在输出到达时逐步显示时,使用stream():
添加工具
Mastra 工具使用 Zod schema 来校验输入和输出。当为智能体附加工具时,请使用支持函数调用的 Venice 模型。生成结构化输出
通过structuredOutput 传入一个 Zod schema,即可获得已校验的数据:
structuredOutput 中设置 jsonPromptInjection: true,让 Mastra 改为将 schema 添加到提示词中。
更换模型
若要使用其他 Venice 文本模型,请保留venice/ 路由前缀,并替换剩余的模型 ID:
故障排查
API 报告该模型不存在
API 报告该模型不存在
请使用 模型页面 上显示的准确模型 ID。在 Mastra 中,为其加上
venice/ 前缀,例如 venice/venice-uncensored。请求返回 404 Not Found
请求返回 404 Not Found
将模型 URL 设置为
https://api.venice.ai/api/v1。不要使用完整的 /chat/completions 端点。智能体没有调用其工具
智能体没有调用其工具
选择支持函数调用的模型,在指令中说明智能体何时应使用该工具,并使用
createTool() 定义工具。Mastra 文档
了解更多关于 Mastra 智能体、工具和工作流的信息
Venice 模型
浏览模型及其支持的能力