쿡북

복사하자마자 바로 도는 레시피.

각 레시피는 하나의 명확한 문제를 해결하고, 동작하는 코드를 보여 주며, 다음 단계를 안내합니다. 먼저 API 기초로 프리미티브를 다진 뒤, 그 위에 에이전트 루프와 본격적인 유스케이스를 쌓아 올리세요. Colab 노트북과 독립 실행형 Python 파일을 제공합니다.

GitHub에서 보기 →공식 쿡북 사이트

Muse Code 레시피

에이전트 패턴

Muse Code를 최대한 활용하는 핵심 패턴을 론칭 자료에서 그대로 담았습니다.

>
에이전트 팬아웃
큰 작업 하나를 여러 서브에이전트에 나눠 맡기고 각자 전용 워크트리에서 작업하게 합니다. 진행 중에 충돌할 일이 없고 작업 사본은 깨끗하게 유지됩니다.
>
기본 제공 스킬
거친 아이디어를 넣으면 꼼꼼히 다듬고 검증을 거친 기능이 나옵니다 — 내장된 /plan, /grill, /goal 플레이북이 일을 해냅니다.
>
목표 추적
목표를 정해 두면 Muse Code가 에이전트를 태스크에 집중시키므로, 처음 원했던 것이 그대로 머지됩니다.

API 기초

레시피 10개

각 API 프리미티브의 동작을 확인하고, 이어서 쌓아 올릴 출발점을 마련합니다.

01퀵스타트: 챗 컴플리션OpenAI SDK의 base URL 하나만 바꿔 첫 Muse Spark 호출을 실행합니다.02스트리밍 응답생성되는 대로 토큰을 렌더링하고 마지막 usage 청크를 읽습니다.03도구·함수 호출도구 호출을 감지하고 실행 후 결과를 되돌려 주는 루프를 돌립니다.04구조화 출력스키마가 보장하는, 한 번에 파싱되는 JSON을 얻습니다.05프롬프트 캐싱안정적인 프롬프트 프리픽스를 재사용하고 캐시된 토큰을 추적합니다.06추론과 사고 토큰추론 강도를 제어하고 턴을 넘어 추론을 이어 갑니다.07비전 입력URL 또는 base64로 이미지를 보내 구조화된 분석 결과를 받습니다.08롱 컨텍스트저장소 규모의 컨텍스트를 100만 토큰 컨텍스트 윈도에 담습니다.09오류 처리와 재시도지터를 섞어 백오프하고 클라이언트 오류는 재시도하지 않습니다.10검색 그라운딩실시간 웹 검색 결과와 인라인 인용으로 응답을 그라운딩합니다.

에이전트 패턴

레시피 5개

모델을 에이전트로 바꾸는 루프를 만듭니다: 계획, 병렬 작업, 자기 수정.

01기본 에이전트 루프핵심이 되는 지각-결정-행동 에이전트 루프를 구성합니다.02인터리브 추론한 턴 안에서 추론과 도구 호출을 번갈아 수행합니다.03멀티턴 컨텍스트 관리긴 에이전트 실행 동안 불어나는 컨텍스트를 관리합니다.04검증 포함 제자리 편집코딩 에이전트로 검증을 거친 검색-치환 편집을 수행합니다.05알림 피로 코파일럿노이즈 많은 알림 피드에서 근거 있는 패턴을 추출한 뒤, 엄격한 JSON 출력으로 탐색·대화·자체 평가를 진행합니다.

유스케이스

레시피 13개

엔드투엔드 패턴: 멀티모달 지각, 오케스트레이션, 완성형 애플리케이션.

01차트 분석차트를 읽고 이미지에서 구조화 데이터를 추출합니다.02오류 스크린샷 수정오류 스크린샷으로 버그를 진단하고 수정합니다.03OpenClaw 스마트 글라스Ray-Ban Meta 글라스에서 핸즈프리로 보고 바로 묻습니다.04슬라이드 생성프롬프트나 원본 콘텐츠에서 슬라이드 덱을 생성합니다.05브라우저 검증 웹 디자인실제 브라우저에서 자기 결과물을 직접 확인하는 코딩 에이전트로 웹사이트를 만듭니다.06반복형 게임 개발코딩 에이전트로 브라우저 게임을 엔드투엔드로 만들고 실제 브라우저에서 검증합니다.07샌드박스 실행모델이 생성한 코드를 샌드박스에서 실행합니다.08멀티 에이전트 프로덕트 스튜디오공유 칸반 보드로 협업하는 4인 구성 팀(PM, 백엔드, 프런트엔드, 테크니컬 라이터)을 오케스트레이션합니다.09원샷 게임 개발AGENTS.md와 구조화 프롬프트 하나만으로, 반복 루프 없이 완전한 3D 브라우저 게임을 한 번에 만듭니다.10지각 그라운딩냉장고 사진에서 음식을 식별하고 픽셀 좌표에 인터랙티브 건강 점수 도트를 표시합니다.11GitHub 저장소 에이전트자율 GitHub Actions 봇 — 트리아지, PR 리뷰, AI 양산 콘텐츠 감지, 버그 수정 PR — 을 OpenCode + Muse Spark로 구동합니다.12컴퓨터 사용스크린샷만으로 Linux 데스크톱을 조작합니다 — 에이전트가 Cua 샌드박스에서 앱을 찾아 열고 플레이합니다.13macOS 컴퓨터 사용네이티브 Swift + Python 컴퓨터 사용 에이전트 metacua로 스크린샷만 보고 실제 Mac을 조작합니다.

모든 레시피에 필요한 건 key 하나뿐.

dev.meta.ai에서 Model API 계정을 만들고 API key를 생성해 MODEL_API_KEY로 내보내세요. API는 OpenAI SDK와 드롭인 호환됩니다 — 문서의 퀵스타트 스니펫을 참고하세요.

문서 읽기