Kennisdocumenten uploaden in Azure SRE-agent

Aanbeveling

  • Uw agent maakt en uploadt runbooks tijdens gesprekken zonder handmatig bestandsbeheer.
  • Voeg 31 bestandstypen toe in chat, waaronder .kql, .bicep, .tf, .har, en .py, .xlsxvoor directe analysecontext.
  • 28 bestandstypen uploaden naar kennisinstellingen voor permanente, geïndexeerde opslag voor alle toekomstige gesprekken
  • Incidentresoluties worden automatisch institutionele kennis

Het probleem: kennis sterft met het gesprek

Elk incident dat uw team oplost, genereert waardevolle kennis: wat er is misgegaan, welke opdrachten het hebben opgelost en wat u de eerste keer moet controleren. Maar die kennis leeft in chatgesprekken, het geheugen van ingenieurs en postmortems die niemand om 3 uur 's nachts leest.

Uw team heeft runbooks, maar ze zijn verouderd. De oplossing ontdekt tijdens het incident van gisteravond? Het zit in iemands hoofd of begraven in een gesprek dat de volgende week uit beeld schuift. De volgende keer dat hetzelfde probleem optreedt, begint een andere technicus helemaal opnieuw.

Hoe uw agent dit probleem oplost

Uw agent kan documenten uploaden naar kennisinstellingen tijdens gesprekken met behulp van het hulpprogramma Kennisdocument uploaden . Wanneer uw agent een oplossing detecteert, een gids voor probleemoplossing maakt of onderzoeksresultaten samenbrengt, slaat deze die kennis rechtstreeks op en maakt het doorzoekbaar voor elk toekomstig gesprek.

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

Uw agent genereert een gestructureerd runbook en uploadt het in seconden. Het document wordt automatisch geïndexeerd en kan worden gezocht naar toekomstige onderzoeken.

Voor en na

Voordat Na
Kennis vastleggen Post-incident: engineer schrijft een "runbook" (misschien) Uw agent legt de oplossing vast terwijl dit gebeurt
Tijd om te documenteren 30 tot 60 minuten om een runbook te schrijven Seconden. De agent genereert gegevens en uploadt deze direct.
Versheid van kennis Runbooks verouderen binnen een paar weken Kennisinstellingen groeien met elke resolutie
Toegankelijkheid Kennis zit vast in het hoofd van de engineer of in een chatthread. Doorzoekbaar door uw agent in alle toekomstige gesprekken
Formatconsistentie Verschilt per auteur Gestructureerde, consistente documentatie elke keer

Wat maakt dit anders

In tegenstelling tot handmatige uploads maakt uw agent proactief kennis. U hoeft niet te onthouden wat u hebt geleerd, omdat uw agent dit doet als onderdeel van het gesprek.

In tegenstelling tot chatgeschiedenis worden geüploade documenten geïndexeerd voor semantische zoekopdrachten. Wanneer een vergelijkbaar probleem zich maanden later voordoet, vindt uw agent het relevante runbook automatisch via intelligent ophalen, niet door door oude threads te bladeren.

In tegenstelling tot wikiconnectors zijn voor geüploade documenten geen externe services vereist. De kennis bevindt zich rechtstreeks in de kennisinstellingen van uw agent, onmiddellijk beschikbaar zonder de bijbehorende synchronisatievertragingen.

Hoe werkt het?

Het hulpprogramma Knowledge Document upload accepteert drie parameters:

Kenmerk Verplicht Beschrijving
bestandsnaam Ja Naam met .md of .txt extensie (bijvoorbeeld database-pool-runbook.md)
Content Ja Volledige documenttekst in Markdown- of tekst zonder opmaak
Indexering activeren Optioneel (standaard: true) Of het document onmiddellijk doorzoekbaar moet worden

Wanneer uw agent een document uploadt:

  1. Valideert de bestandsnaam en inhoud (maximaal 16 MB per bestand).
  2. Slaat het document op in de kennisinstellingen van uw agent.
  3. Indexeert de inhoud voor semantische zoekopdrachten.
  4. Bevestigt het uploaden met een geslaagd bericht.

Opmerking

Als er al een document met dezelfde bestandsnaam bestaat, wordt deze vervangen door de nieuwe inhoud. Dit proces maakt het eenvoudig voor uw agent om kennis bij te werken. Upload met dezelfde naam om de inhoud te vernieuwen.

Ondersteunde bestandsindelingen

Uw agent verwerkt bestanden via drie methoden, die elk verschillende indelingen ondersteunen.

Chatbijlagen

Sleep bestanden naar een chat om uw agent onmiddellijke context te geven voor analyse: probleemoplossingsscripts, configuratiebestanden, netwerktraceringen en meer.

Categorie Extensions
Images .png, .jpg, .jpeg, .gif, .webp, .svg
Documents .txt, .md, .pdf, .docx, .pptx, .xlsx
Gegevens en configuratie .json .csv,.log,.yaml.yml,.xml,.ini,.conf.env
Web en netwerk .html, .har
Code en scripts .ts, .js, .py, .sh, .sql, .kql
Infrastructuur .bicep, .tf

Limieten: 10 MB per bestand · Totaal van 50 MB per bericht · 5 bestanden per bericht

Uploaden van kennisopties

Als u documenten wilt behouden waarnaar uw agent in toekomstige gesprekken kan verwijzen, uploadt u bestanden via Builder → Knowledge-instellingen → Bestand toevoegen. De systeemindexen uploaden bestanden voor semantische zoekopdrachten.

Categorie Extensions
Images .png, , .jpg.jpeg, .gif, , .webp, , .bmp.tiff.tif
Documents .txt .md,.pdf,.docx.pptx,.xlsx,.doc,.ppt.xls
Gegevens en configuratie .json, .csv, .log, .yaml, .yml, .xml, .ini, .conf, .cfg, .config, .properties

Limieten: 16 MB per bestand · 100 MB per upload

Mapuploads

Als u alle ondersteunde bestanden tegelijk wilt uploaden, sleept u een hele map naar de dropzone voor uploaden. Dit proces omvat bestanden in geneste submappen. Het portal extracteert automatisch elk bestand uit de mappenhiërarchie en filtert de niet-ondersteunde bestandstypen eruit.

Hoe het uploaden van mappen werkt:

  1. Het systeem extraheert alle bestanden uit geneste submappen in een platte lijst.
  2. Het systeem bevat alleen bestanden met ondersteunde extensies en filtert op de achtergrond niet-ondersteunde typen.
  3. Het systeem ontdubbelt bestanden met dubbele namen uit verschillende submappen en bewaart alleen het eerste bestand.
  4. Het systeem uploadt en indexeert elk bestand afzonderlijk voor zoekopdrachten.

Opmerking

Geüploade bestanden worden weergegeven als afzonderlijke documenten in kennisbronnen. De oorspronkelijke maphiërarchie wordt niet behouden. Een bestand bij runbooks/networking/dns-troubleshooting.md verschijnt als dns-troubleshooting.md.

Instellingen voor kennisuploads accepteren verouderde Office-indelingen (.doc, .ppt, .xls) en aanvullende afbeeldingsindelingen (.bmp, .tiff, .tif) die chatbijlagen niet accepteren. Chatbijlagen ondersteunen code, scripts, infrastructuur en webindelingen die niet door kennisconfiguraties worden ondersteund.

Door agents gegenereerde documenten

Wanneer uw agent documenten maakt tijdens gesprekken (met behulp van het hulpprogramma Kennisdocument uploaden), maakt het deze als .md of .txt bestanden aan en slaat ze direct op in Kennisinstellingen. Dit proces gebeurt wanneer u uw agent vraagt om dit op te slaan als een runbook.

Voorbeeld: incidentkennis vastleggen

Vraag uw agent tijdens een incidentonderzoek:

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 Knowledge settings.

Uw agent genereert een gestructureerde gids voor probleemoplossing met:

  • Bereikstappen: het probleem identificeren.
  • Snelle oplossingen: directe acties om de impact te verminderen.
  • Hoofdoorzaakanalyse: Wat moet u onderzoeken.
  • Oplossingsstappen: de oplossing die werkte.
  • Preventie: Hoe terugkeer te voorkomen.

De volgende keer dat een vergelijkbaar CPU-probleem optreedt, verwijst uw agent tijdens het onderzoek automatisch naar dit document, waardoor de ervaring van één technicus wordt omgezet in gedeelde teamkennis.

Wat u nodig hebt

Requirement Details
Agentversie 26.1.57.0 of hoger
Kennisinstellingen Ingeschakeld op uw agent
Schrijfmachtigingen Uw agent heeft schrijftoegang nodig tot kennisinstellingen
Uitvoeringsmodus Beoordelen of autonoom. Schrijfacties vereisen goedkeuring in de revisiemodus.

Limieten

Attribute Chatbijlagen Uploaden van kennisopties Agentenhulpmiddel
Maximale bestandsgrootte 10 MB 16 MB 16 MB
Maximumtotaal 50 MB per bericht 100 MB per upload N/A
Maximum aantal bestanden 5 per bericht Geen limiet (totale grootte beperkt tot 100 MB) 1 per actie
Mappen uploaden Niet ondersteund ✓ Sleep mappen om alle bestanden tegelijk te uploaden Niet ondersteund
Ondersteunde extensies 31 28 2 (.md, .txt)
Bestandsnaamtekens N/A Letters, cijfers, afbreekstreepjes, onderstrepingstekens, punten Zelfde
Maximale bestandsnaamlengte N/A 1024 tekens Zelfde

Wanneer iets anders te gebruiken

Scenario Betere aanpak
Live wiki-inhoud verbinden die gesynchroniseerd blijft Kennis van ADO-wiki
Binaire bestanden uploaden (PDF, Word, afbeeldingen) Uploaden via Builder → Knowledge Settings → Add file
Veel documenten tegelijk bulksgewijs importeren Meerdere bestanden uploaden via Builder → Knowledge Settings → Add file
Codeopslagplaatsen automatisch up-to-date houden Een GitHub- of ADO-connector verbinden
Vermogen Wat het toevoegt
Kennis van ADO-wiki Live wiki-inhoud verbinden die automatisch wordt bijgewerkt
Hoofdoorzaakanalyse Problemen onderzoeken en de bevindingen vastleggen