자습서: Azure SRE 에이전트에서 기술 문서 업로드

이 자습서에서는 향후 조사 중에 참조할 수 있도록 Azure SRE 에이전트에 기술 문서를 업로드합니다. 채팅을 통해 조사 결과를 지식 설정에 직접 저장하는 방법과 포털 UI를 통해 기존 파일을 업로드하는 방법을 알아봅니다.

이 튜토리얼에서는 다음을 배우게 됩니다:

예상 시간: 10분

사전 요구 사항

• 실행 중인 상태의 Azure SRE 에이전트
• 에이전트에 대한 쓰기 권한 부여
• 검토 또는 자율으로 설정된 에이전트 실행 모드

1단계: 조사 시작

최고의 지식 문서는 실제 조사에서 제공됩니다. 콘텐츠를 처음부터 만드는 대신 에이전트가 이미 학습한 내용을 캡처합니다.

1. sre.azure.com 이동하여 에이전트를 선택합니다.
2. 채팅의 왼쪽 사이드바에서 이전 조사 스레드(에이전트가 문제를 진단하거나 해결한 대화)를 찾아 선택합니다.

조사 스레드가 아직 없는 경우 새 채팅을 시작하고 에이전트에게 다음 사항을 조사하도록 요청합니다.

Investigate high memory usage on our container apps

조사가 완료되기를 기다린 다음 2단계를 계속 진행합니다.

2단계: 에이전트에 Runbook 만들기 요청

동일한 조사 스레드에서 에이전트에게 조사 결과를 Runbook으로 변환하고 기술 자료 설정에 저장하도록 요청합니다. 파일 이름에 대해 구체적으로 설명합니다.

Create a runbook from the investigation we just did. Include the root cause
analysis, the diagnostic steps, mitigations, and escalation triggers.
Save it to Knowledge settings as high-memory-runbook.md

에이전트:

1. 조사 컨텍스트를 구조화된 Runbook으로 통합합니다.
2. 근본 원인 분석, 진단 단계, 완화 및 에스컬레이션 트리거와 같은 섹션을 생성합니다.
3. 문서를 기술 자료 설정에 저장하고 업로드를 확인합니다.

에이전트는 문서가 저장되었는지 확인하고 다운로드 링크를 제공합니다. Runbook이 이제 지식 설정 옵션에 저장되고 검색 가능하도록 인덱싱됩니다.

체크포인트

• 에이전트가 조사에서 구조화된 런북을 생성했습니다.
• 에이전트가 문서가 저장되었음을 확인했습니다.

3단계: 지식 설정에서 확인

1. 왼쪽 사이드바에서 작성 기를 선택하여 섹션을 확장합니다.
2. 기술 자료 설정을 선택합니다.

기술 정보 설정 페이지에는 파일 이름, 상태, 형식 및 마지막으로 수정한 열이 있는 표에 문서가 표시됩니다. 상태 열은 문서가 인덱싱되고 검색할 준비가 되면 인덱싱된 ✓를 표시합니다.

상태가 보류 중으로 표시되면 새로 고침을 선택합니다. 인덱싱은 일반적으로 몇 초 내에 완료됩니다.

체크포인트

• 작성기 → 기술 설정으로 이동
• ✓ 인덱싱된 상태로 문서가 나타납니다.

4단계: 포털을 통해 파일 업로드

개별 파일 또는 전체 폴더를 직접 업로드할 수 있습니다. 이 방법은 팀이 이미 가지고 있는 기존 Runbook, 설명서 또는 참조 자료에 유용합니다.

개별 파일 업로드

1. 기술 자료 페이지에서 파일 추가를 선택합니다.
2. 파일을 드롭 영역으로 끌어다 놓거나 파일 찾아보기를 선택하세요.
3. 업로드할 파일 추가 를 선택합니다.

폴더 업로드

중첩된 하위 폴더를 포함하여 전체 폴더를 드롭 영역으로 끌 수도 있습니다.

1. 기술 자료 페이지에서 파일 추가를 선택합니다.
2. 파일 관리자에서 드롭 영역으로 직접 폴더를 끌어옵니다.
3. 포털은 폴더 및 해당 하위 폴더에서 지원되는 모든 파일을 추출한 다음 대화 상자에 나열합니다.
4. 파일 목록을 검토합니다. 각 파일 옆에 있는 삭제 아이콘을 선택하여 원하지 않는 파일을 제거합니다.
5. 파일 추가를 선택하여 나열된 모든 파일을 업로드합니다.

포털은 지원되지 않는 확장이 있는 파일을 자동으로 필터링합니다. 지원되는 확장 및 크기 제한의 전체 목록은 기술 문서 업로드 기능 페이지를 참조하세요.

최대 파일 크기는 파일당 16MB이며 업로드당 최대 100MB입니다.

체크포인트

• 파일 추가를 선택하고 업로드 대화 상자를 보았습니다.
• 파일을 업로드하거나 폴더를 성공적으로 끌어갔습니다.
• 파일은 ✓ 인덱싱된 상태의 지식 원본에 표시됩니다.

5단계: 새 대화에서 검색 테스트

새 채팅 스레드를 시작하고 업로드된 문서가 대답해야 하는 질문을 합니다.

What are the steps for troubleshooting high memory usage on container apps?

에이전트가 지식 설정을 검색한 뒤, 업로드한 런북을 찾아 응답에서 이를 참고합니다. 이 프로세스는 지식이 인덱싱되고 검색 가능한지 확인합니다.

체크포인트

• 새 채팅 스레드 시작
• 업로드된 콘텐츠와 관련된 질문
• 에이전트가 해당 응답에서 업로드된 문서를 참조했습니다.

기술 문서 삭제

1. 작성기 → 지식 설정으로 이동합니다.
2. 문서 목록에서 확인란을 사용하여 하나 이상의 문서를 선택합니다.
3. 도구 모음에서 삭제 를 선택합니다.
4. 제거할 문서가 확인 대화 상자에 나열됩니다. 삭제를 선택하여 확인합니다.

문서를 삭제하면 에이전트의 지식 설정에서 문서가 제거되며 검색 결과에 더 이상 표시되지 않습니다.

학습 내용

• 에이전트는 실제 조사를 구조화된 런북으로 전환하여 지식 설정에 저장할 수 있습니다.
• Builder → Knowledge 설정에서 포털 UI를 통해 수동으로 파일을 업로드할 수 있습니다. PDF, Office 문서 및 이미지를 비롯한 다양한 형식을 지원합니다.
• 시스템은 의미 체계 검색을 위해 업로드된 문서를 인덱싱하며 향후 모든 대화에서 사용할 수 있습니다.
• 문서를 업데이트하려면 동일한 파일 이름을 사용하여 업로드합니다.

Troubleshooting

Related