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 커넥터 |