連接你的 Azure DevOps 維基，讓代理在調查時能參考團隊的執行手冊和程序。 維基百科內容會被索引並可搜尋，你的代理人會自動找到正確的頁面。 該連接器支援管理身份認證與個人存取權杖（PAT）認證。
問題在於：知識在事件中被忽略
你的團隊花費數百小時撰寫 Azure DevOps 維基中的執行手冊、故障排除指南和作業程序。 但當事件在凌晨三點發生時，沒有人會去維基搜尋。 輪值工程師會開啟十多個索引標籤、檢查 Azure 監視器，然後不是憑記憶找出原因，就是向上呈報。 針對這種情況所撰寫的文件卻未被修改。
知識是存在的。 問題在於存取，不是無法存取 Wiki，而是在實際問題發生時，無法於正確時間存取正確頁面。
SRE 代理如何解決此問題
只要連接一次 Azure DevOps 維基，你的代理程式會在每次調查時自動搜尋：
- 索引你的維基頁面 — 爬取並索引你 Azure DevOps 維基中的所有頁面。
- 依內容搜尋 — 當您提出問題或事件觸發時，您的 Agent 會搜尋 Wiki，以及其他知識來源。
- 參考文獻 特定頁面 — 回應包含連結至原始維基頁面的引用。
- 接收更新 — 重新連接或刷新該連接以重新索引更新的維基內容。
前後比較
| 案例 | 之前 | 之後 |
|---|---|---|
| 事件回應 | 值班人員在事件發生時不會查維基 | 你的經紀人會自動搜尋維基上的每個查詢 |
| 知識存取 | wiki 裡的知識凌晨三點就沒用了 | 執行手冊會在真正需要時出現 |
| 上線 | 新團隊成員不知道該查看哪個維基頁面 | 你的經紀人無論經驗如何，都能找到相關頁面 |
| 搜尋品質 | 維基搜尋需要知道正確的關鍵字 | 你的經紀人了解上下文並尋找相關內容 |
這點有什麼不同
與靜態檔案上傳不同，你的維基會持續存在。 當你的團隊在 Azure DevOps 更新 runbook 時，代理程式會接收這些變更。 你不需要重新上傳檔案。
與全文維基搜尋不同，您的經紀人能理解上下文。 它和關鍵字不符。 相反地，它會將你的問題與相關的維基內容關聯起來，結合 Azure Monitor 的即時遙測、Kusto 的日誌以及其他相關來源。
與基於外部 MCP 的維基存取不同，內建的文件連接器不需要外部伺服器設定。 你提供維基網址和認證，剩下的由你的代理人處理。
運作方式
文件連接器（Azure DevOps 服務類型）會爬取你的維基頁面並將其索引以便搜尋。 當你的經紀人收到查詢時，會與其他知識來源（如上傳檔案、網頁及相關資料庫）一同搜尋已索引的內容。
該連接器支援兩種類型的 Azure DevOps 內容：
| 內容類型 | URL 模式 | 哪些會被索引 |
|---|---|---|
| 維基 | 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} |
同上（舊版網址格式） |
備註
當你在維基網址中加入頁面 ID，連接器只會索引該頁面及其子頁面。 這種方法適合針對特定區塊，例如/Operations/Runbooks不索引整個維基。
文件同步的運作方式
一旦連線，您的代理人會自動保持您的文件索引最新。 你不需要手動重新上傳任何東西。
| 層面 | 詳細資料 |
|---|---|
| 同步頻率 | 每 24 小時自動編目一次 |
| 支援的格式 |
.md，.txt，.rst，.adoc，.asciidoc，.wiki，.textile，.org，.htm，.html，.json，.yaml，.yml（.xml.csv15種檔案格式） |
| 索引流程 | 文件會被分塊、嵌入並索引，以便語意搜尋 |
| Updates | 儲存庫中的變更會在下一個同步週期中被接收，無需手動操作 |
你的代理人會將每份文件拆分成語意有意義的區塊，產生向量嵌入，並將它們儲存在搜尋索引中。 當查詢到達時，你的代理人會在所有索引區塊中進行語意搜尋，並取得最相關的段落，不論關鍵字是否完全吻合。
你的團隊可以更新跑手冊、新增程序或重新組織維基頁面，你的客服會在 24 小時內反映這些變更。
先決條件
| 需求 | 詳細資料 |
|---|---|
| Azure DevOps wiki | 有內容的 Wiki 位於您的 Azure DevOps 專案內。 |
| 驗證 | 管理身份（建議）或個人存取令牌（PAT） |
| 許可 | 維基的閱讀權限 |
驗證選項
下表說明了 Azure DevOps 維基連接器可用的認證方法。
| 方法 | 最適合用於 | 運作方式 |
|---|---|---|
| 受控識別 | 生產環境 | 使用您 Agent 的系統指派或使用者指派受控識別。 需要在你的 Azure DevOps 組織中新增使用者身份。 |
| 個人存取權杖 （PAT） | 快速設定與測試 | 在 Azure DevOps 中產生帶有程式碼（讀取）範圍的 PAT。 |
範例：在事件處理期間使用執行手冊
連結營運維基後，請詢問你的業務員：
Our payment service is returning 503 errors. What does our runbook say to do?
你的代理會搜尋你的維基，找到「付款服務故障排除」頁面，並回應你指定的文件流程。 回覆中附有引用，連結回 Azure DevOps 原始維基頁面。