Dela via


Ladda upp kunskapsdokument till Azure SRE Agent

Din agent samlar in institutionella kunskaper under konversationer genom att ladda upp runbooks, felsökningsguider och dokumentation direkt till kunskapsbasen. När din agent upptäcker en korrigering eller löser en incident genererar den strukturerade dokument och indexerar dem för semantisk sökning, så varje framtida undersökning drar nytta av tidigare lösningar.

Tips/Råd

Din agent skapar och laddar upp runbooks under konversationer utan manuell filhantering. Systemet indexerar dokument för semantisk sökning, vilket gör dem tillgängliga för alla framtida undersökningar. Incidentlösningar blir automatiskt institutionella kunskaper.

Hur din agent samlar in kunskap

Din agent kan ladda upp dokument till kunskapsbasen under konversationer med hjälp av verktyget Ladda upp kunskapsdokument . När din agent upptäcker en korrigering, skapar en felsökningsguide eller syntetiserar undersökningsresultat lagrar den kunskapen direkt och gör den sökbar för varje framtida konversation.

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

Din agent genererar en strukturerad runbook och laddar upp den på några sekunder. Dokumentet indexeras automatiskt och kan sökas efter framtida undersökningar.

Agent som genererar och laddar upp en felsökningsguide under en konversation

Före och efter

I följande tabell jämförs arbetsflöden för kunskapsinsamling före och efter användning av verktyget Ladda upp kunskapsdokument .

Område före Efter
Kunskapsinsamling Efter en incident: ingenjör skriver manual (kanske) Din agent fångar korrigeringen i samma ögonblick som det händer
Tid att dokumentera 30–60 minuter för att skriva en drifthandbok Sekunder: din agent genererar och laddar upp inline
Kunskaps färskhet Runbooks blir inaktuella inom några veckor Kunskapsbasen växer med varje lösning
Tillgänglighet Kunskap som är fast i ingenjörens huvud eller i en chatttråd Sökbar av din agent i alla framtida konversationer
Formatkonsekvens Varierar beroende på författare Strukturerad och konsekvent dokumentation varje gång

Vad gör detta annorlunda

Till skillnad från manuella uppladdningar skapar din agent kunskap proaktivt. Du behöver inte komma ihåg att dokumentera det du har lärt dig. Din agent gör det som en del av konversationen.

Till skillnad från chatthistorik indexeras uppladdade dokument för semantisk sökning. När ett liknande problem inträffar månader senare, hittar din agent automatiskt den relevanta körjournalen genom intelligenta hämtningar istället för att behöva bläddra igenom gamla trådar.

Till skillnad från wiki-anslutningsappar kräver uppladdade dokument inte externa tjänster. Kunskapen finns direkt i din agent kunskapsbas, tillgänglig direkt utan att synkroniseringen fördröjs.

Så här fungerar det

Verktyget Ladda upp kunskapsdokument accepterar tre parametrar.

Parameter Obligatoriskt Beskrivning
Filnamn Ja Namn med .md eller .txt tillägg (till exempel database-pool-runbook.md)
Content Ja Fullständig dokumenttext i Markdown- eller oformaterad textformat
Utlösarindexering Valfritt (standard: true) Om dokumentet ska kunna sökas direkt

När din agent laddar upp ett dokument:

  1. Agenten validerar filnamnet och innehållet (högst 16 MB per fil).
  2. Agenten lagrar dokumentet i agentens kunskapsbas.
  3. Agenten indexerar innehållet för semantisk sökning.
  4. Agenten bekräftar uppladdningen med ett meddelande om att det lyckades.

Anmärkning

Om det redan finns ett dokument med samma filnamn ersätter det nya innehållet det. Ladda upp med samma namn för att uppdatera innehållet.

Filformat som stöds

Verktyget Ladda upp kunskapsdokument har stöd för textbaserade format som din agent genererar i realtid.

Format Förlängning Bäst för
Markdown .md Körböcker, felsökningsguider med formatering och rubriker
Oformaterad text .txt Enkla anteckningar, loggar, rådatadokumentation

Anmärkning

När du laddar upp filer via API:et eller CLI kan du använda fler textformat, inklusive CSV-, JSON-, YAML- och loggfiler. API:et för uppladdning stöder binära format (PDF, Word, Excel, PowerPoint) och bilder. Agentverktyget fokuserar på .md och .txt format eftersom din agent genererar textinnehåll under samtal.

Dialogrutan Lägg till fil i kunskapsbasen som visar format som stöds och dra och släpp-uppladdning

Exempel: samla in incidentkunskaper

Under en incidentundersökning frågar du din agent:

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 the knowledge base.

Din agent genererar en strukturerad felsökningsguide med:

  • Avgränsningssteg: Så identifierar du problemet
  • Snabbreducering: Omedelbara åtgärder för att minska påverkan
  • Rotorsaksanalys: Vad du ska undersöka
  • Lösningssteg: Korrigeringen som fungerade
  • Förebyggande: Så här undviker du upprepning

Nästa gång ett liknande CPU-problem uppstår refererar agenten automatiskt till det här dokumentet under undersökningen och omvandlar en teknikers erfarenhet till delad teamkunskap.

Förutsättningar

Innan du använder verktyget Ladda upp kunskapsdokument måste du uppfylla följande krav.

Krav Detaljer
Agentversion 26.1.57.0 eller senare
Kunskapsbas Aktiverad på din agent
Skrivbehörighet Din agent behöver skrivåtkomst till kunskapsbasen
Körningsläge Granska eller autonomt (skrivåtgärder kräver godkännande i granskningsläge)

Begränsningar

Följande begränsningar gäller för uppladdade kunskapsdokument.

Limit Värde
Maximal filstorlek 16 MB per dokument
Tillägg som stöds .md och .txt
Filnamnstecken Bokstäver, siffror, bindestreck, understreck, punkter (inga /, \, ?, #)
Maximal filnamnslängd 1 024 tecken

När du ska använda något annat

I följande tabell beskrivs scenarier där en annan metod är lämpligare.

Scenario Bättre tillvägagångssätt
Ansluta live-wiki-innehåll som förblir synkroniserat Kunskap om Azure DevOps-wiki
Ladda upp binära filer (PDF, Word, bilder) Ladda upp manuellt via Builder > Knowledge Base > Lägg till fil
Massimportera många dokument samtidigt Använda CLI-kommandot srectl doc upload --file <path>

Nästa steg