이 자습서에서는 향후 조사 중에 참조할 수 있도록 Azure SRE 에이전트에 기술 문서를 업로드합니다. 채팅을 통해 조사 결과를 지식 설정에 직접 저장하는 방법과 포털 UI를 통해 기존 파일을 업로드하는 방법을 알아봅니다.
이 튜토리얼에서는 다음을 배우게 됩니다:
- 조사를 재사용 가능한 러너북으로 전환하고 지식 설정에 저장하세요.
- 업로드된 콘텐츠가 인덱싱되고 검색 가능한지 확인합니다.
- 포털을 통해 개별 파일 또는 폴더 업로드
- 에이전트가 새 대화에서 업로드된 콘텐츠를 검색할 수 있도록 테스트
예상 시간: 10분
사전 요구 사항
- 실행 중인 상태의 Azure SRE 에이전트
- 에이전트에 대한 쓰기 권한 부여
- 검토 또는 자율으로 설정된 에이전트 실행 모드
1단계: 조사 시작
최고의 지식 문서는 실제 조사에서 제공됩니다. 콘텐츠를 처음부터 만드는 대신 에이전트가 이미 학습한 내용을 캡처합니다.
- sre.azure.com 이동하여 에이전트를 선택합니다.
- 채팅의 왼쪽 사이드바에서 이전 조사 스레드(에이전트가 문제를 진단하거나 해결한 대화)를 찾아 선택합니다.
조사 스레드가 아직 없는 경우 새 채팅을 시작하고 에이전트에게 다음 사항을 조사하도록 요청합니다.
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
에이전트:
- 조사 컨텍스트를 구조화된 Runbook으로 통합합니다.
- 근본 원인 분석, 진단 단계, 완화 및 에스컬레이션 트리거와 같은 섹션을 생성합니다.
- 문서를 기술 자료 설정에 저장하고 업로드를 확인합니다.
에이전트는 문서가 저장되었는지 확인하고 다운로드 링크를 제공합니다. Runbook이 이제 지식 설정 옵션에 저장되고 검색 가능하도록 인덱싱됩니다.
체크포인트
- 에이전트가 조사에서 구조화된 런북을 생성했습니다.
- 에이전트가 문서가 저장되었음을 확인했습니다.
3단계: 참조 자료 원본에서 검증
- 왼쪽 사이드바에서 Build + Setup을 선택한 후 Context를 펼치세요.
- 참조 자료 원본을 선택합니다.
지식 소스 페이지에는 문서가 이름, 상태, 유형, 마지막 수정 열이 있는 표로 표시됩니다. 상태 열은 문서가 인덱싱되고 검색할 준비가 되면 인덱싱된 ✓를 표시합니다.
상태가 Pending로 표시되면 인덱싱이 완료될 때까지 기다렸다가 필요하면 페이지를 다시 불러오세요.
체크포인트
- 빌드 + 설정 > 컨텍스트 > 지식 소스로 탐색함
- ✓ 인덱싱된 상태로 문서가 나타납니다.
4단계: 포털을 통해 파일 업로드
개별 파일 또는 전체 폴더를 직접 업로드할 수 있습니다. 이 방법은 팀이 이미 가지고 있는 기존 Runbook, 설명서 또는 참조 자료에 유용합니다.
개별 파일 업로드
- 기술 자료 페이지에서 파일 추가를 선택합니다.
- 파일을 드롭 영역으로 끌어다 놓거나 파일 찾아보기를 선택하세요.
- 업로드할 파일 추가 를 선택합니다.
폴더 업로드
중첩된 하위 폴더를 포함하여 전체 폴더를 드롭 영역으로 끌 수도 있습니다.
- 기술 자료 페이지에서 파일 추가를 선택합니다.
- 파일 관리자에서 드롭 영역으로 직접 폴더를 끌어옵니다.
- 포털은 폴더 및 해당 하위 폴더에서 지원되는 모든 파일을 추출한 다음 대화 상자에 나열합니다.
- 파일 목록을 검토합니다. 각 파일 옆에 있는 삭제 아이콘을 선택하여 원하지 않는 파일을 제거합니다.
- 파일 추가를 선택하여 나열된 모든 파일을 업로드합니다.
포털은 지원되지 않는 확장이 있는 파일을 자동으로 필터링합니다. 지원되는 확장 및 크기 제한의 전체 목록은 기술 문서 업로드 기능 페이지를 참조하세요.
최대 파일 크기는 파일당 16MB이며 업로드당 최대 100MB입니다.
메모
폴더를 업로드할 때 포털은 폴더 구조를 유지하지 않습니다. 하위 폴더의 파일은 개별 문서로 표시됩니다. 다른 하위 폴더의 파일이 동일한 이름을 공유하는 경우 첫 번째 파일만 업로드됩니다.
체크포인트
- 파일 추가를 선택하고 업로드 대화 상자를 보았습니다.
- 파일을 업로드하거나 폴더를 성공적으로 끌어갔습니다.
- 파일은 ✓ 인덱싱된 상태의 지식 원본에 표시됩니다.
5단계: 새 대화에서 검색 테스트
새 채팅 스레드를 시작하고 업로드된 문서가 대답해야 하는 질문을 합니다.
What are the steps for troubleshooting high memory usage on container apps?
에이전트가 지식 소스를 검색하고, 업로드한 런북을 찾아 응답에서 참고합니다. 이 프로세스는 지식이 인덱싱되고 검색 가능한지 확인합니다.
체크포인트
- 새 채팅 스레드 시작
- 업로드된 콘텐츠와 관련된 질문
- 에이전트가 해당 응답에서 업로드된 문서를 참조했습니다.
기술 문서 삭제
- 빌드 + 설정>컨텍스트>참조 자료 원본으로 이동하세요.
- 문서 목록에서 확인란을 사용하여 하나 이상의 문서를 선택합니다.
- 도구 모음에서 삭제 를 선택합니다.
- 제거할 문서가 확인 대화 상자에 나열됩니다. 삭제를 선택하여 확인합니다.
문서를 삭제하면 에이전트의 지식 설정에서 문서가 제거되며 검색 결과에 더 이상 표시되지 않습니다.
메모
현재 위치에서는 기술 문서를 편집할 수 없습니다. 문서를 업데이트하려면 동일한 파일 이름으로 새 버전을 업로드합니다. 새 버전은 이전 버전을 대체합니다.
학습 내용
- 에이전트는 실제 조사를 구조화된 런북으로 전환하여 지식 설정에 저장할 수 있습니다.
- Build + Setup>Context>Knowledge sources의 포털 UI를 통해 파일을 수동으로 업로드할 수 있습니다. PDF, Office 문서 및 이미지를 비롯한 다양한 형식을 지원합니다.
- 시스템은 의미 체계 검색을 위해 업로드된 문서를 인덱싱하며 향후 모든 대화에서 사용할 수 있습니다.
- 문서를 업데이트하려면 동일한 파일 이름을 사용하여 업로드합니다.
Troubleshooting
| 오류 | 원인 | 수정 |
|---|---|---|
| "에이전트 메모리를 사용할 수 없습니다. 문서를 업로드할 수 없습니다." | 에이전트에서 지식 설정이 활성화되지 않음 | 관리자에게 문의하여 지식 설정을 활성화하세요. |
| "기술 설정에 대한 쓰기 권한이 없습니다." | 에이전트가 업로드 도구를 찾을 수 없습니다. | 요청을 "filename.md로 Knowledge 설정에 저장"으로 다시 작성하세요. |
| "파일 확장명은 잘못되었습니다. .md 및 .txt 파일만 허용됩니다." | 파일 이름이 .md 또는 .txt로 끝나지 않음 (채팅 업로드) |
에이전트에 저장을 요청할 때 A .md 또는 .txt 확장 사용 |
| "문서 콘텐츠가 최대 크기 16MB를 초과합니다." | 단일 문서에 비해 콘텐츠가 너무 큽 | 여러 작은 문서로 분할 |
| "파일 이름은 비워 둘 수 없습니다." | 파일 이름이 제공되지 않음 | 프롬프트에 파일 이름 포함(예: runbook.md) |
Related
| Resource | 학습 내용 |
|---|---|
| 기술 문서 업로드 | 이것이 작동하는 방식과 중요한 이유 |
| 기술 만들기 | 지식 문서를 보완하는 절차적 기술 빌드 |
| 기술 | 기술과 지식이 함께 작동하는 방법 |
| ADO wiki 지식 | 라이브 위키 콘텐츠를 지식 원본으로 연결 |