ed-donner/agents

OpenAI Agents SDK, CrewAI, LangGraph, AutoGen 및 MCP를 사용하여 AI Agents를 코딩하고 배포하는 6주간의 여정

만약 Cursor에서 이 내용을 보고 계신다면, 왼쪽 Explorer에 있는 파일 이름을 마우스 오른쪽 버튼으로 클릭한 뒤 "Open preview"를 선택하여 서식이 적용된 버전을 확인해 주세요.

여러분을 환영하게 되어 더할 나위 없이 기쁩니다! 이것은 강력하고, 놀라우며, 때로는 초현실적인 Agentic AI (에이전트형 AI)의 세계로 떠나는 여러분의 6주간의 모험의 시작입니다.

여러분이 가장 성공적인 결과를 얻을 수 있도록 돕기 위해 제가 여기 있습니다! 플랫폼을 통하거나 저에게 직접 이메일(ed@edwarddonner.com)을 보내 도움을 요청해 주세요. 커뮤니티를 구축하기 위해 LinkedIn에서 사람들과 연결되는 것은 언제나 즐거운 일입니다. 여기에서 저를 찾으실 수 있습니다:

그리고 저에게는 이것도 새로운 시도인데, X/Twitter(@edwarddonner)도 사용해 보려고 합니다. 만약 여러분이 X를 사용하신다면, 어떻게 하는 것인지 저에게 알려주세요 😂

어쩌면 유명한 마지막 말이 될지도 모르겠지만, 설치 과정이 너무 끔찍하지 않은 환경을 구축했기를 진심으로 바랍니다!

문제가 발생하면 언제든 저에게 연락해 주세요.

Windows PC 사용자: SETUP-PC 지침 상단에 있는 "gotcha #4" 항목인 Microsoft Build Tools 설치를 반드시 확인해야 합니다.

이를 수행하지 않으면, CrewAI가 Chroma와 관련된 모호한 오류를 내며 실패할 것입니다.

그 다음, Crew 명령어를 실행하기 위해 프로젝트 루트 디렉토리의 Cursor Terminal에서 다음 명령어를 실행해야 합니다:

uv tool install crewai==0.130.0 --python 3.12

그리고 이전에 Crew를 사용해 본 적이 있다면, 최신 버전을 확보하기 위해 다음을 수행하는 것이 좋습니다:

uv tool upgrade crewai==0.130.0 --python 3.12

이 명령어는 Crew를 제가 강의에서 사용하는 것과 동일한 버전으로 고정합니다. 만약 Crew 사용 중 문제가 발생한다면, 다음 명령어를 실행하여 대신 최신 버전을 사용해 볼 수 있습니다:

uv tool upgrade crewai --python 3.12

언제든지 다음 명령어를 통해 설치된 Crew의 버전을 확인할 수 있습니다:

uv tool list

참고: uv에서 "tool"이란 uv에 의해 전역적으로 설치되는 유틸리티를 의미합니다. 이 도구를 설치한 후에는 "crewai"를 명령어로 사용할 수 있으며, 이는 해당 도구와 연결된 코드를 실행합니다.

그다음 Crew를 위해 다음 사항을 유념해 주세요:

• 3주 차에 CrewAI 프로젝트를 진행하는 방법에는 두 가지가 있습니다. 제가 프로젝트를 빌드하는 동안 각 프로젝트의 코드를 검토하고, crewai run을 실행하여 실제로 작동하는 모습을 확인하는 방법이 있습니다. 또는 더 직접적인 실습을 선호한다면, 제 프로젝트를 모방하여 처음부터 자신만의 Crew 프로젝트를 생성할 수도 있습니다. 예를 들어, debate와 나란히 사용할 my_debate를 생성하고 저와 함께 코드를 작성하는 방식입니다. 어떤 방식이든 괜찮습니다!
• Windows 사용자: 최근 Crew의 라이브러리 중 하나로 인해 새로운 이슈가 발생했습니다. 이 문제가 수정될 때까지 crewai create crew를 실행하려고 하면 "unicode" 에러가 발생할 수 있습니다. 만약 그런 일이 발생하면, 먼저 터미널(Terminal)에서 다음 명령어를 실행해 보세요: $env:PYTHONUTF8 = "1"
• Gemini 사용자: .env 파일에 GOOGLE_API_KEY를 위한 키를 입력하는 것 외에도, GEMINI_API_KEY를 위한 동일한 키가 필요합니다.
• 영상이 포함된 강의 리소스
• 가이드(guides) 섹션의 많은 필수 가이드
• 트러블슈팅(troubleshooting) 노트북
• 일반적인 문제와 질문이 담긴 저의 전체 FAQ 페이지

이 과정은 OpenAI 및 기타 프런티어 모델(frontier models)에 호출을 수행하므로 API 키와 약간의 비용이 발생하며, 이는 SETUP 지침에서 설정하도록 되어 있습니다. API 호출 비용을 지불하고 싶지 않다면, DeepSeek와 같은 더 저렴한 대안이나 Ollama를 사용하는 것과 같은 무료 대안이 있습니다!

자세한 내용은 여기에 있습니다.

지출 금액에 대해 완전히 만족할 수 있도록 API 비용을 반드시 모니터링하세요. OpenAI의 경우, 대시보드는 여기에 있습니다.

강의를 즐겁게 수강하시기 바랍니다! Agentic AI(에이전틱 AI)에 대해 배우기에 이보다 더 좋은 시기를 선택할 수는 없었을 것입니다. 매 순간을 즐기시길 바랍니다! 그리고 어느 지점에서든 막히는 부분이 있다면 저에게 연락해 주세요.