Zelfstudie: Kennisdocumenten uploaden in Azure SRE-agent

In deze zelfstudie uploadt u kennisdocumenten naar uw Azure SRE-agent, zodat deze tijdens toekomstige onderzoeken ernaar kan verwijzen. U leert hoe u onderzoeksresultaten rechtstreeks opslaat in kennisinstellingen via chat en hoe u bestaande bestanden uploadt via de gebruikersinterface van de portal.

In deze handleiding leer je hoe je:

Geschatte tijd: 10 minuten

Vereiste voorwaarden

• Een Azure SRE-agent met de status Running
• Schrijfmachtigingen voor de agent
• De uitvoeringsmodus van de agent is ingesteld op Controleren of Autonoom

Stap 1: Beginnen met een onderzoek

De beste kennisdocumenten zijn afkomstig van echte onderzoeken. Gebruik in plaats van volledig nieuwe inhoud te maken wat uw agent al heeft geleerd.

1. Ga naar sre.azure.com en selecteer uw agent.
2. Zoek in de linkerzijbalk onder Chats een vorige onderzoeksthread ( elk gesprek waarbij uw agent een probleem heeft aangegeven of opgelost ) en selecteer deze.

Als u nog geen onderzoeksthread hebt, start u een nieuwe chat en vraagt u uw agent om iets te onderzoeken:

Investigate high memory usage on our container apps

Wacht totdat het onderzoek is voltooid en ga vervolgens verder met stap 2.

Stap 2: Vraag uw agent om een runbook te maken

Vraag uw agent in dezelfde onderzoeksthread om de bevindingen om te zetten in een runbook en deze op te slaan in kennisinstellingen. Wees specifiek over de bestandsnaam.

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

Uw agent:

1. Synthetiseert de onderzoekscontext in een gestructureerd runbook.
2. Hiermee worden secties gegenereerd, zoals hoofdoorzaakanalyse, diagnostische stappen, oplossingen en escalatietriggers.
3. Slaat het document op in kennisinstellingen en bevestigt het uploaden.

De agent bevestigt dat het document is opgeslagen en biedt een downloadkoppeling. Uw runbook wordt nu opgeslagen in kennisbankinstellingen en wordt geïndexeerd voor zoeken.

Controlepunt

• Agent heeft een gestructureerd runbook gegenereerd uit het onderzoek.
• Agent heeft bevestigd dat het document is opgeslagen.

Stap 3: Controleren in kennisbankinstellingen

1. Selecteer opbouwfunctie in de linkerzijbalk om de sectie uit te vouwen.
2. Selecteer Kennisinstellingen.

Op de pagina Kennisinstellingen worden uw documenten weergegeven in een tabel met kolommen voor bestandsnaam, status, type en laatst gewijzigd. De kolom Status toont ✓ Geïndexeerd wanneer het document is geïndexeerd en klaar is voor zoeken.

Als de status In afwachting wordt weergegeven, selecteert u Verversen. Indexering wordt doorgaans binnen een paar seconden voltooid.

Controlepunt

• Navigeerd naar Builder-→ Knowledge-instellingen
• Document wordt weergegeven met de status ✓ Geïndexeerd

Stap 4: Bestanden uploaden via de portal

U kunt afzonderlijke bestanden of volledige mappen rechtstreeks uploaden. Deze methode is handig voor bestaande runbooks, documentatie of referentiemateriaal dat uw team al heeft.

Afzonderlijke bestanden uploaden

1. Selecteer Bestand toevoegen op de pagina Kennisbronnen.
2. Sleep een bestand naar de dropzone of selecteer bladeren in bestanden om er een te kiezen.
3. Selecteer Bestand toevoegen om te uploaden.

Een map uploaden

U kunt ook een hele map inclusief geneste submappen naar de dropzone slepen.

1. Selecteer Bestand toevoegen op de pagina Kennisbronnen.
2. Sleep een map rechtstreeks vanuit je bestandbeheerder naar de dropzone.
3. De portal extraheert alle ondersteunde bestanden uit de map en de bijbehorende submappen en vermeldt deze vervolgens in het dialoogvenster.
4. Controleer de lijst met bestanden- verwijder alle bestanden die u niet wilt door het pictogram Verwijderen naast elk bestand te selecteren.
5. Selecteer Bestand toevoegen om alle vermelde bestanden te uploaden.

In de portal worden bestanden met niet-ondersteunde extensies automatisch gefilterd. Zie de mogelijkheidspagina Kennisdocumenten uploaden voor de volledige lijst met ondersteunde extensies en groottelimieten.

De maximale bestandsgrootte is 16 MB per bestand, met maximaal 100 MB per upload.

Controlepunt

• Geselecteerd Bestand toevoegen en het uploadscherm gezien.
• Een bestand of een map is succesvol geüpload.
• Bestanden worden weergegeven in kennisbronnen met de status ✓ Geïndexeerd .

Stap 5: Test het ophalen in een nieuw gesprek

Start een nieuwe chat-thread en stel een vraag die uw geüploade documenten moeten beantwoorden:

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

Uw agent doorzoekt de kennisinstellingen, vindt uw geüploade runbook en verwijst ernaar in het antwoord. Dit proces bevestigt dat de kennis is geïndexeerd en opgehaald.

Controlepunt

• Een nieuwe chatthread gestart
• Een vraag gesteld met betrekking tot de geüploade inhoud
• Agent heeft verwezen naar het geüploade document in het antwoord

Een kennisdocument verwijderen

1. Ga naar Opbouwfunctie → Knowledge-instellingen.
2. Selecteer een of meer documenten in de lijst met documenten met behulp van de selectievakjes.
3. Selecteer Verwijderen op de werkbalk.
4. In een bevestigingsvenster worden de documenten weergegeven die moeten worden verwijderd. Selecteer Verwijderen om te bevestigen.

Wanneer u documenten verwijdert, verwijdert u deze uit de kennisinstellingen van de agent en worden ze niet meer weergegeven in zoekresultaten.

Wat u hebt geleerd

• Uw agent kan werkelijke onderzoeken omzetten in gestructureerde runbooks en deze opslaan in kennisbeheer.
• U kunt bestanden handmatig uploaden via de gebruikersinterface van de portal in Builder → Knowledge-instellingen. Het ondersteunt veel indelingen, waaronder PDF, Office-documenten en afbeeldingen.
• De systeemindexeert geüploade documenten voor semantische zoekopdrachten en ze zijn beschikbaar in alle toekomstige gesprekken.
• Als u documenten wilt bijwerken, uploadt u ze met dezelfde bestandsnaam.

Troubleshooting

Related