영상: 코딩 에이전트 스킬을 활용한 CrewAI Agents & Flows 구축
코딩 에이전트 스킬(Claude Code, Codex 등)을 설치하여 CrewAI로 코딩 에이전트를 빠르게 시작하세요.npx skills add crewaiinc/skills 명령어로 설치할 수 있습니다
이 가이드에서는 Flow를 만들어 연구 주제를 정하고, 에이전트 한 명으로 구성된 crew(웹 검색을 쓰는 연구원)를 실행한 뒤, 디스크에 Markdown 보고서를 남깁니다. Flow는 프로덕션 앱을 구성하는 권장 방식으로, 상태와 실행 순서를 담당하고 에이전트는 crew 단계 안에서 실제 작업을 수행합니다.
CrewAI를 아직 설치하지 않았다면 먼저 설치 가이드를 따르세요.
사전 요건
- Python 환경과 CrewAI CLI(설치 참고)
- 올바른 API 키로 설정한 LLM — LLM 참고
- 이 튜토리얼의 웹 검색용 Serper.dev API 키(
SERPER_API_KEY)
첫 번째 Flow 만들기
Flow 프로젝트 생성
터미널에서 Flow 프로젝트를 생성합니다(폴더 이름은 밑줄 형식입니다. 예: 이렇게 하면
latest_ai_flow).src/latest_ai_flow/ 아래에 Flow 앱이 만들어지고, 다음 단계에서 단일 에이전트 연구 crew로 바꿀 시작용 crew가 crews/content_crew/에 포함됩니다.JSONC로 에이전트 하나 설정
src/latest_ai_flow/crews/content_crew/agents/researcher.jsonc를 만듭니다(agents/ 디렉터리가 없으면 생성). {topic} 같은 변수는 crew.kickoff(inputs=...)로 채워집니다.agents/researcher.jsonc
JSON crew 로드 (`content_crew.py`)
생성된
content_crew.py를 crew.jsonc를 Crew로 바꾸는 작은 loader로 교체합니다.content_crew.py
`main.py`에서 Flow 정의
crew를 Flow에 연결합니다:
@start() 단계에서 주제를 상태에 넣고, @listen 단계에서 crew를 실행합니다. 작업의 output_file은 그대로 output/report.md에 씁니다.main.py
환경 변수
프로젝트 루트의
.env에 다음을 설정합니다.SERPER_API_KEY— Serper.dev에서 발급- 모델 제공자 키 — LLM 설정 참고
한 번에 이해하기
- Flow —
LatestAiFlow는prepare_topic→run_research→summarize순으로 실행됩니다. 상태(topic,report)는 Flow에 있습니다. - Crew —
kickoff_content_crew가crew.jsonc를 로드하고 에이전트 한 명·작업 하나로 실행합니다. 연구원이 Serper로 웹을 검색하고 구조화된 보고서를 씁니다. - 결과물 — 작업의
output_file이output/report.md에 보고서를 씁니다.
Agent의 kickoff()만 쓰려면 Agents를 참고하세요.
에이전트 crew와 저장된 보고서까지 이어진 Flow를 완성했습니다. 이제 단계·crew·도구를 더해 확장할 수 있습니다.
이름 일치
crew.jsonc의 이름은 파일과 참조에 맞아야 합니다:
agents: ["researcher"]는agents/researcher.jsonc를 로드합니다.tasks[].agent: "researcher"는 해당 태스크를 그 에이전트에 배정합니다.
배포
로컬에서 정상 실행되고 프로젝트가 GitHub 저장소에 있으면 Flow를 **CrewAI AMP**에 올릴 수 있습니다. 프로젝트 루트에서:배포 가이드
AMP 배포 단계별 안내(CLI 및 대시보드).
커뮤니티
아이디어를 나누고 프로젝트를 공유하며 다른 CrewAI 개발자와 소통하세요.
