에이전트가 조사 중에 팀의 Runbook 및 절차를 참조할 수 있도록 Azure DevOps Wiki를 연결합니다. Wiki 콘텐츠는 인덱싱되고 검색할 수 있으며 에이전트는 자동으로 올바른 페이지를 찾습니다. 커넥터는 관리 ID 및 PAT(개인 액세스 토큰) 인증을 모두 지원합니다.
문제: 인시던트 중에 지식이 사용되지 않음
팀은 Azure DevOps Wiki에서 Runbook 작성, 문제 해결 가이드 및 운영 절차를 작성하는 데 수백 시간을 투자합니다. 그러나 오전 3시에 사건이 발생하면 아무도 위키를 검색하지 않습니다. 대기 엔지니어는 12개의 탭을 열고, Azure Monitor를 확인하고, 메모리에서 계산하거나 에스컬레이션합니다. 이 상황을 위해 작성된 설명서는 그대로 유지됩니다.
지식이 존재합니다. 문제는 실제 문제의 맥락에서 위키가 아니라 적절한 시간에 올바른 페이지에 액세스하는 것입니다.
SRE 에이전트가 이 문제를 해결하는 방법
Azure DevOps Wiki를 한 번 연결하면 에이전트가 모든 조사 중에 자동으로 검색합니다.
- 위키 페이지를 인덱싱 합니다. Azure DevOps wiki의 모든 페이지를 크롤링하고 인덱싱합니다.
- 상황별 검색 - 질문하거나 인시던트가 발생하면 에이전트가 다른 기술 자료와 함께 위키를 검색합니다.
- 특정 페이지 참조 - 응답에는 원래 위키 페이지로 다시 연결되는 인용이 포함됩니다.
- 업데이트를 감지합니다 — 커넥터를 다시 연결하거나 새로 고쳐서 업데이트된 wiki 콘텐츠를 다시 인덱싱합니다.
이전 및 이후
| 시나리오 | 이전 | 이후 |
|---|---|---|
| 인시던트 대응 | 호출 중인 사람이 인시던트 중에 위키를 검색하지 않음 | 에이전트는 모든 쿼리에 대해 wiki를 자동으로 검색합니다. |
| 지식 액세스 | 위키에 대한 지식은 오전 3시에 사용되지 않습니다. | Runbook은 필요할 때 정확하게 표시됩니다. |
| 온보딩 | 새 팀 구성원이 확인할 위키 페이지를 모릅니다. | 에이전트가 환경에 관계없이 관련 페이지를 찾습니다. |
| 검색 품질 | Wiki 검색을 수행하려면 올바른 키워드를 알고 있어야 합니다. | 에이전트가 컨텍스트를 이해하고 관련 콘텐츠를 찾습니다. |
이것이 다른 이유
정적 파일 업로드와 달리 wiki는 활성 상태로 유지됩니다. 팀이 Azure DevOps에서 런북을 업데이트하면 에이전트가 변경 사항을 수집합니다. 파일을 다시 업로드할 필요가 없습니다.
전체 텍스트 위키 검색과 달리 에이전트는 컨텍스트를 이해합니다. 키워드와 일치하지 않습니다. 대신 질문을 관련 위키 콘텐츠와 상호 연결하여 Azure Monitor의 라이브 원격 분석, Kusto의 로그 및 기타 연결된 원본과 결합합니다.
외부 MCP 기반 wiki 액세스와 달리 기본 제공 설명서 커넥터에는 외부 서버 설정이 필요하지 않습니다. 위키 URL 및 인증을 제공하고 에이전트가 나머지를 처리합니다.
작동 방식
설명서 커넥터(Azure DevOps 서비스 유형)는 위키 페이지를 크롤링하고 검색을 위해 인덱싱합니다. 에이전트가 쿼리를 받으면 업로드된 파일, 웹 페이지 및 연결된 리포지토리와 같은 다른 지식 원본과 함께 인덱싱된 콘텐츠를 검색합니다.
커넥터는 다음 두 가지 유형의 Azure DevOps 콘텐츠를 지원합니다.
| 콘텐츠 형식 | URL 패턴 | 인덱싱되는 항목 |
|---|---|---|
| Wiki | https://dev.azure.com/{org}/{project}/_wiki/wikis/{wiki-name} |
모든 위키 페이지(Markdown) |
| Wiki(범위 지정) | .../_wiki/wikis/{wiki-name}/{pageId}/Page-Name |
특정 페이지 및 해당 하위 페이지 |
| Git 리포지토리 | https://dev.azure.com/{org}/{project}/_git/{repo} |
텍스트 파일(Markdown, 문서, 코드) |
| 레거시 위키 | https://{org}.visualstudio.com/{project}/_wiki/wikis/{wiki-name} |
위와 동일(레거시 URL 형식) |
메모
위키 URL에 페이지 ID를 포함하면 커넥터는 해당 페이지와 해당 하위 페이지만 인덱싱합니다. 전체 wiki를 인덱싱하지 않고 /Operations나 /Runbooks 같은 특정 섹션을 대상으로 지정하는 데 이 방법이 유용합니다.
설명서 동기화의 작동 방식
에이전트가 연결되면 설명서 인덱스가 자동으로 최신 상태로 유지됩니다. 수동으로 아무것도 다시 업로드할 필요가 없습니다.
| Aspect | 세부 정보 |
|---|---|
| 동기화 빈도 | 24시간마다 자동 크롤링 |
| 지원되는 형식 |
.md,.txt, .rst, .adoc, .asciidoc, .wiki, , .textile, .org, .htm, .html, .json.yaml.yml, .xml.csv (15개의 파일 형식) |
| 인덱싱 프로세스 | 의미 체계 검색을 위해 문서가 청크, 포함 및 인덱싱됩니다. |
| Updates | 수동 작업이 필요 없는 다음 동기화 주기에서 리포지토리의 변경 내용이 선택됩니다. |
에이전트는 의미상 의미 있는 청크로 분할하고, 벡터 포함을 생성하고, 검색 인덱스에 저장하여 각 문서를 처리합니다. 쿼리가 도착하면 에이전트는 인덱싱된 모든 청크에서 의미 체계 검색을 수행하고 정확한 키워드 일치에 관계없이 가장 관련성이 큰 구절을 검색합니다.
팀은 Runbook을 업데이트하거나, 새 절차를 추가하거나, 위키 페이지를 다시 구성할 수 있으며, 에이전트는 24시간 내에 이러한 변경 내용을 반영합니다.
사전 요구 사항
| 요구 사항 | 세부 정보 |
|---|---|
| Azure DevOps wiki | 콘텐츠가 포함된 Azure DevOps 프로젝트의 Wiki |
| 인증 | 관리 ID(권장) 또는 PAT(개인 액세스 토큰) |
| Permissions | Wiki에 대한 읽기 액세스 권한 |
인증 옵션
다음 표에서는 Azure DevOps Wiki 커넥터에 사용할 수 있는 인증 방법을 설명합니다.
| 메서드 | 적합한 대상 | 작동 방식 |
|---|---|---|
| 관리되는 아이덴티티 | 프로덕션 환경 | 에이전트의 시스템 할당 또는 사용자 할당 관리 ID를 사용합니다. Azure DevOps 조직에서 사용자로 ID를 추가해야 합니다. |
| PAT(개인용 액세스 토큰) | 빠른 설정, 테스트 | 코드(읽기) 범위를 사용하여 Azure DevOps에서 PAT를 생성합니다. |
예: 사건 발생 시 런북(runbook) 사용
작업 위키를 연결한 후 에이전트에게 다음을 요청합니다.
Our payment service is returning 503 errors. What does our runbook say to do?
에이전트가 위키를 검색하고, "결제 서비스 문제 해결" 페이지를 찾고, 문서화된 절차로 응답합니다. 응답에는 Azure DevOps의 원래 위키 페이지로 다시 연결되는 인용이 포함됩니다.