CLI

​

개요

​

설치

pip install crewai

​

기본 사용법

crewai [COMMAND] [OPTIONS] [ARGUMENTS]

​

사용 가능한 명령어

​

1. 생성

crewai create [OPTIONS] TYPE NAME

• TYPE: “crew” 또는 “flow” 중에서 선택
• NAME: crew 또는 flow의 이름

crewai create crew my_new_crew
crewai create flow my_new_flow

​

바로 실행하기

  Run it now? [Y/n]:

  Run it later: cd my_new_crew && crewai run

​

사용 중단된 플래그 별칭

​

2. 버전

crewai version [OPTIONS]

• --tools: (선택 사항) 설치된 CrewAI tools의 버전을 표시합니다.

crewai version
crewai version --tools

​

3. 훈련

crewai train [OPTIONS]

• -n, --n-iterations INTEGER: crew를 훈련할 반복 횟수 (기본값: 5)
• -f, --filename TEXT: 훈련에 사용할 커스텀 파일의 경로 (기본값: “trained_agents_data.pkl”)

crewai train -n 10 -f my_training_data.pkl

​

4. 다시 실행

crewai replay [OPTIONS]

• -t, --task-id TEXT: 이 task ID에서부터 crew를 다시 재생하며, 이후의 모든 task를 포함합니다.

crewai replay -t task_123456

​

5. Log-tasks-outputs

crewai log-tasks-outputs

​

6. Reset-memories

crewai reset-memories [OPTIONS]

• -l, --long: LONG TERM 메모리 초기화
• -s, --short: SHORT TERM 메모리 초기화
• -e, --entities: ENTITIES 메모리 초기화
• -k, --kickoff-outputs: LATEST KICKOFF TASK OUTPUTS 초기화
• -kn, --knowledge: KNOWLEDGE 저장소 초기화
• -akn, --agent-knowledge: AGENT KNOWLEDGE 저장소 초기화
• -a, --all: 모든 메모리 초기화

crewai reset-memories --long --short
crewai reset-memories --all

​

7. 테스트

crewai test [OPTIONS]

• -n, --n-iterations INTEGER: crew를 테스트할 반복 횟수 (기본값: 3)
• -m, --model TEXT: Crew에서 테스트를 실행할 LLM 모델 (기본값: “gpt-4o-mini”)

crewai test -n 5 -m gpt-3.5-turbo

​

8. 실행

crewai run

OPENAI_API_KEY is not set. Add OPENAI_API_KEY=<your key> to /path/to/my_crew/.env, then run `crewai run` again.

​

9. Chat

crewai chat

{
  "name": "My Crew",
  "agents": ["researcher"],
  "tasks": [],
  "chat_llm": "openai/gpt-4o"
}

@crew
def crew(self) -> Crew:
    return Crew(
        agents=self.agents,
        tasks=self.tasks,
        process=Process.sequential,
        verbose=True,
        chat_llm="gpt-4o",  # LLM for chat orchestration
    )

​

10. 배포

• 인증: CrewAI AOP에 배포하려면 인증이 필요합니다. 아래 명령어로 로그인하거나 계정을 생성할 수 있습니다:
  Terminal

  crewai login
  
• 배포 생성: 인증이 완료되면, 로컬 프로젝트의 루트에서 crew 또는 flow에 대한 배포를 생성할 수 있습니다.
  Terminal

  crewai deploy create
  
  • 로컬 프로젝트 구성을 읽어옵니다.
  • 로컬에서 확인된 환경 변수(OPENAI_API_KEY, SERPER_API_KEY 등)를 확인하도록 안내합니다. 이 변수들은 Enterprise 플랫폼에 배포할 때 안전하게 저장됩니다. 실행 전에 중요한 키가 로컬(예: .env 파일)에 올바르게 구성되어 있는지 확인하세요.
  • --zip은 프로젝트에 git origin이 있어도 그 원격에서 fetch하지 않고 프로젝트를 ZIP으로 업로드합니다.
  • 프로젝트가 커밋이 하나 이상 있는 git 저장소이면, 생성이든 push든 모든 ZIP 업로드는 ZIP을 만든 로컬 커밋과, 프로젝트 디렉터리에 커밋되지 않은 변경 사항이 있었는지를 출력합니다.

​

11. 조직 관리

crewai org [COMMAND] [OPTIONS]

​

명령어:

• list: 사용자가 속한 모든 조직을 나열합니다.

crewai org list

• current: 현재 활성화된 조직을 표시합니다.

crewai org current

• switch: 특정 조직으로 전환합니다.

crewai org switch <organization_id>

• 배포 생성 (계속):
  • 배포를 해당 원격 GitHub 저장소에 연결합니다 (일반적으로 자동으로 감지됩니다).
• Crew 배포: 인증이 완료되면 crew 또는 flow를 CrewAI AOP에 배포할 수 있습니다.
  Terminal

  crewai deploy push
  
  • CrewAI AMP 플랫폼에서 배포 프로세스를 시작합니다.
  • 성공적으로 시작되면, Deployment created successfully! 메시지와 함께 Deployment Name 및 고유한 Deployment ID(UUID)가 출력됩니다.
  • Push는 생성 시 사용한 소스를 유지합니다. 나중에 git origin을 추가해도 ZIP 배포가 git으로 바뀌지 않습니다.
• 배포 상태: 배포 상태를 확인하려면 다음을 사용합니다:
  Terminal

  crewai deploy status
  
  이 명령은 가장 최근의 배포 시도에 대한 최신 배포 상태(예: Building Images for Crew, Deploy Enqueued, Online)를 가져옵니다. 배포가 실패한 경우 오류와 권장 해결 방법도 함께 출력합니다.
• 배포 로그: 배포 로그를 확인하려면 다음을 사용합니다:
  Terminal

  crewai deploy logs
  
  이 명령은 배포 로그를 터미널로 스트리밍합니다.
• 배포 목록: 모든 배포를 나열하려면 다음을 사용합니다:
  Terminal

  crewai deploy list
  
  이 명령은 모든 배포를 나열합니다.
• 배포 삭제: 배포를 삭제하려면 다음을 사용합니다:
  Terminal

  crewai deploy remove
  
  이 명령은 CrewAI AMP 플랫폼에서 배포를 삭제합니다.
• 도움말 명령어: CLI에 대한 도움말을 보려면 다음을 사용합니다:
  Terminal

  crewai deploy --help
  
  이 명령은 CrewAI Deploy CLI에 대한 도움말 메시지를 표시합니다.

​

11. API 키

  API key not saved. Add this line to my_new_crew/.env before `crewai run`:
    OPENAI_API_KEY=<your key>

  Set OPENAI_API_KEY in .env before `crewai run`

​

사용 가능한 LLM 공급자

• OpenAI
• Groq
• Anthropic
• Google Gemini
• SambaNova

​

기타 옵션

• LiteLLM 공급자

​

12. 구성 관리

crewai config [COMMAND] [OPTIONS]

​

명령어:

• list: 모든 CLI 구성 매개변수 표시

crewai config list

• set: CLI 구성 매개변수 설정

crewai config set <key> <value>

• reset: 모든 CLI 구성 매개변수를 기본값으로 초기화

crewai config reset

​

사용 가능한 구성 파라미터

• enterprise_base_url: CrewAI AMP 인스턴스의 기본 URL
• oauth2_provider: 인증에 사용되는 OAuth2 공급자 (예: workos, okta, auth0)
• oauth2_audience: OAuth2 audience 값으로, 일반적으로 대상 API 또는 리소스를 식별하는 데 사용됨
• oauth2_client_id: 인증 요청 시 사용되는 공급자가 발급한 OAuth2 클라이언트 ID
• oauth2_domain: 토큰 발급에 사용되는 OAuth2 공급자의 도메인 (예: your-org.auth0.com)

​

예시

crewai config list

crewai config set enterprise_base_url https://my-enterprise.crewai.com

crewai config set oauth2_provider auth0

crewai config set oauth2_domain my-company.auth0.com

crewai config reset