쉬운 설명
AI 코딩을 공부하다 보면 '컨텍스트', '토큰', '하니스' 같은 낯선 용어들 때문에 시작하기도 전에 겁먹기 쉬운데요. 사실 이 단어들은 핵심 개념 몇 가지만 제대로 이해하면 전혀 어렵지 않답니다. 개발자 교육자인 맷 포콕(Matt Pocock)이 만든 'AI Coding Dictionary'라는 용어 사전이 있는데요, 마치 외국어 여행 회화집처럼 AI 코딩에서 자주 쓰는 표현들을 아주 쉬운 문장으로 풀어내고 있어요. 예를 들어 '모델'은 단순히 다음에 올 단어를 예측하는 계산기 같은 것이고, '하니스'는 그 계산기에 도구와 규칙을 붙여서 실제로 일을 시키는 틀이라고 이해하면 돼요. 이렇게 개념들을 일상적인 비유로 하나씩 깨치고 나면, AI가 왜 갑자기 엉뚱한 대답을 하는지, 왜 요금이 생각보다 많이 나오는치도 훨씬 쉽게 이해할 수 있답니다.
요약
이번에 소개해 드릴 자료는 바로 'AI Coding Dictionary'라는 오픈소스 용어 사전이에요. 타입스크립트(TypeScript) 교육으로 유명한 맷 포콕이 만들었는데요, 깃허브(GitHub) 저장소에 있는 마크다운 파일들을 모아 리드미(README) 파일이 자동으로 생성되도록 설계되어 있습니다. 저자는 AI 코딩이 언뜻 전문가들만 하는 어려운 일처럼 보이지만 사실은 전혀 그렇지 않다고 강조해요. 기본 용어들은 반나절에서 하루 정도만 집중해서 보면 누구나 쉽게 익힐 수 있다고 말이죠. 무엇보다 이 용어들을 제대로 알고 나면, AI가 대화 맥락을 놓치는 현상, 비용이 갑자기 많이 나오는 이유, 같은 질문을 했는데도 매번 답이 다르게 나오는 이유 등이 더 이상 '알 수 없는 수수께끼'가 아니라 과학적인 원리로 명확하게 이해된다는 점이 이 사전의 핵심이에요.
이 사전이 정말 매력적인 이유는 단순히 단어 뜻만 늘어놓지 않았다는 점이에요. '모델', '토큰', '컨텍스트 윈도우', '에이전트', '하니스' 같은 개념들이 서로 어떻게 연결되어 있고 왜 그렇게 움직이는지 흐름을 짚어 주거든요. 예를 들면, '모델' 자체는 상태를 기억하지 못하고(stateless) 그저 다음에 올 단어(토큰)를 예측할 뿐이지만, '에이전트'는 여기에 도구, 시스템 프롬프트, 컨텍스트 윈도우를 더해 사용자와 대화(turn)를 주고받을 수 있게 만든 형태라는 식으로 개념 간의 관계를 아주 깔끔하게 정리해 줍니다. 코딩을 가르치는 강사님들이라면 이 구조화된 설명을 그대로 가져다 수업 자료로 써도 좋을 만큼 훌륭하게 정리되어 있답니다.
강의용 팁
첫 강의 시간에 사전에서 다루는 핵심 용어 10가지(모델, 토큰, 컨텍스트 윈도우, 하니스, 에이전트, 세션, 턴, 인퍼런스, 프롬프트 캐싱, 온도) 정도를 뽑아 화이트보드에 관계도를 그려보시는 걸 추천해 드려요. "모델은 하니스 안에서 작동하고, 하니스는 모델을 향한 여러 요청을 묶어서 마치 사람 같은 에이전트처럼 보이게 만든다"는 식으로 전체적인 구조와 흐름을 먼저 짚어주면, 학생들이 머릿속으로 큰 그림을 그리기가 훨씬 수월해집니다.
실습 시간에는 "왜 똑같은 프롬프트를 넣었는데 매번 답이 다르게 나올까요?"라는 질문을 먼저 던져보세요. 학생들이 직접 온도(temperature)나 비결정성(non-determinism) 같은 개념을 찾아보도록 유도하는 거죠. 이렇게 평소에 가졌던 궁금증과 용어를 직접 매칭하며 학습하면, 억지로 외우지 않아도 "아, 그래서 그랬구나!" 하고 자연스럽게 이해하게 되어 기억에도 훨씬 오래 남는답니다.
주의 사항
이 사전은 특정 시점의 모델과 서비스(예: 클로드 오푸스, GPT 계열 등)를 예시로 들고 있어서, 시간이 지나면 최신 모델의 이름이나 구체적인 가격 정책 등 세부 정보는 달라질 수 있다는 점을 염두에 두셔야 해요. 아울러 영어 원문으로 작성된 자료이다 보니, 한국어 번역본이나 국내 커뮤니티의 요약 글을 읽을 때는 간혹 미묘한 뉘앙스 차이가 생길 수 있어요. 따라서 아주 중요한 핵심 개념들은 되도록 원문 저장소나 공식 사이트를 직접 방문해 더블 체크해보시는 것을 추천합니다.
자체 검증
실제 원문 자료들과 대조해 보니, 이 사전이 맷 포콕에 의해 제작되었으며 깃허브 저장소의 dictionary 폴더 안의 마크다운 파일들을 바탕으로 리드미(README)가 자동 생성된다는 점은 정확히 일치하는 사실이에요. "기본 용어는 하루 만에 익힐 수 있다"는 설명 역시 깃허브 소개글에 적힌 'learnable in an afternoon'의 취지와 잘 맞닿아 있습니다. 다만 '오후 한때(afternoon)'라는 원래 표현은 하루 전체보다 조금 더 짧은 시간인 만큼, 왜곡 없이 정확하게 전달하기 위해 '반나절에서 하루 정도'로 다듬어 표현했습니다. 그 외에 모델, 토큰, 하니스, 에이전트 같은 핵심 개념들의 정의는 aihero.dev에 나와 있는 영어 설명과 정확하게 일치하며, 원문에 없는 내용을 임의로 추가하지 않고 그대로 충실하게 반영했습니다.
태그
#AI #AI코딩 #프롬프트엔지니어링 #LLM #교육 #개발자교육 #용어사전
원문
https://discuss.pytorch.kr/t/ai-coding-dictionary-ai/10751
https://www.aihero.dev/ai-coding-dictionary
https://github.com/mattpocock/dictionary-of-ai-coding
참고자료
AI Coding Dictionary (공식 웹사이트)
GitHub - mattpocock/dictionary-of-ai-coding