사전 요구 사항
- Node.js 22.18 이상
- Venice API 키
Mastra 프로젝트 생성
.env 파일에 Venice API 키를 추가하세요:
Venice로 구동되는 에이전트 생성
에이전트를 생성하고 모델 구성을 Venice API로 지정하세요:id의 첫 번째 세그먼트는 Mastra의 라우팅 레이블입니다. Mastra는 나머지 모델 ID인 venice-uncensored를 Venice로 전송합니다.
url은 위에 표시된 기본 API URL로 설정하세요. /chat/completions를 덧붙이지 마세요. Mastra가 해당 경로를 추가합니다.응답 생성
등록된 에이전트를 가져와generate()를 호출하세요:
응답 스트리밍
출력이 도착하는 대로 표시하려면stream()을 사용하세요:
도구 추가
Mastra 도구는 Zod 스키마를 사용해 입력과 출력을 검증합니다. 에이전트에 도구를 연결할 때는 함수 호출을 지원하는 Venice 모델을 사용하세요.구조화된 출력 생성
검증된 데이터를 받으려면 Zod 스키마를structuredOutput으로 전달하세요:
structuredOutput 내에서 jsonPromptInjection: true로 설정하여 Mastra가 대신 프롬프트에 스키마를 추가하도록 하세요.
모델 변경
다른 Venice 텍스트 모델을 사용하려면venice/ 라우팅 접두사를 유지하고 나머지 모델 ID를 교체하세요:
문제 해결
API가 모델이 존재하지 않는다고 보고합니다
API가 모델이 존재하지 않는다고 보고합니다
모델 페이지에 표시된 정확한 모델 ID를 사용하세요. Mastra에서는 예를 들어
venice/venice-uncensored처럼 venice/ 접두사를 붙이세요.요청이 404 Not Found를 반환합니다
요청이 404 Not Found를 반환합니다
모델 URL을
https://api.venice.ai/api/v1로 설정하세요. 전체 /chat/completions endpoint는 사용하지 마세요.에이전트가 도구를 호출하지 않습니다
에이전트가 도구를 호출하지 않습니다
함수 호출을 지원하는 모델을 선택하고, 에이전트가 언제 도구를 사용해야 하는지 instructions에 설명한 뒤,
createTool()로 도구를 정의하세요.Mastra 문서
Mastra 에이전트, 도구, 워크플로에 대해 자세히 알아보기
Venice 모델
모델과 지원되는 기능 둘러보기