3단계: Azure SRE 에이전트에서 소스 코드 연결

GitHub 또는 Azure DevOps 리포지토리를 연결합니다. 이제 에이전트는 프로덕션 문제와 특정 코드의 상관 관계를 지정하여 근본 원인 분석을 수행할 수 있습니다.

달성한 작업

이 단계가 끝날 때까지 에이전트는 다음을 수행합니다.

  • 조사 중 소스 코드 분석
  • 문제에 대한 파일:라인 참조 제공
  • 조사 단계를 표시하는 To-Do 계획을 만듭니다.
  • 프로덕션 증상과 코드 변경의 상관 관계

사전 요구 사항

요구 사항 세부 정보
에이전트 생성됨 먼저 1단계 완료
GitHub 또는 Azure DevOps 계정 연결하려는 리포지토리에 대한 액세스

인증 방법 선택

메서드 사용 시기
GitHub 앱 조직 관리 앱과 Key Vault 기반 서명 키를 사용하세요. *.ghe.com에 필요합니다.
관리되는 ID 장기간 유효한 사용자 자격 증명 없이 Azure DevOps를 연결하세요.
OAuth GitHub 또는 Azure DevOps 계정으로 로그인합니다.
PAT 대상 서비스가 요구하는 최소 권한을 가진 개인 액세스 토큰을 제공하세요.

리포지토리 연결

에이전트가 이를 지식 원본으로 인덱싱할 수 있도록 GitHub 리포지토리를 연결합니다. 대화 상자에는 리포지토리의 검색 가능한 목록이 표시됩니다. URL을 수동으로 입력하는 대신 드롭다운에서 선택합니다.

1단계: 리포지토리 추가 대화 상자 열기

온보딩하는 동안 기술 자료 단계에서 리포지토리 카드 추가 를 선택합니다.

기존 에이전트의 경우, Build + Setup>Context>Code access로 가서 서비스 탭을 선택한 후 저장소 추가를 선택하세요.

2단계: 플랫폼 선택

  1. GitHub 또는 Azure DevOps 선택합니다.

  2. 연결 단계에서 GitHub의 전체 저장소 URL이나 Azure DevOps의 조직 이름을 입력하세요.

  3. 기존 연결이 있다면 선택하거나, 새 연결을 설정하세요.

  4. 인증 방법을 선택하고 해당 필드를 완료하세요. GitHub는 OAuth, 개인 액세스 토큰(PAT),그리고 Use Your GitHub 앱을 제공합니다. Azure DevOps는 사용자 계정, 관리 ID 및 PAT를 제공합니다.

  5. 선택한 방법으로 표시된 로그인 또는 연결 테스트를 완료하세요. 메서드별 지침은 소스 코드 서비스 연결(Connect a source code service)을 참조하세요.

    메모

    로그인 대화상자가 나타나지 않으면, 브라우저에서 sre.azure.com의 팝업이 차단되지 않았는지 확인하세요.

  6. 연결 성공을 확인합니다.

  7. 다음을 선택합니다.

3단계: 리포지토리 선택

저장소 추가에서 초기 저장소를 검토하고 필요에 따라 항목을 추가하세요. 저장소 URL 필드는 저장소 선택과 직접 URL 입력을 지원합니다:

  • GitHub 리포지토리는 사전순으로 정렬된 것으로 org/repo-name표시됩니다(최대 100개의 리포지토리).

  • Azure DevOps Project 드롭다운에서 프로젝트를 선택하면 Azure DevOps 리포지토리가 사전순으로 정렬되어 표시됩니다.

드롭다운에서 리포지토리를 선택합니다. 표시 이름은 리포지토리 이름으로 자동 완성됩니다. 유효한 리포지토리 URL을 필드에 직접 입력할 수도 있습니다.

GitHub에서는 항목을 추가하려면 저장소 추가를 선택하세요. 각 항목을 확장하여 표시 이름을 편집하거나 설명 추가를 사용하세요. Azure DevOps의 경우, Add를 사용하고 그리드에서 해당 필드를 편집하세요.

팁 (조언)

드롭다운에서는 자유형 입력을 허용합니다. 리포지토리가 목록에 표시되지 않는 경우(예: 리포지토리가 100개를 초과하는 경우) 전체 URL을 직접 입력합니다.

4단계: 확인 및 저장

저장을 선택합니다. 저장소들은 코드 접근 페이지에 연결 및 마지막 동기화 정보와 함께 나타납니다.

5단계: 끌어오기 요청 만들기(미리 보기)

리포지토리가 연결되면 이제 에이전트가 채팅에서 직접 끌어오기 요청을 만들 수 있습니다.

  1. 에이전트를 사용하여 채팅 스레드를 엽니다.
  2. 다음과 같은 프롬프트를 입력합니다. "fix/my-branch에서 메인으로 '연결 시간 초과 수정'이라는 제목의 PR을 https://github.com/OWNER/REPO에 만들어줘."
  3. 검토 모드에서 계속 을 선택하여 PR 만들기를 승인합니다.

에이전트는 만든 PR에 대한 클릭 가능한 링크가 있는 도구 카드를 반환합니다.

메모

끌어오기 요청을 만들려면 검토 또는 자율 실행 모드가 필요합니다. 소스 브랜치는 당신의 변경 사항이 커밋된 상태에서 이미 존재하고 있어야 합니다.

연결된 리포지토리 관리

코드 접근 페이지에는 연결된 저장소와 그 연결 이름이 나열되어 있습니다.

리포지토리를 제거하려면:

다음 단계를 사용하여 연결된 리포지토리를 제거합니다.

  1. 빌드 + 설정>컨텍스트>코드 액세스로 이동하세요.
  2. 서비스 탭에서 저장소의 체크박스를 선택하세요.
  3. 삭제를 선택하고 확인 내용을 검토한 후 진행하세요.

인증을 업데이트하려면 다음을 수행합니다 . PAT가 만료되거나 계정을 전환해야 하는 경우 리포지토리 추가 대화 상자를 다시 열고 새 자격 증명으로 다시 인증합니다.


대안: MCP + 사용자 지정 에이전트

전체 GitHub API 액세스(모든 리포지토리에서 코드 검색, 파일 읽기 및 커밋 나열)를 가져오려면 전용 사용자 지정 에이전트를 사용하여 GitHub를 MCP 서버로 연결합니다.

이 방법은 MCP(모델 컨텍스트 프로토콜)를 사용하여 GitHub 도구를 사용자 지정 에이전트에 연결합니다. 단계별 자습서인 MCP 커넥터 설정에 따릅니다.

이제 에이전트는 조사 중에 소스 코드를 분석하고, 문제에 대한 파일 및 줄 참조를 제공하고, 조사 단계를 보여 주는 할 일 계획을 만들고, 프로덕션 증상과 코드 변경의 상관 관계를 지정하며, 채팅에서 직접 연결된 리포지토리에 끌어오기 요청을 만들 수 있습니다.

학습 내용

  • 이제 에이전트가 조사 중에 소스 코드를 분석합니다.
  • 문제에 대한 파일 및 줄 참조를 제공합니다.
  • 조사 단계를 표시하는 To-Do 계획을 만듭니다.
  • 프로덕션 증상과 코드 변경의 상관 관계를 지정합니다.

Resource Description
근본 원인 분석 에이전트가 소스 코드를 사용하여 근본 원인을 찾는 방법입니다.
심층 조사 연결된 리포지토리를 사용하여 확장된 다중 가설 분석
에이전트 플레이그라운드 MCP 도구 및 사용자 지정 에이전트를 대화형으로 테스트합니다.
사용자 지정 에이전트 사용자 지정 에이전트가 에이전트의 기능을 확장하는 방법
커넥터 모든 커넥터 유형 및 작동 방식