Självstudie: Skapa och hantera krokar i portalen

I den här självstudien skapar du två styrningskrokar med hjälp av portalen: en stoppkrok som framtvingar dataformatering (markdown-tabeller med fetstil) och en PostToolUse-krok som blockerar farliga gränssnittskommandon. Du konfigurerar krokar på både agentnivå (gäller för alla trådar och underagenter) och subagentnivån (gäller för en specifik underagent).

Uppskattad tid: 10 minuter

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

Förutsättningar

• En Azure SRE-agent i körningstillstånd
• Medverkarroll eller högre på SRE-agentresursen

Förstå var krokar finns i portalen

Krokar fungerar på två nivåer. Att förstå den här skillnaden är ett viktigt arkitekturkoncept.

Skapa agentnivåkrokar

Krokar på agentnivå gäller för hela agenten, inklusive varje tråd och varje underagent. De har aktiveringslägen som styr när de är aktiva.

Öppna sidan Hooks

Följ de här stegen för att gå till sidan Krokar.

1. Gå till sre.azure.com och välj din agent.
2. Expandera Builder i sidopanelen.
3. Välj Krokar.

Du ser rubriken Hooks med en beskrivning, knappen Skapa krok och ett tomt datarutnät (eller en lista över befintliga krokar).

Skapa en stoppkrok

En Stoppkrok utlöses när agenten är på väg att returnera ett slutligt svar. Använd den för att verifiera svarskvaliteten och framtvinga formateringsregler.

1. Välj Skapa hook.

2. Fyll i formulärfälten:

   Fält	Värde
   Namn	require-table-format
   Händelsetyp	Stopp
   Aktivering läge	Alltid
   Beskrivning	Säkerställer att svar presenterar strukturerade data som markdown-tabeller med fetstilade rubriker

3. Under Hook Definition ska du hålla Hook-typen inställd på Prompt.

4. Behåll modellen inställd på Reasoning Fast (standard).

5. I promptredigeraren anger du följande text:

   Check the agent response below.
   
   $ARGUMENTS
   
   Does the response present any structured data (lists of items, comparisons, metrics) as a markdown table with **bold** column headers?
   If no structured data is present, approve.
   If structured data IS present as a table with bold headers: {"ok": true}
   If structured data is present but NOT formatted as a table: {"ok": false, "reason": "Reformat the structured data as a markdown table with **bold** column headers."}
   

6. Lämna Timeout (sek) i 30, felläge vid Allow, och Max avslag på 3.

7. Välj Spara.

Dialogrutan avslutas med ett meddelande om att det har lyckats. Kroken visas i datarutnätet med händelsetypen Stoppa och Aktivering alltid.

Testa stoppkroken

Följ de här stegen för att kontrollera att Stoppkroken fungerar korrekt.

1. I sidofältet väljer du Chatt.
2. Skriv Jämför för- och nackdelarna med Python jämfört med Go för att skapa mikrotjänster och välj Skicka.
3. Titta på agentens svar:
   • Agenten svarar inledningsvis med en jämförelse av oformaterad text.
   • Stoppkroken utvärderar och avvisar svaret eftersom data inte finns i en tabell.
   • Agenten formaterar om sitt svar som en markdown-tabell med fetstilade rubriker.

Det slutliga svaret visar jämförelsen som en formaterad tabell som liknar följande exempel:

Skapa en PostToolUse-krok

En PostToolUse-hook utlöses efter att ett verktyg har slutfört sin körning. Använd den för att granska verktygsanvändning, blockera farliga kommandon eller lägga till extra kontext.

1. Gå tillbaka till Builder>Hooks.

2. Välj Skapa hook.

3. Fyll i formuläret:

   Fält	Värde
   Namn	block-dangerous-commands
   Händelsetyp	Användning av postverktyg
   Aktivering läge	Alltid
   Beskrivning	Blockerar rm -rf, sudo och chmod 777 i gränssnittskommandon
   Typ av krok	Kommando
   Verktygsmatchning	Bash\|ExecuteShellCommand

4. Välj Python som skriptspråk.

5. I skriptredigeraren anger du följande skript:

   #!/usr/bin/env python3
   import sys, json, re
   
   context = json.load(sys.stdin)
   command = context.get('tool_input', {}).get('command', '')
   
   dangerous = [r'\brm\s+-rf\b', r'\bsudo\b', r'\bchmod\s+777\b']
   for pattern in dangerous:
       if re.search(pattern, command):
           print(json.dumps({"decision": "block", "reason": f"Blocked: {pattern}"}))
           sys.exit(0)
   
   print(json.dumps({"decision": "allow"}))
   

6. Ange Felläge till Blockera (om skriptet kraschar blockeras verktygsresultatet).

7. Välj Spara.

Båda krokarna visas nu i hooks-datarutnätet .

Testa PostToolUse-kroken

Följ dessa steg för att kontrollera att PostToolUse-kroken fungerar korrekt.

1. I sidofältet väljer du Chatt.
2. Be agenten att köra ett säkert kommando: "Kör echo hello". Kroken tillåter det här kommandot.
3. Be agenten att köra ett farligt kommando: "Kör rm -rf /tmp/test". Kroken blockerar det här kommandot.

Kommandot för säker körning utförs normalt. Det farliga kommandot blockeras och agenten får ett meddelande som förklarar varför.

Redigera och ta bort "hooks" på agentnivå

Du kan ändra eller ta bort befintliga krokar från hooks-datarutnätet.

• Redigera: Välj redigeringsikonen på en krokrad i datarutnätet, ändra fälten och välj Spara.
• Ta bort: Markera kryssrutan bredvid de krokar som du vill ta bort, välj Ta bort i verktygsfältet och bekräfta.

Datarutnätet återspeglar omedelbart dina ändringar.

Skapa krokar på subagentnivå

Du konfigurerar hookar på subagentnivå direkt i en underagents definition. De gäller endast när den specifika subagenten körs, inte för huvudagenten eller andra underagenter.

Öppna underagentens krokpanel

Följ de här stegen för att komma åt hookkonfigurationen för en specifik underagent.

1. I sidofältet expanderar du Builder och väljer Subagent builder.
2. Välj en befintlig underagent för att redigera den eller välj Skapa för att starta en ny.
3. Rulla ned i formuläret för underagenten till avsnittet Hooks.
4. Välj Hantera kopplingar.

En sidopanel öppnas med avsnitten Stopp och Efter verktygsanvändning. Om inga krokar har konfigurerats visas tomma tillstånd med vägledningstext.

Lägg till en hook till en underagent

Följande steg lägger till en Stoppkrok som säkerställer att den här underagenten alltid svarar med ett sammanfattningsavsnitt.

1. I panelen Hantera krokar väljer du Lägg till krok längst ned på panelen.

2. Fyll i krokformuläret i dialogrutan:

   Fält	Värde
   Händelsetyp	Stopp
   Typ av krok	Omedelbar
   Uppmaning	Check the response below. $ARGUMENTS Does it include a clear summary section at the end? If yes: {"ok": true} If no: {"ok": false, "reason": "Add a Summary section at the end of your response."}
   Tidsgräns (sek)	30
   Felläge	Tillåt
   Maximalt antal avslag	3

3. Välj Spara på kroken.

4. Välj Skapa (eller Spara) på underagenten för att spara den fullständiga konfigurationen.

Kroken visas i panelen Hantera krokar under avsnittet Stoppa . Underagentformuläret visar Hantera krokar (1) på knappen.

Hantera krokar per tråd

Krokar på agentnivå med Always-aktivering är aktiva i varje konversation som standard. Du måste aktivera krokar manuellt med aktivering på begäran per tråd.

Växla funktioner i en konversation

Följ dessa steg för att aktivera eller inaktivera krokar i en specifik tråd.

1. Öppna en chatttråd .
2. Välj +-knappen i chattsidfoten.
3. Välj Hantera hooks.
4. Växla krokar på eller av för den aktuella tråden.

Du kan tillfälligt inaktivera Always Hooks. Du kan aktivera på begäran-anrop när det behövs. Du kan inte ändra nödvändiga systemhakar.

Hookändringarna träder i kraft omedelbart i den aktuella tråden.

Felsökning

I följande tabell visas vanliga problem och lösningar när du skapar och hanterar krokar i portalen.

Nästa steg

Relaterat innehåll

• Översikt över funktioner för agentkrokar
• Självstudie: Konfigurera agentkrokar via REST API
• Körningslägen