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

문제: 대화로 지식이 죽는다

팀이 해결하는 모든 인시던트에는 무엇이 잘못되었는지, 어떤 명령이 수정되었는지, 다음에 먼저 확인해야 할 사항과 같은 중요한 지식이 생성됩니다. 그러나 그 지식은 채팅 스레드, 엔지니어의 기억, 그리고 아무도 오전 3시에 읽지 않는 사후 분석에 존재합니다.

팀에는 운영 절차서가 있지만, 그것들이 낡았습니다. 어젯밤 사건 중에 발견 된 수정 사항? 누군가의 머릿속에 남아 있거나, 다음 주면 화면 밖으로 사라져 버릴 대화 속에 묻혀 있을 뿐이다. 다음에 동일한 문제가 발생할 때 다른 엔지니어가 처음부터 시작합니다.

에이전트가 이 문제를 해결하는 방법

에이전트는 기술 문서 업로드 도구를 사용하여 대화 중에 기술 자료 설정에 문서를 업로드 할 수 있습니다. 에이전트가 수정 사항을 검색하거나, 문제 해결 가이드를 만들거나, 조사 결과를 합성하면 해당 지식을 직접 저장하고 향후 모든 대화에서 검색할 수 있습니다.

"Create a runbook from the steps we just followed to fix this database
connection pool exhaustion issue and save it to Knowledge settings."

에이전트가 구조화된 런북을 생성한 후 몇 초 안에 업로드합니다. 문서는 자동으로 인덱싱되며 향후 조사를 검색할 수 있게 됩니다.

이전 및 이후

이것이 다른 이유

수동 업로드와 달리 에이전트는 사전에 지식을 만듭니다. 에이전트가 대화의 일부로 수행하므로 배운 내용을 문서화할 필요가 없습니다.

채팅 기록과 달리 업로드된 문서는 의미 체계 검색을 위해 인덱싱됩니다. 몇 달 후에 비슷한 문제가 발생하면 에이전트는 이전 스레드를 스크롤하는 대신, 지능형 검색 기능을 통해 자동으로 관련 런북을 찾아냅니다.

위키 커넥터와 달리 업로드된 문서에는 외부 서비스가 필요하지 않습니다. 지식은 에이전트의 지식 설정에 직접 저장되며, 동기화 지연 없이 즉시 사용할 수 있습니다.

작동 방식

기술 문서 업로드 도구는 다음 세 가지 매개 변수를 허용합니다.

에이전트가 문서를 업로드하는 경우:

1. 파일 이름 및 콘텐츠의 유효성을 검사합니다(파일당 최대 16MB).
2. 에이전트의 기술 자료 설정에 문서를 저장합니다.
3. 의미 체계 검색을 위해 콘텐츠를 인덱싱합니다.
4. 성공 메시지를 사용하여 업로드를 확인합니다.

지원되는 파일 형식

에이전트는 각각 다른 형식을 지원하는 세 가지 방법을 통해 파일을 처리합니다.

채팅 첨부 파일

에이전트가 즉각적으로 분석할 수 있는 컨텍스트를 제공하기 위해 문제 해결 스크립트, 구성 파일, 네트워크 추적 파일 등을 포함한 파일을 대화창에 끌어다 놓으세요.

제한: 파일당 10MB · 메시지당 총 50MB · 메시지당 5개 파일

지식 설정 업로드

에이전트가 향후 대화에서 참조할 문서를 유지하려면 작성기 → 기술 설정 → 파일 추가를 통해 파일을 업로드합니다. 시스템은 의미 체계 검색을 위해 업로드된 파일을 인덱싱합니다.

제한: 파일당 16MB · 업로드당 100MB

폴더 업로드

지원되는 모든 파일을 한 번에 업로드하려면 전체 폴더를 업로드 드롭 영역으로 끌어다 놓습니다. 이 프로세스에는 중첩된 하위 폴더의 파일이 포함됩니다. 포털은 폴더 계층 구조에서 모든 파일을 자동으로 추출하고 지원되지 않는 파일 형식을 필터링합니다.

폴더 업로드 작동 방법:

1. 시스템은 중첩된 하위 폴더에서 플랫 목록으로 모든 파일을 추출합니다.
2. 시스템은 지원되는 확장이 있는 파일만 포함하고 지원되지 않는 형식을 자동으로 필터링합니다.
3. 시스템은 다른 하위 폴더의 중복된 이름으로 파일을 중복 제거하고 첫 번째 파일만 유지합니다.
4. 시스템은 검색을 위해 각 파일을 개별적으로 업로드하고 인덱싱합니다.

지식 설정 업로드는 채팅 첨부 파일이 허용하지 않는 레거시 Office 형식(.doc, .ppt, .xls) 및 추가 이미지 형식(.bmp, .tiff, .tif)을 허용합니다. 채팅 첨부 파일은 지식 설정에서 지원하지 않는 코드, 스크립트, 인프라 및 웹 형식을 지원합니다.

에이전트에서 생성된 문서

에이전트가 대화 중에 문서를 만들 때( 기술 문서 업로드 도구를 사용하여) 문서를 생성 .md 하거나 .txt 파일을 만들어 지식 설정에 직접 저장합니다. 이 프로세스는 에이전트에 "Runbook으로 저장"하도록 요청할 때 발생합니다.

예시: 사건 관련 지식 수집

인시던트 조사 중에 에이전트에게 다음을 요청합니다.

We just resolved the high CPU issue on web-app-prod. It was caused by a
memory leak in the connection pool. Create a troubleshooting guide from
what we learned and upload it to Knowledge settings.

에이전트는 다음을 사용하여 구조화된 문제 해결 가이드를 생성합니다.

• 스코핑 단계: 문제를 파악하는 방법
• 빠른 완화: 영향을 줄이기 위한 즉각적인 작업입니다.
• 근본 원인 분석: 조사할 내용.
• 해결 단계: 작동된 수정 사항입니다.
• 방지: 되풀이를 방지하는 방법입니다.

다음에 비슷한 CPU 문제가 발생할 때 에이전트는 조사 중에 이 문서를 자동으로 참조하여 한 엔지니어의 경험을 공유 팀 지식으로 전환합니다.

필요한 항목

제한

다른 항목을 사용하는 경우

관련 기능