Azure SRE 에이전트에서 지식을 연계

Azure SRE 에이전트는 팀에서 시스템 문제를 해결하는 데 사용하는 것과 동일한 컨텍스트를 사용할 수 있을 때 더 효과적입니다. 에이전트가 처음부터 시작하는 대신 조사 중에 참조할 수 있도록 Runbook, 설명서, 웹 페이지 및 리포지토리를 연결합니다.

팁 (조언)

  • Builder > 기술 자료를 사용하여 파일, 웹 페이지 및 리포지토리를 한 곳에서 관리합니다.
  • 인덱싱된 지식은 조사 및 채팅 중에 자동으로 사용할 수 있습니다.
  • 문서를 직접 업로드하거나, 채팅에서 파일을 첨부하거나, 원본 인식 분석을 위해 리포지토리를 연결할 수 있습니다.
  • 가장 유용한 기술 자료는 Runbook, 아키텍처 노트, 문제 해결 가이드 및 소스 코드와 같이 팀이 이미 사용하는 정보입니다.

지식이 중요한 이유

에이전트에는 관찰 도구 및 연결된 시스템을 통해 기본 제공 Azure 컨텍스트가 이미 있습니다. 기본적으로 없는 것은 팀의 내부 지식입니다. 이 지식에는 일반적인 복구 단계를 설명하는 Runbook, 공유 종속성을 식별하는 아키텍처 노트 또는 회귀를 도입한 배포를 표시하는 리포지토리가 포함됩니다.

해당 지식을 연결할 때 에이전트는 다음을 수행할 수 있습니다.

  • 사고 발생 시 팀 운영 절차서를 참조하세요.
  • 팀이 이미 문서화한 문제 해결 단계를 다시 사용합니다.
  • 증상과 소스 코드 및 배포 컨텍스트의 상관 관계를 지정합니다.
  • 사용자가 사용하는 것과 동일한 문서 및 참조를 사용하여 질문에 답변합니다.

지식 베이스에서 지식 관리

Builder > 기술 자료를 사용하여 에이전트의 기술 자료를 관리합니다.

페이지에는 각 소스에 대해 다음 항목이 표시됩니다:

  • Name
  • Status
  • Type
  • 마지막으로 수정한 날짜

세 가지 원본 유형을 사용할 수 있습니다.

원본 유형 제공하는 내용 추가하는 방법
Files 운영 절차서, 문제 해결 가이드, 아키텍처 문서 및 참조 자료 포털을 통해 업로드하거나 채팅 중에 에이전트에게 문서를 저장하도록 요청합니다.
웹 페이지 외부 설명서, 내부 위키 URL 및 상태 페이지 에이전트가 콘텐츠를 인덱싱할 수 있도록 페이지 URL 추가
저장소 소스 코드, 배포 파일 및 인프라 정의 GitHub 또는 Azure DevOps 리포지토리 연결

인덱싱 상태 및 새로 고침 확인

각 기술 원본은 다음 상태 중 하나를 보여줍니다.

상태 Meaning
색인됨 콘텐츠가 처리되고 검색 가능
보류 중 콘텐츠가 여전히 처리되고 있습니다.
인덱싱되지 않음 처리에 실패했거나 원본을 인덱싱할 수 없습니다.

소스가 인덱싱되면 상태 표시기에 마우스를 올려 생성 시간 타임스탬프를 확인합니다. 이 타임스탬프는 최신 버전의 Runbook 또는 문서가 처리되고 있는지 확인하려는 경우에 유용합니다.

문서 업로드

향후 대화에서 지식을 계속 사용할 수 있게 하려면 문서를 업로드합니다.

일반적인 예는 다음과 같습니다.

  • 인시던트 Runbook
  • 에스컬레이션 가이드
  • 아키텍처 참조
  • 문제 해결을 위한 체크리스트

포털을 통해 파일을 업로드하거나 에이전트에게 대화의 콘텐츠를 기술 자료에 저장하도록 요청할 수 있습니다.

지원되는 파일 형식 및 제한은 기술 문서 업로드를 참조하세요.

전체 워크플로는 기술 문서 업로드를 참조하세요.

채팅에서 파일 공유

단일 대화에서 에이전트에 즉각적인 컨텍스트를 제공하려는 경우 채팅 첨부 파일을 사용합니다. 이 방법은 활성 문제 해결에 도움이 되는 스크린샷, 로그, 구성 파일 및 기타 자료에 유용합니다.

팁 (조언)

채팅에서 첨부하는 파일이 장기적인 지식이 되어야 하는 경우 에이전트에게 기술 설정에 저장하도록 요청합니다. 에이전트는 콘텐츠를 인덱싱하고 이후 대화에서 검색할 수 있도록 복사본을 업로드할 수 있습니다.

다음 표에서는 장기 지식 업로드와 임시 채팅 첨부 파일을 비교합니다.

Scenario 기술 자료에 업로드 채팅에서 공유
최적입니다 향후 대화에서 사용할 수 있는 런북, 절차 및 문서 에이전트가 지금 분석할 파일
스토리지 범위 에이전트 수준 및 향후 대화에서 검색 가능 스레드 수준 및 현재 대화에서 사용 가능
추가하는 방법 포털에서 업로드하거나 에이전트에 콘텐츠 저장 요청 드래그 앤 드롭, 클립보드에서 붙여넣기 또는 채팅에서 + 사용
장기 지식이 될 수 있습니다. 이미 장기적으로 축적된 지식 예, 에이전트에 저장하도록 요청하는 경우

자세한 내용은 채팅에서 파일 공유를 참조하세요.

웹 페이지 추가

중요한 지침이 업로드된 파일 또는 리포지토리 외부에 있는 경우 웹 페이지를 추가합니다.

적합한 후보는 다음과 같습니다.

  • 내부 위키 문서
  • 퍼블릭 제품 설명서
  • 서비스 상태 페이지
  • 팀에서 유지 관리하는 참조 페이지

URL을 추가한 후 에이전트는 이후 조사 중에 해당 정보를 참조할 수 있도록 페이지 콘텐츠를 인덱싱합니다.

리포지토리 연결

에이전트에 소스 인식 컨텍스트가 필요한 경우 GitHub 또는 Azure DevOps 리포지토리를 연결하세요.

연결된 리포지토리는 에이전트를 지원합니다.

  • 소스 코드에서 오류 패턴 검색
  • 최근 코드 변경 내용과 인시던트 상관 관계 지정
  • 배포 및 구성 파일 참조
  • 근본 원인 분석 중에 리포지토리 콘텐츠 사용

소스 코드를 연결하려면 소스 코드 연결을 참조하세요.

올바른 지식 원본 선택

필요한 컨텍스트 종류와 일치하는 소스 형식을 사용합니다.

연결해야 하는 경우... 사용하세요...
파일로 저장된 운영 절차서 또는 문제 해결 가이드 기술 문서 업로드
진행 중인 조사 한 건에 대한 스크린샷, 로그 또는 파일 채팅에서 파일 공유
GitHub 또는 Azure DevOps 리포지토리 소스 코드 연결
Datadog 또는 Splunk와 같은 외부 시스템 MCP 커넥터