Självstudie: Ladda upp kunskapsdokument i Azure SRE-agent

I den här självstudien laddar du upp kunskapsdokument till din Azure SRE-agent så att den kan referera till dem under framtida undersökningar. Du lär dig hur du sparar undersökningsresultat direkt i Kunskapsinställningar via chatt och hur du laddar upp befintliga filer via portalens användargränssnitt.

I den här tutorialen lär du dig följande:

  • Omvandla en undersökning till en återanvändbar runbook och spara den i Kunskapsinställningar
  • Kontrollera att uppladdat innehåll är indexerat och sökbart
  • Ladda upp enskilda filer eller mappar via portalen
  • Testa att agenten kan hämta uppladdat innehåll i en ny konversation

Uppskattad tid: 10 minuter

Förutsättningar

  • En Azure SRE-agent i körningstillstånd
  • Skrivbehörigheter för agenten
  • Agentkörningsläge inställt på Granska eller Autonomt

Steg 1: Börja med en undersökning

De bästa kunskapsdokumenten kommer från verkliga undersökningar. I stället för att skapa innehåll från grunden samlar du in det som din agent redan har lärt sig.

  1. Gå till sre.azure.com och välj din agent.
  2. I det vänstra sidofältet under Chattar hittar du en tidigare undersökningstråd – alla konversationer där din agent har diagnostiserat eller löst ett problem – och väljer den.

Om du inte har någon undersökningstråd än startar du en ny chatt och ber agenten att undersöka något:

Investigate high memory usage on our container apps

Vänta tills undersökningen har slutförts och fortsätt sedan med steg 2.

Steg 2: Be din agent om att skapa en körbok

I samma undersökningstråd ber du agenten att omvandla sina resultat till en runbook och spara den i Kunskapsinställningar. Var specifik om filnamnet.

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

Din agent:

  1. Syntetiserar undersökningskontexten till en strukturerad runbook.
  2. Genererar avsnitt som grundorsaksanalys, diagnostiska steg, åtgärder och eskaleringstriggers.
  3. Sparar dokumentet i Kunskapsinställningar och bekräftar uppladdningen.

Agenten bekräftar att dokumentet har sparats och tillhandahåller en nedladdningslänk. Din runbook lagras nu i Kunskapsinställningar och indexeras för sökning.

Kontrollpunkt

  • Agenten genererade en strukturerad åtgärdsbok från undersökningen.
  • Agenten bekräftade att dokumentet sparades.

Steg 3: Verifiera i Kunskapsinställningar

  1. I det vänstra sidofältet väljer du Builder för att expandera avsnittet.
  2. Välj Kunskapsinställningar.

Sidan Kunskapsinställningar visar dina dokument i en tabell med kolumner för Filnamn, Status, Typ och Senast ändrad. Kolumnen Status visar √ Indexerat när dokumentet indexeras och är redo för sökning.

Om statusen visar Väntande väljer du Uppdatera. Indexeringen slutförs vanligtvis inom några sekunder.

Kontrollpunkt

  • Navigerat till Kunskapsinställningar för Builder →
  • Dokumentet visas med √ Indexerad status

Steg 4: Ladda upp filer via portalen

Du kan ladda upp enskilda filer eller hela mappar direkt. Den här metoden är användbar för befintliga runbooks, dokumentation eller referensmaterial som ditt team redan har.

Ladda upp enskilda filer

  1. På sidan Kunskapskällor väljer du Lägg till fil.
  2. Dra en fil till släppzonen eller välj bläddra efter filer för att välja en.
  3. Välj Lägg till fil att ladda upp.

Ladda upp en mapp

Du kan också dra en hel mapp – inklusive kapslade undermappar – till släppzonen.

  1. På sidan Kunskapskällor väljer du Lägg till fil.
  2. Dra en mapp från filhanteraren direkt till släppzonen.
  3. Portalen extraherar alla filer som stöds från mappen och dess undermappar och visar dem sedan i dialogrutan.
  4. Granska fillistan – ta bort alla filer du inte vill ha genom att välja borttagningsikonen bredvid varje fil.
  5. Välj Lägg till fil för att ladda upp alla filer som visas.

Portalen filtrerar automatiskt bort filer med tillägg som inte stöds. En fullständig lista över tillägg och storleksgränser som stöds finns på sidan Ladda upp kunskapsdokument.

Maximal filstorlek är 16 MB per fil, med upp till 100 MB per uppladdning.

Anmärkning

När du laddar upp en mapp bevarar portalen inte mappstrukturen – filer från undermappar visas som enskilda dokument. Om filer i olika undermappar delar samma namn laddas endast den första filen upp.

Kontrollpunkt

  • Valde Lägg till fil och såg uppladdningsdialogrutan.
  • Överfört en fil eller dragit en mapp framgångsrikt.
  • Filer visas i Kunskapskällor med √ Indexerad status.

Steg 5: Testa hämtning i en ny konversation

Starta en ny chatttråd och ställ en fråga som dina uppladdade dokument ska besvara:

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

Din agent söker i Kunskapsinställningar, hittar din uppladdade runbook och refererar till den i svaret. Den här processen bekräftar att kunskapen är indexerad och hämtningsbar.

Kontrollpunkt

  • Startade en ny chatttråd
  • Ställde en fråga om det uppladdade innehållet
  • Agenten refererade till det uppladdade dokumentet i sitt svar

Ta bort ett kunskapsdokument

  1. Gå till BuilderKunskapsinställningar.
  2. I dokumentlistan markerar du ett eller flera dokument med hjälp av kryssrutorna.
  3. Välj Ta bort i verktygsfältet.
  4. I en bekräftelsedialogruta visas de dokument som ska tas bort. Välj Ta bort för att bekräfta.

När du tar bort dokument tar du bort dem från agentens kunskapsinställningar och de visas inte längre i sökresultaten.

Anmärkning

Du kan inte redigera kunskapsdokument på plats. Om du vill uppdatera ett dokument laddar du upp en ny version med samma filnamn. Den nya versionen ersätter den tidigare versionen.

Det här har du lärt dig

  • Din agent kan omvandla verkliga undersökningar till strukturerade runbooks och spara dem i Kunskapsinställningar.
  • Du kan ladda upp filer manuellt via portalgränssnittet i Builder → Kunskapsinställningar. Det stöder många format, inklusive PDF, Office-dokument och bilder.
  • Systemet indexerar uppladdade dokument för semantisk sökning och de är tillgängliga i alla framtida konversationer.
  • Om du vill uppdatera dokument laddar du upp dem med samma filnamn.

Felsökning

Error Orsak Åtgärda
"Agentminnet är inaktiverat. Det går inte att ladda upp dokument." Kunskapsinställningar är inte aktiverade på din agent Kontakta administratören för att aktivera kunskapsinställningar
"Jag har inte skrivåtkomst till dina kunskapsinställningar" Agenten kunde inte hitta uppladdningsverktyget Formulera om din begäran: "Spara den i Kunskapsinställningar som filename.md"
"Ogiltigt filnamnstillägg. Endast .md- och .txt-filer tillåts." Filnamnet slutar inte i .md eller .txt (chattuppladdning) Använd en .md- eller .txt-tillägg när du ber agenten att spara
"Dokumentinnehållet överskrider den maximala storleken på 16 MB" Innehållet är för stort för ett enskilt dokument Dela upp i flera mindre dokument
"Filnamnet får inte vara tomt" Inget filnamn har angetts Inkludera ett filnamn i prompten (t.ex. runbook.md)
Resource Det här lär du dig
Ladda upp kunskapsdokument Hur detta fungerar och varför det spelar roll
Skapa en färdighet Skapa processuella färdigheter som kompletterar kunskapsdokument
Färdigheter Så här fungerar kunskaper och färdigheter tillsammans
ADO wiki Knowledge Ansluta live-wiki-innehåll som en kunskapskälla