GitHub 커넥터를 사용하여 github.com 에이전트에 연결하여 문제, 끌어오기 요청 및 워크플로를 관리합니다. 포털에서 Builder > Connectors를 통해 커넥터 를 구성합니다.
메모
이 자습서에서는 문제, PR 및 워크플로 작업에 대한 GitHub 커넥터에 대해 설명합니다. 조사 중 코드 컨텍스트는 소스 코드 연결을 참조하세요. GitHub Enterprise Cloud는 GitHub Enterprise Cloud 연결 참조하세요.
사전 요구 사항
- 실행 중인 상태의 활성 에이전트
- 에이전트가 사용할
github.com리포지토리에 대한 액세스 - 에이전트 역할: 관리자 또는 표준 사용자
GitHub 커넥터 설정 열기
- 포털에서 에이전트를 엽니다.
- Builder > 커넥터로 이동합니다.
- 커넥터 추가를 선택합니다.
- GitHub OAuth 커넥터 선택합니다.
인증 방법 선택
다음 방법 중 하나를 선택합니다.
| Method | 사용 시기 |
|---|---|
| OAuth | 사용자 기반 액세스를 위한 대화형 설정 |
| 팻 | 서비스 계정 또는 비대화형 설정 |
OAuth 흐름
- OAuth를 선택합니다.
- GitHub에 로그인을 선택합니다.
- GitHub 팝업 권한 부여를 완료합니다.
- 상태가 연결됨으로 표시되는지 확인합니다.
PAT 흐름
- PAT를 선택합니다.
- 필요한 범위가 있는 GitHub 토큰을 붙여넣습니다.
- 연결을 선택합니다.
- 상태가 연결됨으로 표시되는지 확인합니다.
GitHub 커넥터 런타임 작업 확인
커넥터를 저장한 후 채팅 프롬프트를 사용하여 테스트합니다.
List recent issues from owner/repo and summarize the top 3 risks.
최종 검사점으로 직접 확인 프롬프트를 사용합니다.
Get me recent issues from owner/repo.
작업별 필수 권한
| Operation | OAuth/PAT 최소값 |
|---|---|
| 리포지토리 메타데이터/콘텐츠 읽기 |
repo 프라이빗 리포지토리의 경우(public_repo 공용 전용) |
| 문제 나열 또는 만들기 | 문제 생성이 가능한 리포지토리 접근 |
| 끌어오기 요청 작업 | PR 가능한 리포지토리 접근 권한 |
연결 문제 해결
| 증상 | 가능한 원인 | 수정 |
|---|---|---|
| 커넥터가 연결 끊김 상태로 표시됨 | 토큰이 만료되었거나 해지됨 | OAuth 재인증 또는 PAT 교체 |
| 이슈 읽기는 작동하지만 PR 작업은 실패합니다 | PR 권한이 없습니다. | PR 권한 부여 및 다시 시도 |
| 커넥터가 프라이빗 리포지토리에 액세스할 수 없습니다. | 토큰 범위가 너무 좁습니다. | 비공개 리포지토리에 repo 스코프 사용 |
| 팝업이 열리지 않음 | 브라우저 팝업이 차단됨 | 포털 도메인에 대한 팝업 허용 |