메인 콘텐츠로 건너뛰기

개요

에이전트가 GitHub를 통해 리포지토리, 이슈, 릴리스를 관리할 수 있도록 지원합니다. 이슈를 생성 및 업데이트하고, 릴리스를 관리하고, 프로젝트 개발을 추적하며, AI 기반 자동화를 통해 소프트웨어 개발 워크플로우를 효율화하세요.

사전 요구 사항

GitHub 통합을 사용하기 전에 다음을 확인하세요:
  • 활성 구독이 있는 CrewAI AMP 계정
  • 해당 리포지토리에 대한 적절한 권한이 있는 GitHub 계정
  • 통합 페이지를 통해 GitHub 계정 연결 완료

GitHub 연동 설정

1. GitHub 계정 연결하기

  1. CrewAI AMP Integrations로 이동합니다.
  2. 인증 통합 섹션에서 GitHub을 찾습니다.
  3. Connect를 클릭하고 OAuth 흐름을 완료합니다.
  4. 리포지토리 및 이슈 관리를 위한 필수 권한을 부여합니다.
  5. 통합 설정에서 Enterprise Token을 복사합니다.

2. 필수 패키지 설치

3. 환경 변수 설정

Agent(apps=[])와 함께 통합을 사용하려면 Enterprise Token으로 CREWAI_PLATFORM_INTEGRATION_TOKEN 환경 변수를 설정해야 합니다.
또는 .env 파일에 추가하세요:

사용 가능한 작업

설명: GitHub에 이슈를 생성합니다.파라미터:
  • owner (string, 필수): 소유자 - 이 이슈와 연관된 저장소의 계정 소유자 이름을 지정합니다. (예시: “abc”).
  • repo (string, 필수): 저장소 - 이 이슈와 연관된 저장소 이름을 지정합니다.
  • title (string, 필수): 이슈 제목 - 생성할 이슈의 제목을 지정합니다.
  • body (string, 선택): 이슈 본문 - 생성할 이슈의 본문 내용을 지정합니다.
  • assignees (string, 선택): 담당자 - 이 이슈의 담당자 GitHub 로그인을 문자열 배열로 지정합니다. (예시: ["octocat"]).
설명: GitHub에서 이슈를 업데이트합니다.파라미터:
  • owner (string, 필수): 소유자 - 이 이슈와 연관된 저장소의 계정 소유자 이름을 지정합니다. (예시: “abc”).
  • repo (string, 필수): 저장소 - 이 이슈와 연관된 저장소 이름을 지정합니다.
  • issue_number (string, 필수): 이슈 번호 - 업데이트할 이슈의 번호를 지정합니다.
  • title (string, 필수): 이슈 제목 - 업데이트할 이슈의 제목을 지정합니다.
  • body (string, 선택): 이슈 본문 - 업데이트할 이슈의 본문 내용을 지정합니다.
  • assignees (string, 선택): 담당자 - 이 이슈의 담당자 GitHub 로그인을 문자열 배열로 지정합니다. (예시: ["octocat"]).
  • state (string, 선택): 상태 - 이슈의 변경된 상태를 지정합니다.
    • 옵션: open, closed
설명: GitHub에서 번호로 이슈를 조회합니다.파라미터:
  • owner (string, 필수): 소유자 - 이 이슈와 연관된 저장소의 계정 소유자 이름을 지정합니다. (예시: “abc”).
  • repo (string, 필수): 저장소 - 이 이슈와 연관된 저장소 이름을 지정합니다.
  • issue_number (string, 필수): 이슈 번호 - 가져올 이슈의 번호를 지정합니다.
설명: GitHub에서 이슈를 잠급니다.파라미터:
  • owner (string, 필수): 소유자 - 이 이슈와 연관된 저장소의 계정 소유자 이름을 지정합니다. (예시: “abc”).
  • repo (string, 필수): 저장소 - 이 이슈와 연관된 저장소 이름을 지정합니다.
  • issue_number (string, 필수): 이슈 번호 - 잠글 이슈의 번호를 지정합니다.
  • lock_reason (string, 필수): 잠금 사유 - 이슈 또는 풀 리퀘스트 대화에 대한 잠금 이유를 지정합니다.
    • 옵션: off-topic, too heated, resolved, spam
설명: GitHub에서 이슈를 검색합니다.파라미터:
  • owner (string, 필수): 소유자 - 이 이슈와 연관된 저장소의 계정 소유자 이름을 지정합니다. (예시: “abc”).
  • repo (string, 필수): 저장소 - 이 이슈와 연관된 저장소 이름을 지정합니다.
  • filter (object, 필수): 불리언 표준형의 필터 - 단일 조건의 AND 그룹의 OR 조합.
    사용 가능한 필드: assignee, creator, mentioned, labels
설명: GitHub에 릴리스를 생성합니다.파라미터:
  • owner (string, 필수): 소유자 - 이 릴리스와 연관된 저장소의 계정 소유자 이름을 지정합니다. (예시: “abc”).
  • repo (string, 필수): 저장소 - 이 릴리스와 연관된 저장소 이름을 지정합니다.
  • tag_name (string, 필수): 이름 - 생성할 릴리스 태그의 이름을 지정합니다. (예시: “v1.0.0”).
  • target_commitish (string, 선택): 대상 - 릴리스의 대상을 지정합니다. 브랜치 이름이나 커밋 SHA가 될 수 있으며, 기본값은 메인 브랜치입니다. (예시: “master”).
  • body (string, 선택): 본문 - 이 릴리스에 대한 설명을 지정합니다.
  • draft (string, 선택): 초안 - 생성할 릴리스를 초안(비공개) 릴리스로 지정할지 여부를 지정합니다.
    • 옵션: true, false
  • prerelease (string, 선택): 프리릴리스 - 생성할 릴리스를 프리릴리스로 지정할지 여부를 지정합니다.
    • 옵션: true, false
  • discussion_category_name (string, 선택): 토론 카테고리 이름 - 지정 시, 해당 카테고리의 토론이 생성되어 릴리스와 연결됩니다. 값은 저장소에 이미 존재하는 카테고리여야 합니다.
  • generate_release_notes (string, 선택): 릴리스 노트 - 지정한 이름과 본문을 사용하여 릴리스 노트를 자동으로 생성할지 여부를 지정합니다.
    • 옵션: true, false
설명: GitHub에서 릴리스를 업데이트합니다.파라미터:
  • owner (string, 필수): 소유자 - 이 릴리스와 연관된 저장소의 계정 소유자 이름을 지정합니다. (예시: “abc”).
  • repo (string, 필수): 저장소 - 이 릴리스와 연관된 저장소 이름을 지정합니다.
  • id (string, 필수): 릴리스 ID - 업데이트할 릴리스의 ID를 지정합니다.
  • tag_name (string, 선택): 이름 - 업데이트할 릴리스 태그의 이름을 지정합니다. (예시: “v1.0.0”).
  • target_commitish (string, 선택): 대상 - 릴리스의 대상을 지정합니다. 브랜치 이름이나 커밋 SHA가 될 수 있으며, 기본값은 메인 브랜치입니다. (예시: “master”).
  • body (string, 선택): 본문 - 이 릴리스에 대한 설명을 지정합니다.
  • draft (string, 선택): 초안 - 생성할 릴리스를 초안(비공개) 릴리스로 지정할지 여부를 지정합니다.
    • 옵션: true, false
  • prerelease (string, 선택): 프리릴리스 - 생성할 릴리스를 프리릴리스로 지정할지 여부를 지정합니다.
    • 옵션: true, false
  • discussion_category_name (string, 선택): 토론 카테고리 이름 - 지정 시, 해당 카테고리의 토론이 생성되어 릴리스와 연결됩니다. 값은 저장소에 이미 존재하는 카테고리여야 합니다.
  • generate_release_notes (string, 선택): 릴리스 노트 - 지정한 이름과 본문을 사용하여 릴리스 노트를 자동으로 생성할지 여부를 지정합니다.
    • 옵션: true, false
설명: GitHub에서 ID로 릴리스를 조회합니다.파라미터:
  • owner (string, 필수): 소유자 - 이 릴리스와 연관된 저장소의 계정 소유자 이름을 지정합니다. (예시: “abc”).
  • repo (string, 필수): 저장소 - 이 릴리스와 연관된 저장소 이름을 지정합니다.
  • id (string, 필수): 릴리스 ID - 조회할 릴리스의 ID를 지정합니다.
설명: GitHub에서 태그 이름으로 릴리스를 조회합니다.파라미터:
  • owner (string, 필수): 소유자 - 이 릴리스와 연관된 저장소의 계정 소유자 이름을 지정합니다. (예시: “abc”).
  • repo (string, 필수): 저장소 - 이 릴리스와 연관된 저장소 이름을 지정합니다.
  • tag_name (string, 필수): 이름 - 가져올 릴리스의 태그를 지정합니다. (예시: “v1.0.0”).
설명: GitHub에서 릴리스를 삭제합니다.파라미터:
  • owner (string, 필수): 소유자 - 이 릴리스와 연관된 저장소의 계정 소유자 이름을 지정합니다. (예시: “abc”).
  • repo (string, 필수): 저장소 - 이 릴리스와 연관된 저장소 이름을 지정합니다.
  • id (string, 필수): 릴리스 ID - 삭제할 릴리스의 ID를 지정합니다.

사용 예시

기본 GitHub 에이전트 설정

특정 GitHub 도구 필터링

릴리즈 관리

이슈 추적 및 관리

도움 받기

도움이 필요하신가요?

GitHub 통합 설정 또는 문제 해결에 대해 지원팀에 문의하세요.