GitHub를 자율 AI 에이전트에 연결하기

가능한 워크플로우

커넥터 작업

• list_issues (읽기)

  저장소의 열린 이슈 목록을 조회합니다.

• get_pull_request (읽기)

  풀 리퀘스트의 세부 정보를 확인합니다.

• list_workflow_runs (읽기)

  Actions 워크플로의 최근 실행 내역을 조회합니다.

• get_workflow_run (읽기)

  워크플로 실행 하나의 세부 정보를 확인합니다.

• get_job_logs_download_url (읽기)

  작업 로그의 URL을 가져옵니다.

• list_releases (읽기)

  이미 게시된 릴리스 목록을 조회합니다.

• create_label (쓰기)

  저장소에 새 라벨을 생성합니다.

• update_issue (쓰기)

  이슈의 라벨, 상태, 담당자를 수정합니다.

• add_issue_comment (쓰기)

  이슈에 댓글을 추가합니다.

• create_branch (쓰기)

  참조로부터 브랜치를 생성합니다.

• create_or_update_file (쓰기)

  커밋 메시지와 함께 파일을 생성하거나 수정합니다.

• create_pull_request (쓰기)

  한 브랜치에서 다른 브랜치로 풀 리퀘스트를 엽니다.

• create_review_request (쓰기)

  한 명 이상에게 리뷰를 요청합니다.

• create_release (쓰기)

  태그와 노트를 포함한 릴리스를 게시합니다.

사전 요구 사항

• 대상 저장소에 쓰기 권한이 있는 GitHub 계정이 필요합니다.
• Settings, Developer settings, Personal access tokens에서 생성한 fine-grained 토큰이 필요합니다.
• Contents, Issues, Pull requests는 Read and write, Actions는 Read 권한이 필요합니다.
• Atako의 설정, 연동에 토큰을 붙여넣어야 합니다.
• 명시적인 grant(에이전트, 연결, 정확한 액션과 범위)가 필요합니다.

연결 방법

1. 1

   GitHub에서 fine-grained 토큰 생성

   Settings, Developer settings, Personal access tokens, Fine-grained tokens, Generate new token 순으로 이동합니다. Contents, Issues, Pull requests는 쓰기로, Actions는 읽기로 체크한 뒤 표시된 토큰을 복사합니다.

2. 2

   Atako에 토큰 연결

   설정, 연동에 토큰을 붙여넣습니다. 이 연결은 모든 에이전트에서 사용할 수 있게 됩니다.

3. 3

   에이전트에 grant 부여

   에이전트 페이지에서 정확한 GitHub 액션과 그 범위를 선택합니다. 기본값은 deny-by-default이며, 아무것도 접근할 수 없는 상태에서 시작합니다.

4. 4

   첫 시나리오 실행

   부여된 grant에 따라 에이전트는 이슈를 조회하거나, 풀 리퀘스트를 열거나, CI 실행을 감시하며, 사람의 판단이 필요하면 알립니다.