Framework for orchestrating role-playing, autonomous AI agents. By fostering collaborative intelligence, CrewAI empowers agents to work together seamlessly, tackling complex tasks.
이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.
CrewAI는 프로덕션 준비가 완료된 멀티 에이전트 워크플로우를 구축하기 위한 고수준 추상화와 저수준 API를 제공하는 오픈소스 Python 프레임워크입니다.
개발자에게 Crew를 통한 자율 에이전트 협업과 Flow를 통한 정밀한 이벤트 기반 제어를 제공합니다.
learn.crewai.com에서 커뮤니티 과정을 통해 100,000명 이상의 개발자가 인증을 받았으며, CrewAI는 프로덕션 준비가 완료된 에이전트 자동화의 표준으로 빠르게 자리잡고 있습니다.
CrewAI 주변에 상용 제어 평면이 필요한 조직을 위해 CrewAI AMP Suite는 관리형 배포, 관찰 가능성, 거버넌스, 보안 및 엔터프라이즈 지원을 추가합니다.
Crew Control Plane을 무료로 사용해 볼 수 있습니다.
CrewAI AMP는 복잡한 비즈니스 프로세스를 효율적이고 지능적인 자동화로 전환하는 강력하고 안정적인 솔루션을 찾는 기업을 위해 설계되었습니다.
AI 코딩 에이전트를 사용하시나요? 한 명령으로 CrewAI 모범 사례를 가르치세요:
Claude Code:
/plugin marketplace add crewAIInc/skills
/plugin install crewai-skills@crewai-plugins
/reload-plugins관련 CrewAI 질문을 할 때 자동으로 활성화되는 네 가지 스킬:
| 스킬 | 실행 시점 | ||
|---|---|---|---|
getting-started |
새 프로젝트 스캐폴딩, LLM.call() / Agent / Crew / Flow 중 선택, crew.py / main.py 연결 |
||
design-agent |
에이전트 구성 — 역할, 목표, 배경 스토리, 도구, LLM, 메모리, 가드레일 | ||
design-task |
작업 설명, 종속성, 구조화된 출력 (outputpydantic, outputjson), 인간 검토 작성 |
||
ask-docs |
최신 API 세부 정보를 위해 라이브 CrewAI 문서 MCP 서버 쿼리 |
Cursor, Codex, Windsurf 등 (skills.sh):
npx skills add crewaiinc/skills이것은 공식 CrewAI Skills를 설치합니다 — 코딩 에이전트가 Flow를 스캐폴딩하고, Crew를 구성하고, 에이전트와 작업을 설계하고, CrewAI 패턴을 따르는 방법을 가르치는 구조화된 지침입니다.
<div align="center" style="margin-bottom: 30px;"> <img src="docs/images/asset.png" alt="CrewAI 로고" width="100%"> </div>
CrewAI는 AI 에이전트의 Crew와 이벤트 기반 Flow를 통해 멀티 에이전트 자동화의 진정한 잠재력을 발휘하여 속도, 유연성 및 제어를 제공합니다:
CrewAI는 개발자와 팀이 단순성, 유연성 및 프로덕션 등급 제어의 균형을 맞춘 지능형 자동화를 구축할 수 있도록 지원합니다.
이 튜토리얼을 따라 첫 번째 CrewAI 에이전트를 설정하고 실행하세요.
###
학습 리소스
포괄적인 과정을 통해 CrewAI를 배우세요:
CrewAI는 정교한 AI 애플리케이션을 구축하기 위해 원활하게 함께 작동하는 두 가지 강력하고 상호 보완적인 접근 방식을 제공합니다:
CrewAI의 진정한 힘은 Crews와 Flows를 결합할 때 나타납니다. 이 시너지를 통해 다음을 수행할 수 있습니다:
CrewAI를 시작하려면 다음 간단한 단계를 따르세요:
시스템에 Python >=3.10 <3.14가 설치되어 있는지 확인하세요. CrewAI는 종속성 관리 및 패키지 처리를 위해 UV를 사용하여 원활한 설정 및 실행 경험을 제공합니다.
먼저 CrewAI를 설치하세요:
uv pip install crewai'crewai' 패키지와 에이전트를 위한 추가 도구가 포함된 선택적 기능을 함께 설치하려면 다음 명령을 사용할 수 있습니다:
uv pip install 'crewai[tools]'위 명령은 기본 패키지를 설치하고 작동에 더 많은 종속성이 필요한 추가 구성 요소도 추가합니다.
설치 또는 사용 중 문제가 발생하면 다음과 같은 일반적인 해결 방법이 있습니다:
uv pip install 'crewai[embeddings]'uv pip install 'crewai[tools]'uv pip install --upgrade pipuv pip install tiktoken --prefer-binary새 CrewAI 프로젝트를 생성하려면 다음 CLI 명령을 실행하세요:
crewai create crew <project_name>이 명령은 다음 구조로 새 프로젝트 폴더를 생성합니다:
my_project/
├──.gitignore
├── pyproject.toml
├── README.md
├──.env
└── src/
└── my_project/
├── __init__.py
├── main.py
├── crew.py
├── tools/
│ ├── custom_tool.py
│ └── __init__.py
└── config/
├── agents.yaml
└── tasks.yaml이제 src/my_project 폴더의 파일을 편집하여 crew 개발을 시작할 수 있습니다. main.py는 프로젝트의 진입점이고, crew.py는 crew를 정의하는 파일이며, agents.yaml은 에이전트를 정의하는 파일이고, tasks.yaml은 작업을 정의하는 파일입니다.
src/my_project/config/agents.yaml을 수정하여 에이전트를 정의합니다.src/my_project/config/tasks.yaml을 수정하여 작업을 정의합니다.src/my_project/crew.py를 수정하여 자체 로직, 도구 및 특정 인수를 추가합니다.src/my_project/main.py를 수정하여 에이전트 및 작업에 대한 사용자 정의 입력을 추가합니다..env 파일에 환경 변수를 추가합니다.crew를 인스턴스화합니다:
crewai create crew latest-ai-development