Självstudie: Ladda upp kunskapsdokument till Azure SRE Agent

I den här självstudien laddar du upp kunskapsdokument till azure SRE-agentens kunskapsbas med hjälp av två metoder: genom att be agenten att skapa en runbook från en undersökning och genom att ladda upp en fil via portalgränssnittet.

Din agent kan samla in kunskap som upptäckts under undersökningar och lagra den för framtida användning och skapa institutionella kunskaper automatiskt. Mer information finns i Ladda upp kunskapsdokument.

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

• Omvandla en undersökning till en strukturerad runbook och spara den i kunskapsbasen
• Ladda upp en fil manuellt via portalgränssnittet
• Kontrollera att uppladdade dokument är indexerade och tillgängliga
• Bekräfta att agenten hämtar uppladdad kunskap i nya konversationer

Uppskattad tid: 15 minuter

Förutsättningar

Kontrollera att du har följande innan du börjar:

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

Starta från 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 där agenten 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 nästa steg.

Skapa en runbook från undersökningen

I samma undersökningstråd, be din agent att omvandla sina slutsatser och observationer till en instruktionsbok och spara den i kunskapsbasen. 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 the knowledge base as high-memory-runbook.md

Din agent utför följande åtgärder:

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

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

Tips/Råd

Ange ett filnamn med ett .md eller .txt ett tillägg. Detta styr hur dokumentet namnges i kunskapsbasen och gör det enkelt att hitta det senare.

Anmärkning

Om din agent är i granskningsläge ber den om ditt godkännande innan uppladdningen körs. Välj Godkänn för att fortsätta.

Bekräfta nu följande:

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

Verifiera dokumentet i kunskapsbasen

Gå till kunskapsbasen för att bekräfta att dokumentet har indexerats.

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

Kunskapsbassidan 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.

Ladda upp en fil via portalen

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

1. På sidan Kunskapsbas 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 en fil som ska laddas upp.

Portalen accepterar följande filtyper:

• Text: .md, .txt, .csv, .json, .xml, .yaml, .yml, .log, .ini, .cfg, .conf, , .config, .properties
• Dokument: .pdf, .docx, .pptx, .xlsx, .doc, .ppt, .xls
• Bilder: .png, .jpg, .jpeg, .gif, .bmp, .webp, , .tiff, .tif

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

Testa hämtning i en ny konversation

Bekräfta att agenten kan hitta och använda de uppladdade dokumenten.

1. Välj Ny chatttråd i sidopanelen.
2. Ställ en fråga som dina uppladdade dokument ska besvara.

Som exempel:

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

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

Samla in kunskap efter incidenter

När du har löst ett problem ber du agenten att bevara det som den har lärt sig:

Create a runbook from the steps we just used to resolve this incident.
Include the root cause, investigation steps, and the fix.
Save it as incident-12345-resolution.md in the knowledge base.

Med tiden bygger detta ett sökbart bibliotek med institutionell kunskap. Varje tidigare incident blir en resurs för framtida incidenter.

Uppdatera befintliga dokument

Ladda upp ett dokument med samma filnamn för att ersätta den tidigare versionen:

Update the high-memory-runbook.md document in the knowledge base.
Add a new section about container memory limits as a common cause.

Batchuppladdningar via kommandoradsgränssnitt (CLI)

Importera flera dokument samtidigt med hjälp av CLI:

# Upload a single file
srectl doc upload --file ./runbooks/high-memory-guide.md

# Upload all .md and .txt files in a folder (recursive)
srectl doc upload --file ./runbooks

Felsökning

Använd följande tabell för att lösa vanliga problem med uppladdning av kunskapsdokument.

Error	Orsak	Åtgärda
"Agentminnet är inaktiverat. Det går inte att ladda upp dokument."	Kunskapsbasen är inte aktiverad på din agent.	Kontakta administratören för att aktivera kunskapsbasen.
"Jag har inte skrivåtkomst till din kunskapsbas"	Agenten kunde inte hitta uppladdningsverktyget.	Formulera om din begäran: "Spara den i kunskapsbasen som filename.md"
"Ogiltigt filnamnstillägg. Endast .md- och .txt-filer tillåts."	Filnamnet slutar inte i .md eller .txt (chattuppladdning).	Använd .md eller .txt 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 (till exempel runbook.md).

Nästa steg

Lär dig mer om minne och kunskap

Relaterat innehåll

• Ladda upp kunskapsdokument (funktion)
• Kunskap om Azure DevOps-wiki
• Minne och kunskap