소개

Juno

Crooked Orbit에 오신 걸 환영합니다! 저는 주노예요, 여기 와주셔서 정말 기뻐요. 우리가 운영하는 AI 시스템에 새로 온 엔지니어들이 편안하게 적응하도록 돕는 게 제 일 중에서 가장 좋아하는 부분이에요. 이 신기하던 것들이 여러분이 실제로 이해하는 무언가로 바뀌는 과정을 지켜보는 건 아무리 봐도 질리지 않아요.

이 모델들이 내부적으로 정말 무엇인지부터 시작할 거예요. 머신러닝 배경지식은 전혀 필요 없고요, 하나씩 차근차근 쌓아 올릴 거예요.

여기서는 아무리 기초적인 질문이라도 물어보지 못할 건 없어요. 사실 저도 이 내용 중 일부를 이해하는 데 인정하고 싶지 않을 만큼 오래 걸렸거든요. 여러분 속도에 맞춰 천천히 가시면 돼요, 함께 도착하면 되니까요!

Juno

Crooked Orbit에 오신 걸 환영합니다. 저는 에이스예요, 시스템 엔지니어로 일하면서 여기서 매일 돌아가는 AI 빌드들을 챙기고 있어요. 이미 기초는 갖추셨으니, 실제로 코드를 짤 때 하는 방식 그대로 실용적으로, 안정된 속도로 나아갈 거예요.

각 챕터는 개념을 다룬 다음 그걸로 무엇을 할지 이어집니다: 읽고, 해보고, 만들어보는 거죠. 이 스테이션에 있는 시스템의 절반은 정확히 이 흐름으로 돌아가니, 여러분도 좋은 동료들과 함께하는 거예요.

Juno

Crooked Orbit에 오신 걸 환영합니다. 저는 솔이에요, 수석 엔지니어로 이곳에서 14년째 일하며 커피를 지나치게 많이 마셔왔죠. 이 문서는 어떤 버튼을 눌러야 하는지만이 아니라 AI 시스템이 실제로 어떻게 동작하는지 알고 싶은 사람들을 위한 것입니다.

이 안의 내용은 대부분 제가 직접 설계했고, 보통 두 번씩이었어요, 첫 번째 버전은 늘 실수였으니까요. 여기서는 트레이드오프, 실패 패턴, 그리고 다른 사람들은 다 건너뛰는 세세한 부분까지 다룰 겁니다. 꼼꼼히 읽고 모든 걸 의심해보세요, 저까지도요.

이 핸드북은 API를 호출하고 잘되길 바라는 것에서 그치지 않고, AI가 실제로 어떻게 동작하는지 이해하고 싶은 개발자를 위한 것입니다. 앞으로 계속 나올 두 용어를 짧게 짚고 넘어가겠습니다: 모델은 텍스트를 보내면 텍스트를 돌려주는 AI 시스템으로, ChatGPT를 뒤에서 움직이는 것과 같은 존재입니다. 프롬프트는 모델에 보내는 텍스트와 지시 사항입니다. 모델을 호출하는 것을 API 호출이라고 부르는데, 여러분의 코드가 웹을 통해 프롬프트를 보내고 텍스트를 돌려받는다는 점에서 다른 웹 서비스와 다를 게 없습니다. 여기서 다루는 개념들은 깊이 있게, 예시와 함께 충분히 풀어서 설명하며, 나중에 빠르게 답을 찾고 싶을 때 검색해볼 수 있도록 구성했습니다.

이 문서는 여러분이 이미 Python을 다룰 수 있다고 가정합니다: 변수, 함수, 웹 API 호출 정도면 충분합니다. 여기에 해당한다면 필요한 건 다 갖춘 셈이고, 기초부터 먼저 익히고 싶다면 Python 핸드북에서 처음부터 다루고 있습니다. 머신러닝 배경지식은 전혀 필요하지 않습니다. AI 엔지니어링은 다른 사람이 학습시킨 모델로 제품을 만드는 일이지, 직접 모델을 학습시키는 일이 아닙니다.

이 핸드북이 취하는 접근 방식은 API만이 아니라 그 뒤에 있는 기계 자체를 설명하는 것입니다. 튜토리얼에서 모델 호출 코드를 그대로 베껴서 정상 경로에서 돌아가게 만드는 건 누구나 할 수 있습니다. 그 수준과 실제로 안정적으로 동작하는 것을 만드는 수준 사이의 거리는, 내부에서 무슨 일이 일어나는지 이해하는 데서 옵니다: 모델이 왜 그런 결과를 내놓는지, 왜 특정한 방식으로 실패하는지, 그리고 각각에 대해 무엇을 할 수 있는지를 이해하는 것입니다.

그래서 이 핸드북은 무엇을 입력해야 하는지 보여주기 전에, 이 모델들이 어떻게 동작하는지에 실질적인 시간을 들입니다. 이는 열쇠만 돌리기보다 엔진을 이해하고 싶은 개발자를 위해 쓰였습니다. 기계를 이해하는 것이야말로 어떤 특정 모델보다 오래 남는 지식이기 때문입니다. 그래야 잘못된 답을 마주쳤을 때 그냥 어깨를 으쓱하고 넘기는 대신 디버깅할 수 있고, 내년에 어떤 모델을 쓰게 되더라도 마찬가지입니다.

이 문서는 개념을 깊이 있게 가르치며, 여러분은 직접 연습 문제와 프로젝트를 통해 이를 실전에 적용해볼 수 있습니다. Scrimba의 메인 코스는 같은 내용을 가이드를 따라 직접 만들어보는 버전입니다.

Scrimba에서 AI Engineer Path 수강하기JavaScript로 직접 만들어보며 이 개념들을 실제 앱으로 구현합니다→

여기는 Python, 코스는 JavaScript

이 문서는 Python으로 작성되어 있고, AI Engineer Path는 같은 내용을 웹용 JavaScript로 가르칩니다. 이 차이는 보이는 것보다 크지 않습니다: AI 엔지니어링은 어떤 언어로 하든 본질적으로 같은 작업으로, 웹 요청을 통해 모델에 텍스트를 보내고 돌아오는 결과를 다루는 일입니다. 토큰과 프롬프팅부터 검색(retrieval), 에이전트, 평가(eval)까지 여기서 다루는 모든 개념은 어떤 언어로 작성하든 동일하며, 모델을 호출하는 부분의 문법만 달라질 뿐입니다. 한쪽을 익히면 다른 쪽도 이미 아는 셈이니, 여기서 읽는 것과 코스에서 직접 만들어보는 것이 서로를 보강해 줍니다.

Juno빠르게 변하는 분야 이 분야의 모델 이름과 가격은 거의 매달 바뀌니, 외울 필요 없습니다. 우리는 변하지 않는 부분, 즉 이 모델들이 어떻게 동작하는지와 이를 바탕으로 무언가를 만드는 패턴에 집중합니다. 특정 제공사에 관련된 내용은 명확히 표시된 코드 블록 안에만 넣어두니, 그 내용이 바뀌더라도 한 줄만 고치면 되고 주변의 개념은 그대로 유효합니다.

Juno빠르게 변하는 분야 모델 이름과 가격은 거의 매달 바뀌기 때문에, 저는 그런 것들을 외우지 않고 여러분도 그럴 필요 없어요. 변하지 않는 건 이 모델들이 어떻게 동작하는지, 그리고 그걸 바탕으로 만드는 패턴이고, 우리가 다루는 것도 바로 그거예요. 제공사에 특화된 내용은 표시된 코드 블록 안에 담아두니, 새 모델이 나와도 한 줄만 바꾸면 되고 다시 쓸 필요는 없어요.

Juno빠르게 변하는 분야 모델 이름과 가격은 거의 매달 뒤바뀌는데, 그래서 저는 몇 년 전부터 어떤 것에도 애착을 두지 않기로 했습니다. 오래 남는 건 동작 방식과 패턴이고, 우리가 시간을 쏟는 곳도 바로 거기입니다. 특정 제공사에 얽힌 내용은 명확히 표시된 코드 블록 안에 두니, 다음 릴리스가 나와도 한 줄만 바꾸고 넘어가면 됩니다.

여러분의 가이드를 소개합니다

이 핸드북은 Crooked Orbit 소속 세 명의 엔지니어가 진행하며, 여러분이 직접 안내를 맡을 사람을 고를 수 있습니다. 내용 자체는 누구에게나 같지만, 가이드에 따라 이야기를 풀어가는 어투가 달라지고, 페이지에 따라서는 각 섹션이 얼마나 깊이 들어가는지도 달라집니다.

가이드는 언제든 각 페이지 상단의 선택 메뉴에서 바꿀 수 있고, 오른쪽 하단의 **환경설정(Preferences)**을 열면 가이드, 언어, 글꼴 크기를 바꿀 수 있습니다.

준비가 되면 이제 본격적으로 핸드북을 시작합니다. 다음 챕터인 AI의 짧은 역사는 지난 70여 년에 걸쳐 이 시스템들이 어디서 왔는지를 살펴봅니다. 그 역사를 알아야 이 분야에서 어떤 부분이 오래 남을 것인지, 어떤 부분이 그저 올해의 유행에 지나지 않는지를 판단할 수 있기 때문입니다.