공식 문서 대조표
eve.dev 공식 문서 전체를 주제별로 매핑하고 핸드북에 반영한 보정 사항을 기록한다.
핵심 요약
- 이 부록은 2026-06-18 기준 공식 sitemap의
/docs/*67개 Markdown 문서를 전수 대조한 링크 지도입니다. - 공식 문서에서 확인한 최신 보정 사항은
agent.ts, route auth, channel integration, client/frontend, eval CLI, responsible use에 반영했습니다. - Eve는 아직 Beta라서, 이 링크 지도도 릴리스가 바뀔 때마다 다시 맞춰봐야 하는 기준선입니다.
대조 방식
공식 사이트는 각 페이지에 Markdown alternate를 제공합니다. 이 부록은 https://eve.dev/docs/<path>.md 원문을 기준으로 읽고, 문서 구조는 sitemap.xml로 확인했습니다.
공식 문서는 계속 바뀌니 이 표는 어디까지나 "현재 기준선"입니다. Eve 릴리스가 새로 나오거나 eve.dev/docs 구조가 바뀌면 이 부록부터 손봅니다.
핵심 보정 사항
| 보정 | 핸드북 반영 위치 |
|---|---|
| Eve 공식 사이트의 Beta 표시와 deployer 책임 | index, Ch15 |
root agent.ts 생략 가능하지만 작성 시 model 필수 | Ch5 |
scaffold placeholderAuth()와 framework default auth 차이 | Ch9 |
| 공식 channel adapter별 delivery/HITL/auth 표면 | Ch9 |
useEveAgent, session cursor, clientContext, framework integration | Ch9 |
eve eval 실행 옵션, artifact, target/reporter/judge 분리 | Ch12 |
시작과 기본 작성 표면
| 문서 | 핸드북에서 읽는 위치 |
|---|---|
| Introduction | Ch1, index |
| Getting Started | Ch3, Ch5 |
| agent.ts | Ch5 |
| Instructions | Ch6 |
| Tools | Ch7 |
| Human-in-the-loop | Ch7 |
| Skills | Ch6 |
| Connections | Ch7 |
| Sandbox | Ch8 |
| Schedules | Ch11 |
| Subagents | Ch10 |
| Responsible Use | Ch15 |
Concepts
| 문서 | 핸드북에서 읽는 위치 |
|---|---|
| Context Control | Ch6 |
| The Harness | Ch4, Ch7, Ch8 |
| Execution Model and Durability | Ch1, Ch13 |
| Security Model | Ch8, Ch15 |
| Sessions, Runs & Streaming | Ch9 |
Channels
| 문서 | 핸드북에서 읽는 위치 |
|---|---|
| Overview | Ch9 |
| eve | Ch9 |
| Custom Channels | Ch9 |
| Slack | Ch9, Ch14 |
| Discord | Ch9 |
| GitHub | Ch9, Ch14 |
| Linear | Ch9, Ch14 |
| Microsoft Teams | Ch9 |
| Telegram | Ch9 |
| Twilio | Ch9 |
운영 Guides
| 문서 | 핸드북에서 읽는 위치 |
|---|---|
| Auth & Route Protection | Ch9, Ch15 |
| Deployment | Ch13 |
| Dev TUI | Ch13 |
| Dynamic Capabilities | Ch6 |
| Dynamic Workflows | Ch10 |
| Hooks | Ch11 |
| instrumentation.ts | Ch13 |
| Remote Agents | Ch10 |
| Session Context | Ch11 |
| State | Ch11 |
Evals
| 문서 | 핸드북에서 읽는 위치 |
|---|---|
| Overview | Ch12 |
| Assertions | Ch12 |
| Cases | Ch12 |
| Judge | Ch12 |
| Reporters | Ch12 |
| Running Evals | Ch12 |
| Targets | Ch12 |
Client와 Frontend
| 문서 | 핸드북에서 읽는 위치 |
|---|---|
| TypeScript SDK Overview | Ch9 |
| Messages | Ch9 |
| Continuations | Ch9 |
| Streaming | Ch9 |
| Output Schema | Ch5, Ch9 |
| Frontend Overview | Ch9 |
| Next.js | Ch9, Ch13 |
| Nuxt | Ch9, Ch13 |
| SvelteKit | Ch9, Ch13 |
| useEveAgent (Svelte) | Ch9 |
| useEveAgent (Vue) | Ch9 |
Reference
| 문서 | 핸드북에서 읽는 위치 |
|---|---|
| CLI | Ch12, Ch13 |
| Project Layout | Ch3 |
| TypeScript API | Ch2, Ch5, Ch7 |
Tutorial
공식 tutorial은 분석 에이전트를 한 단계씩 만들어 보는 실습 흐름입니다. 이 핸드북은 튜토리얼을 그대로 따라가지 않고, 각 단계가 엔터프라이즈 운영 표면에서 무슨 의미인지로 다시 풉니다.
| 문서 | 핸드북에서 읽는 위치 |
|---|---|
| Your First Agent | Ch3, Ch5 |
| How It Runs | Ch1 |
| Query Sample Data | Ch7 |
| Connect a Warehouse | Ch7 |
| Run Analysis | Ch8, Ch14 |
| Remember Definitions | Ch11 |
| Team Playbooks | Ch6 |
| Guard the Spend | Ch7, Ch12 |
| Ship It | Ch9, Ch13 |
유지보수 규칙
| 상황 | 해야 할 일 |
|---|---|
| Eve package version upgrade | local source의 packages/eve/docs와 공식 eve.dev/docs를 다시 비교 |
| 공식 sitemap 변경 | 이 부록의 링크 수와 meta page를 갱신 |
| auth/channel 문서 변경 | Ch9와 Ch15의 fail-closed/session ownership 기준 재검토 |
| eval CLI 변경 | Ch12의 CI 명령과 artifact 정책 재검토 |
| sandbox/backend 변경 | Ch8과 Ch13의 backend/network/credential 기준 재검토 |