Problemen met Genie-agents oplossen

Los veelvoorkomende problemen op bij het maken en onderhouden van een Genie-agent: verkeerd begrepen bedrijfsjargon, onjuist gebruik van tabellen of kolommen, filterfouten bij specifieke waarden en afbreking door tokenlimieten in lange gesprekken. In elke sectie hieronder wordt het symptoom, de oorzaak en de oplossing behandeld.

Voor veel van deze problemen is het snelste pad naar een oplossing Genie Code. Beschrijf het probleem met Genie Code en stelt contextwijzigingen voor die u kunt controleren en accepteren. Als u één onjuist antwoord wilt diagnosticeren, raadpleegt u Debug-antwoorden met Genie Code. Zie Een benchmarkuitvoering analyseren met Genie Code om benchmarkfouten samen te bekijken.

Verkeerd begrepen bedrijfs jargon

De meeste bedrijven of domeinen hebben een specifieke afkorting die ze gebruiken om te communiceren over bedrijfsspecifieke gebeurtenissen. Als u bijvoorbeeld naar een jaar verwijst, betekent dit misschien altijd het fiscale jaar en kan dit fiscale jaar beginnen in februari of maart in plaats van januari. Om Genie in staat te stellen deze vragen natuurlijk en nauwkeurig te beantwoorden, moet u instructies opnemen die uw bedrijfsjargon expliciet toewijzen aan woorden en concepten die Genie kan begrijpen. Zie Instructies geven.

Onjuist tabel- of kolomgebruik

Als Genie gegevens probeert op te halen uit een onjuiste tabel of een analyse uitvoert op onjuiste kolommen, kunt u de gegevens op een van de volgende manieren aanpassen:

• Geef duidelijke en nauwkeurige beschrijvingen op: Controleer uw tabellen en de bijbehorende metagegevens om te controleren of de terminologie die daar wordt gebruikt, overeenkomt met de terminologie van de gebruikers in ingediende vragen. Als dat niet het geval is, verfijnt u de beschrijving of voegt u een instructie toe waarmee de terminologie die in de tabel wordt gebruikt, wordt toegewezen aan de terminologie die in de vraag wordt gebruikt.
• Voorbeeldquery's toevoegen: Geef voorbeeldquery's op die Genie kan gebruiken om te leren hoe u op bepaalde vragen kunt reageren. Zie Instructies geven.
• Tabellen of kolommen verwijderen uit de agent: sommige tabellen bevatten mogelijk overlappende kolommen of concepten die het moeilijk maken voor Genie om te weten welke gegevens in een antwoord moeten worden gebruikt. Verwijder indien mogelijk onnodige of overlappende tabellen of kolommen. Als u kolommen wilt verbergen in de gebruikersinterface van genieagent zonder de onderliggende gegevensobjecten te wijzigen, raadpleegt u Relevante kolommen verbergen of weergeven.

Filterfouten

Gegenereerde query's bevatten vaak een WHERE component om resultaten te filteren op basis van een specifieke waarde. Als Genie geen inzicht heeft in de gegevenswaarden, kan de WHERE component worden ingesteld om te filteren op de verkeerde waarde. Het kan bijvoorbeeld proberen om de naam 'Californië' te vinden wanneer de tabel afkortingen zoals 'CA' gebruikt.

Voor dergelijke situaties controleert u of voor relevante kolommen voorbeeldwaarden en waardewoordenlijsten zijn ingeschakeld. Als er nieuwe gegevens zijn toegevoegd aan relevante tabellen, vernieuwt u de waarden. Zie Overzicht van promptmatching.

Onjuiste koppelingen

Als foreign key-verwijzingen niet zijn gedefinieerd in Unity Catalog, weet uw agent mogelijk niet hoe verschillende tabellen aan elkaar gekoppeld moeten worden.

Probeer een of meer van de volgende oplossingen te implementeren:

• Definieer waar mogelijk vreemde sleutelverwijzingen in uw Unity Catalog. Zie CONSTRAINT clausule.
• Als de foreign key-relaties van uw tabellen niet zijn gespecificeerd in Unity Catalog, moet u join-relaties definiëren in de kennisopslag van uw Genie-agent. Deze strategie is handig voor complexere joinscenario's, zoals self-joins, of als u niet over voldoende machtigingen beschikt om de onderliggende tabellen te wijzigen. Zie Koppelingsrelaties definiëren.
• Geef voorbeeldquery's op waarbij u tabellen op standaard manieren samenvoegt.

Als geen van deze oplossingen het probleem oplost, voegt u de tabel vooraf toe aan een weergave en gebruikt u deze als invoer voor de agent.

Kolomopmerkingen worden niet gesynchroniseerd van vreemde tabellen

Azure Databricks beheert de metagegevens, gegevens of semantiek voor schrijfbewerkingen naar refererende tabellen niet. Afhankelijk van de brontabel zijn opmerkingen mogelijk niet toegankelijk vanuit Azure Databricks. Als u opmerkingen beschikbaar wilt maken, raadt Azure Databricks u aan een van de volgende handelingen uit te voeren:

• Bewerk kolommetagegevens in de gebruikersinterface van de Genie Agent. Bewerkte metagegevens zijn alleen van toepassing op de Genie-agent waar deze is geschreven. Zie Metagegevens van kolom bewerken.
• Maak een materiële weergave op basis van federatieve tabellen. U kunt opmerkingen toevoegen en bewerken in een gerealiseerde weergave zoals u dat zou doen in een beheerde tabel. U kunt deze weergave opnieuw gebruiken voor meerdere Genie Agents. Zie Gegevens uit refererende tabellen laden met gerealiseerde weergaven voor meer informatie over het laden van gegevens uit refererende tabellen naar een gerealiseerde weergave. Zie Gerealiseerde weergaven voor meer informatie over het werken met gerealiseerde weergaven.

Problemen met metrische berekeningen

De manier waarop metrische gegevens worden berekend en samengeteld, kan willekeurig ingewikkeld zijn en veel zakelijke gegevens omvatten die uw agent niet begrijpt. Dit kan leiden tot onjuiste rapportage.

Probeer een of meer van de volgende oplossingen te implementeren:

• Definieer uw metrische gegevens als SQL-expressies in het kennisarchief. SQL-expressies bieden herbruikbare, nauwkeurige definities voor metingen, filters en dimensies die Genie consistent kan toepassen. Zie SQL-expressies definiëren.
• Als uw metrische gegevens worden samengevoegd vanuit basistabellen, geeft u voorbeelden van SQL-query's op die elke samengetelde waarde berekenen.
• Als uw metrische gegevens vooraf zijn berekend en zich in geaggregeerde tabellen bevinden, moet u dit uitleggen in tabelopmerkingen. Geef geldige aggregaties op voor elke metrische waarde als de metrische gegevens in die tabel verder kunnen worden samengeteld.
• Als de SQL die u probeert te genereren erg ingewikkeld is, kunt u proberen weergaven te maken die al uw metrische gegevens voor uw agent hebben geaggregeerd.

Onjuiste berekeningen op basis van tijd

Genie kan mogelijk niet altijd de tijdzone afleiden die wordt weergegeven in de gegevens of de tijdzone waarin uw analyse moet worden uitgevoerd, tenzij u expliciet aanvullende richtlijnen verstrekt.

Voeg meer expliciete instructies toe over de oorspronkelijke brontijdzone, de conversiefunctie en de doeltijdzone. In de volgende voorbeelden ziet u hoe u de algemene instructies voor betrouwbaardere tijdzoneconversies kunt wijzigen:

• Altijd tijden converteren naar een specifieke tijdzone: in dit voorbeeld wordt ervan uitgegaan dat de tijdstempel van de bron UTC is en dat u resultaten in de America/Los_Angeles tijdzone wilt opnemen. Voeg het volgende toe aan de instructies en vervang <timezone-column> door de juiste kolomnaam.
  • Tijdzones in de tabellen bevinden zich in UTC.
  • Converteer alle tijdzones met behulp van de volgende functie: convert_timezone('UTC', 'America/Los_Angeles', <timezone-column>).
• Converteer niet-UTC-datum/tijd-notaties naar UTC: Als de standaardtijdzone van de werkruimte is UTC maar gebruikers in Los Angeles vandaag moeten verwijzen naar een specifieke set records, voegt u het volgende toe aan de algemene instructies van de agent:
  • Als u vandaag wilt verwijzen, gebruikt u date(convert_timezone('UTC', 'America/Los_Angeles', current_timestamp())).

Zie convert_timezone functie voor meer informatie en syntaxis.

Instructies negeren

Zelfs als u uw tabellen en kolommen in opmerkingen hebt uitgelegd en algemene instructies hebt opgegeven, gebruikt uw agent deze mogelijk nog steeds niet correct.

Probeer een of meer van de volgende strategieën:

• Geef voorbeeldquery's op die uw tabellen correct gebruiken. Voorbeeldquery's zijn met name effectief voor het leren van uw agent hoe u uw gegevens gebruikt.
• Verberg irrelevante kolommen in de Genie Agent. Zie Relevante kolommen verbergen of weergeven.
• Maak weergaven van uw tabellen die een eenvoudigere weergave van uw gegevens bieden.
• Bekijk uw instructies en probeer de agent te concentreren door irrelevante tabellen of instructies te verwijderen.
• Probeer een nieuwe chat te starten. Eerdere interacties kunnen invloed hebben op de reacties van Genie in een bepaalde chat, maar het starten van een nieuwe chat geeft u een leeg startpunt voor het testen van nieuwe instructies.

Prestatieproblemen

Wanneer Genie uitzonderlijk lange query's of tekstreacties moet genereren, kan het lang duren om te reageren of zelfs een time-out tijdens de denkfase.

Probeer een of meer van de volgende acties om de prestaties te verbeteren:

• Controleer de querygeschiedenis om langzame queries te identificeren. Veel prestatieproblemen kunnen worden opgelost door de gegenereerde SQL-query's te optimaliseren in plaats van de Genie Agent-configuratie te wijzigen. Bekijk de uitvoeringstijden van de query en queryplannen in de querygeschiedenis van uw SQL Warehouse om knelpunten en mogelijkheden voor optimalisatie te identificeren.
• Gebruik betrouwbare middelen of weergaven om complexe query's te encapsuleren. Zie Vertrouwde middelen.
• Verminder waar mogelijk de lengte van uw voorbeeldquery's voor SQL.
• Start een nieuwe chat als Genie trage of mislukte reacties begint te genereren.

Onbetrouwbare reacties op bedrijfskritieke vragen

Gebruik vertrouwde assets om geverifieerde antwoorden te geven op specifieke vragen die gebruikers verwachten te stellen. Zie Vertrouwde middelen.

Waarschuwing voor tokenlimiet

Tokens zijn de basiseenheden van tekst die Genie gebruikt om taal te verwerken en te begrijpen. Tekstinstructies en metagegevens in een Genie Agent worden geconverteerd naar tokens. Als uw agent de tokenlimiet nadert, wordt er een waarschuwing weergegeven. Genie gebruikt contextfilters om prioriteit te geven aan de tokens die het meest relevant zijn voor een vraag. Hoewel reacties nog steeds moeten worden gegenereerd wanneer er een waarschuwing wordt weergegeven, kan de kwaliteit worden verminderd als belangrijke context wordt gefilterd. Wanneer de tokenlimiet is overschreden, kunt u geen berichten meer verzenden of ontvangen in de Genie-agent.

Houd rekening met de volgende procedures om het aantal tokens te verminderen:

• Overbodige kolommen verwijderen: onnodige kolommen in uw tabellen kunnen aanzienlijk bijdragen aan tokengebruik. Indien mogelijk, maak weergaven om redundante of niet-essentiële velden uit te sluiten van uw ruwe tabellen. U kunt ook overbodige kolommen verbergen in een Genie Agent. Zie Relevante kolommen verbergen of weergeven.
• Stroomlijn kolombeschrijvingen: hoewel kolombeschrijvingen belangrijk zijn, vermijdt u het dupliceren van informatie die al door kolomnamen wordt overgebracht. Als een kolom bijvoorbeeld een naam account_nameheeft, kan een beschrijving zoals 'de naam van uw account' overbodig zijn en kunnen worden weggelaten.
• Kolommetagegevens bewerken in de Genie Agent: Zie Kolommetagegevens bewerken voor meer informatie over het bewerken van beschrijvingen en het opgeven van synoniemen in kolommetagegevens.
• Voorbeeld SQL-query's opschonen: Neem een breed scala aan voorbeelden van SQL-query's op om verschillende soorten vragen te behandelen, maar verwijder overlappende of redundante voorbeelden.
• Vereenvoudig de instructies: controleer of uw instructies duidelijk en beknopt zijn. Vermijd onnodige woorden.

Uw account is niet ingeschakeld voor cross-geo-verwerking

Genie is een Designated Service die wordt beheerd door Azure Databricks. Aangewezen Diensten gebruiken Databricks Geos voor het beheren van gegevensresidentie. Gegevens kunnen niet worden verwerkt in dezelfde geografische locatie als de werkruimte voor sommige regio's. Als uw werkruimte zich in een van deze regio's bevindt, moet cross-geo-verwerking worden ingeschakeld door uw accountbeheerder.

De laatste auteur van de agent wordt verwijderd uit de werkruimte

Een Genie Agent krijgt toegang tot zijn SQL-warehouse met behulp van de rekengegevens die zijn ingebed door de auteur die het meest recent heeft geconfigureerd. Als die auteur uit de werkruimte wordt verwijderd, zijn de ingesloten aanmeldingsgegevens niet meer geldig en mislukken query’s voor iedereen die de agent gebruikt.

Als u de agent wilt herstellen, laat dan een andere gebruiker met ten minste de machtiging 'Kan bewerken' voor de Genie-agent het SQL-warehouse van de agent opnieuw configureren. Als u een warehouseselectie opslaat, worden de compute-inloggegevens van de gebruiker die de bewerking uitvoert opgenomen in plaats van die van de verwijderde auteur. Zie Instellingen configureren.