로컬 마이크로 가든 및 서리 날짜 자문가 에이전트 소개
요약
개발자가 외부 API나 클라우드 의존성 없이 Mac 환경에서 100% 로컬로 실행할 수 있는 대화형 CLI 에이전트를 소개합니다. 이 'Local Micro-Garden & Frost Date Advisor Agent'는 지역별 서리 한계 분석, 작물 추천, 그리고 야외 활동 계획을 생성하는 기능을 제공합니다.
핵심 포인트
- 외부 API 없이 Mac에서 100% 로컬 실행 가능
- Mastra 프레임워크와 Ollama를 활용한 에이전트 구현
- 서리 데이터 및 가든 계획 생성을 위한 도구(Tool) 사용
- TypeScript와 Zod로 타입 안정성 확보
🌿 개요: AI를 야외로 가져오기 ("Touch Grass")
개발자들은 화면에 붙어 코드를 디버깅하는 데 엄청난 시간을 보냅니다. Hacktoberfest Open-Source AI Challenge의 'Touch Grass' 테마에 맞춰 1주차 동안, 저는 Local Micro-Garden & Frost Date Advisor Agent를 만들었습니다.
이 대화형 CLI 에이전트는 지역별 서리 한계(frost limits)를 평가하고, 추위에 강한 작물을 식별하며, 사용자가 흙을 만지며 야외에서 보내고 싶은 시간만큼 실행 가능한 실내 과제 목록을 생성합니다.
🛠️ 기술 스택 및 로컬 설정
이 에이전트는 외부 API 종속성이나 클라우드 키 제한 없이 Mac에서 100% 로컬로 실행됩니다:
- 프레임워크: 에이전트 오케스트레이션 및 도구 실행을 위해 Mastra (
@mastra/core) 사용. - LLM 엔진: 네이티브 도구 호출 지원과 함께 Ollama를 통해 로컬
llama3.1모델 구동. - 타입 안정성 및 검증: 엄격한 도구 입력/출력 스키마 강제를 위해 Zod 사용.
- 런타임: Node.js + TypeScript (
tsx).
💡 아키텍처 및 도구
이 에이전트는 두 개의 Mastra 도구를 조정하여 가든 계획을 수립합니다:
getFrostDataTool: 역사적 서리 날짜를 분석하고 추운 날씨 작물(예: 시금치, 마늘, 케일, 겨울 양배추)을 추천합니다.generatePlanTool: 사용자가 목표로 하는 야외 시간을 흙 준비, 멀칭, 서리막 설치 등을 포함하는 단계별 체크리스트로 변환합니다.
🤖 로컬 에이전트 정의 (src/agent.ts)
typingscript
import { Agent } from '@mastra/core/agent';
...
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기