에이전트의 토큰을 쓰지 않고 검토하세요.
이 반복 과정에서는 서로 다른 두 가지가 저렴하게 유지됩니다. 에이전트가 도구를 호출하고 돌려받는 것, 그리고 결과가 제대로 나왔는지 확인하는 데 드는 것입니다.
도구 호출은 렌더링된 페이지가 아니라 작은 JSON 객체를 돌려주고, 렌더링된 페이지는 사람이 MarsDawn에서 검토합니다. 에이전트의 컨텍스트로 다시 읽어 들이는 일은 없습니다.
도구 호출 자체가 저렴합니다
marsdawn export를 CLI, 스킬, MCP 서버 중 어디서든 호출하면 돌아오는 것은 간결한 JSON 객체입니다. ok, output, pages, theme, paper, diagramErrors. 전체 스키마는 export.v1.json입니다. 이 중 어느 것도 렌더링된 문서가 아닙니다. Mermaid 다이어그램이 열두 개 들어 있는 50페이지짜리 PDF도 한 페이지짜리 메모와 똑같은 몇 개의 필드만 돌려줍니다.
검토는 옆에서 이루어집니다
PDF가 만들어지면 사람이 MarsDawn이나 아무 PDF 뷰어에서 열어 렌더링된 다이어그램, 수식, 레이아웃을 읽습니다. 제대로 나왔는지 확인하려고 에이전트가 렌더링 결과를 자신의 컨텍스트 윈도우로 다시 읽어 들일 필요는 전혀 없습니다. 검토는 다이어그램이 어떻게 생겼는지 설명하느라 토큰을 한 번 더 주고받는 방식이 아니라, 별도의 윈도우와 별도의 화면에서 이루어집니다.
이렇게 하면 피할 수 있는 것
- 내보내기가 잘 됐는지 에이전트가 확인하게 하려고 렌더링된 Markdown, 스크린샷, 또는 그 설명을 대화에 다시 붙여 넣는 일.
- 사람이 그냥 보면 될 것을, Mermaid 다이어그램이나 KaTeX 수식이 어떻게 렌더링되는지 에이전트가 재구성해야 하는 일.
- 첫 번째 호출이 이미 성공을 알렸는데도 PDF 내용을 가져오려고 도구를 한 번 더 호출하는 일.
다음
- marsdawn을 호출하는 세 가지 방법, CLI, 스킬 파일, MCP 서버: 세 가지 입구.
- JSON 결과의 모든 필드: 에이전트를 위한 marsdawn.
- 에이전트가 쓴 글을 여전히 사람이 읽어야 하는 이유: 검토가 필요한 이유.
- 에이전트의 결과를 읽어야 하는 이유를 더 자세히, 체크리스트와 함께: 에이전트가 돌려준 결과 읽기.