Metodtips och begränsningar för operationsagenten

Den här artikeln beskriver metodtips och begränsningar när du använder operationsagenter i Real-Time Intelligence.

Metodtips

Operationsagenter hjälper organisationer att operationalisera tydliga affärsmål genom att kontinuerligt övervaka realtidsdata, utvärdera explicita tröskelvärden och rekommendera åtgärder när definierade villkor uppfylls. Till exempel hjälper åtgärdsagenter dig att svara proaktivt när lagertillgängligheten sjunker till en kritisk nivå. Använd följande metodtips för operationsagenter.

  • Eventhouse-tabeller: Om eventhouse-tabeller innehåller kapslade kolumner, till exempel JSON, platta ut tabellerna innan du konfigurerar agenten. Platta tabeller med beskrivande kolumnnamn förbättrar agentens möjlighet att parsa och utvärdera data.

  • Eventhousekolumnbeskrivningar: Om det är oklart vad en kolumn är avsedd för utifrån dess namn, kan du lägga till en enkel beskrivning i beskrivningsfältet för ditt KQL-tabellschema. Den här beskrivningen hjälper agenten att tolka datavärden korrekt.

  • Tidskolumn för inmatning: Operations Agenten använder som standard inmatningstiden för tabellen för att identifiera när poster anlände. Agenten använder det här värdet när den frågar efter senaste data och för att beräkna ändringar i data över tid. Kontrollera att inläsningstiden har angetts.

  • Identifiering av affärsobjekt: Om agenten behöver övervaka ett specifikt affärsobjekt, till exempel en station, sensor eller personalpost, identifierar du kolumnen som unikt identifierar objektet (till exempel StationID eller SensorID). Om du använder en KQL-databaskälla anger du vilken tabell den tillhör. Om du använder en ontologikälla anger du den entitet som agenten ska använda.

  • Fältnamn som citerar: Om en regel refererar till kolumn- eller egenskapsnamn som innehåller specialtecken, till exempel understreck eller bindestreck, omger du kolumnnamnet inom citattecken (""). Den här metoden säkerställer att agenten identifierar den korrekt.

  • Kvantifierbara villkor: Om en regel använder kvalitativt språk, till exempel "låg tillgänglighet" eller "hög temperatur", ersätter du den med ett specifikt numeriskt tröskelvärde.

    • Använd till exempel en fras som "färre än 3 tillgängliga cyklar" eller "temperaturen överstiger 80". Agenten använder llm-standardkunskapen för att föreslå tröskelvärden för vanliga termer, till exempel "sura villkor" innebär pH <7.

  • Regelavgränsning: Om du definierar flera regler beskriver du varje regel på en separat rad eller punkt. Kombinera inte villkor från olika regler i samma mening.

  • Regelordning: Om agenten behöver prioritera vissa regler ska du först lista regler med högre prioritet. LLM:er kan tolka information på olika sätt baserat på dess position i prompten.

  • Spåra agentfrågor och dataåtkomst: Granska de datakällor och frågor som agenten använder genom att kontrollera den övervakade Eventhouse- eller KQL-databasen. Använd fliken Frågeinsikter för att visa körda frågor och verifiera den genererade KQL:n.

    Skärmbild av fliken Frågeinsikter i KQL-databasen.

Exempelinstruktioner

Här är ett exempel på hur du kan lägga fram dina instruktioner för agenten för att vara tydlig med dess driftsregler och semantisk information om fälten i dina data.

*** Operational Instructions ***
1. Alert me when a trip has high occupancy level.
2. Alert me when a trip has high departure delay.

*** Semantic Instructions ***
1. Information about a trip can be found in 'TripUpdateFlattened' table, each identified by the 'trip_id' column.
2. Information about a vehicle can be found in 'VehiclePositionsFlat' table, each identified the 'vehicle_id' column.
3. A trip is a associated with multiple vehicles via shared trip ID.
4. Occupancy status of a trip is calculated as the latest occupancy status from the vehicle the trip is associated with. The value 'HIGH' means high occupancy level.
5. The departure delay is measured in number of seconds. Higher than 300 seconds of delay is considered significant.

Begränsningar

Operationsagenter har funktions-, plattforms- och beteendebegränsningar som du bör tänka på när du utformar regler och övervakningsscenarier.

Begränsningar för datakälla

  • Endast en datakälla stöds åt gången.
  • När du använder ett Eventhouse som datakälla:
    • Endast vanliga Eventhouse-bord stöds. Genvägstabeller, funktioner och materialiserade vyer stöds inte.
  • När du använder en Fabric Ontology som agentens datakälla:
    • Ontologin måste finnas på samma arbetsyta som operationsagenten.
    • Ontologientiteter som du vill att agenten ska övervaka måste ha minst en statisk egenskap som ska användas som identifierare för entiteter. Tidsseriegenskaper ska bindas till eventhouse-fält.

Begränsningar av ontologiövervakningsregeln

  • När man övervakar en ontologi:
    • Endast grundläggande egenskapsvärden stöds. Sammansättningar som ett genomsnittligt, lägsta eller högsta värde stöds inte.
    • Regler som kräver "AND"-villkor stöds inte (till exempel är bromsindexet för en landningsbana över 0,8 och yttemperaturen är < 40).

Begränsningar för språk- och modellbeteende

Körtidsbegränsningar

  • Agenten kör förfrågningar var femte minut när den är aktiv.
  • Åtgärder upphör att gälla om ingen åtgärd vidtas inom tre dagar. Efter förfallodatumet kan åtgärder inte längre godkännas.

Behörigheter och åtkomstbegränsningar

  • Agenten fungerar med hjälp av den delegerade identiteten och behörigheterna för dess skapare. Det innebär:
    • Frågor och åtgärder använder skaparens autentiseringsuppgifter.
    • Som standard får skaparen rekommendationsmeddelanden. Om du ändrar mottagaren ändras inte de autentiseringsuppgifter som används för frågor och åtgärder.

Begränsningar för meddelanden och strypning

  • Tung användning kan leda till meddelandebegränsning. I dessa fall kan förenklade icke-LLM-genererade meddelanden skickas i Microsoft Teams.

Begränsningar för regioner och arbetsytor

  • Operations-agenten är tillgänglig i Microsoft Fabric-regioner i Azures offentliga moln, med undantag för South Central US och East US.
  • Driftagenten är för närvarande inte tillgänglig i nationella moln, inklusive GCC-High och Bleu.
  • Åtgärdsagenten stöds för närvarande inte i arbetsytor som krypterats med kundhanterade nycklar för Fabric-arbetsytor.
  • Last updated on