Havaittavuus Fabric-dataagenteille Microsoft Foundryssa

Voit lisätä Fabric-dataagentin työkaluksi agenttiin, jonka rakennat Microsoft Foundryssa. Kun olet yhdistänyt sen, Foundry-agentti kutsuu Fabric-dataagentin vastatakseen kysymyksiin, jotka perustuvat yrityksesi dataan, joka sijaitsee Fabric OneLakessa.

Tämä artikkeli käsittelee havaittavuutta kyseisessä kokoonpanossa. Kun rakennat agentin Foundryssa ja liität siihen Fabric-dataagentin, haluat nähdä, mitä dataagentti teki jokaisessa pyynnössä, et pelkästään lopullista vastausta. Foundry Observability antaa sinulle tuon näkyvyyskyvyn. Dataagentin lokit ja jäljitykset lähetetään samaan paikkaan, johon Foundry-agenttisi jo raportoi, joten voit seurata pyyntöä päästä päähän, Foundry-agentilta, Fabric-dataagentille ja aina kyselyyn lähteisiin.

Tämän artikkelin loppuosa selittää, missä telemetria säilytetään, miten se sinne päätyy, miten sitä lukee, kuka sen näkee ja miten sitä hallitaan.

Yleiskatsaus löytyy kohdasta Havaittavuus generatiivisessa tekoälyssä . Yhdistääksesi Fabric-dataagentin Foundryyn, katso Käytä dataagenttia Microsoft Foundryssa.

Foundry-projektit ja Application Insights

Foundry-projekti on paikka, jossa rakennat ja johdat agenttejasi. Foundry tallentaa agenttijäljet Azure Monitor Application Insights -resurssiin, ja jokainen projekti yhdistyy yhteen tällaiseen resurssiin.

Agenttirakentajana järjestä tämä kerran. Foundry-projektissasi avaa Agentit-osio , valitse Jäljet ja valitse Yhdistä. Voit luoda uuden Application Insights -resurssin tai yhdistää sellaisen, joka on jo olemassa. Kun yhdistät resurssin, Foundry käynnistää automaattisesti projektin palvelinpuolen jäljityksen. Sinun ei tarvitse tehdä koodimuutoksia, ja jäljet alkavat virrata muutamassa minuutissa.

Suhde on yksinkertainen: projekti osoittaa yhteen Application Insights -resurssiin, ja jokainen kyseisen projektin agentti lähettää jäljet sinne. Projekti määrittelee, missä telemetria kerätään; Application Insights on paikka, jossa se sijaitsee ja jossa sitä kysytään.

Voit tarkastella jälkiä Foundry-agenttisi Traces-välilehdellä tai hakea niitä suoraan yhdistetyssä Application Insights -resurssissa. Foundry-portaali näyttää jälkiä viimeisen 90 päivän ajalta.

Vaiheittaisen asennuksen osalta katso Perusta jäljitys tekoälyagenteille Microsoft Foundryssa.

Miten Fabric-dataagentin lokit ja jäljet saavuttavat projektisi

Yhdistääksesi Fabric-dataagentin Foundryyn, työskentele Foundry-projektissa. Jos yhdistät Application Insights -resurssin kyseiseen projektiin, Fabric-dataagentti lähettää lokit ja jäljitykset samaan resurssiin. Foundry-agenttisi telemetria ja Fabric-dataagentin telemetria asettuvat yhteen paikkaan, joten voit lukea ne yhdessä.

Kulku toimii näin:

1. Yhdistä Foundry-projektissasi Application Insights -resurssi, kuten edellisessä osiossa kuvattiin.
2. Lisää Fabric-dataagentti työkaluksi Foundry-agentille kyseisessä projektissa.
3. Kun Foundry-agentti käynnistyy, se kutsuu Fabric-dataagentin saadakseen oivalluksia Fabric OneLaken yritysdatasta.
4. Fabric validoi projektiin liitetyn Application Insights -resurssin ja lähettää sitten dataagentin lokit ja jäljitykset siihen.
5. Dataagentin telemetria näkyy Foundry-agentin jäljitysten rinnalla sekä yhdistetyssä Application Insights -resurssissa että agentin Traces-näkymässä .

Tämän seurauksena Fabric-dataagentin tekemä työ tulee osaksi pyynnön jäljitystä. Näet, että Foundry-agenttisi kutsui dataagentin, ja näet, mitä dataagentti teki vastauksen tuottamiseksi, mukaan lukien mitä tietolähteitä se kysyi, kuinka kauan kukin vaihe kesti ja onnistuiko kukin vaihe.

Lue jäljet

Foundry Observability tallentaa jokaisen pyynnön jäljityksenä. Jälje koostuu jänteistä, ja jokainen jänne edustaa yhtä työyksikköä omalla aloitusajallaan, kestoineen ja tilallaan. Jänteet ovat sisäkkäin, joten jäljen lukeminen ylhäältä alas näyttää reitin, jonka pyyntö kulki ja missä aika on käytetty.

Fabric-dataagentti lisää jäljelle kahta tyyppiä santia:

• Agentin laajuus: Fabric-dataagentin kokonaiskäyttö yhdelle pyynnölle.
• Työkalukokonaisuus: yksittäinen tietolähde tai työkalu, johon dataagentti vastaa pyyntöön. Yksi pyyntö voi tuottaa useamman kuin yhden työkalukokonaisuuden.

Seuraava esimerkki esittää Foundry-agentin, joka kutsuu Fabric-dataagenttia, joka kysyy kahta tietolähdettä vastatakseen kysymykseen:

Request (trace)
└─ Foundry agent run
   └─ Fabric data agent (called as a tool)
      └─ Agent span            Overall run of the Fabric data agent
         ├─ Tool span          First data source the data agent queried
         └─ Tool span          Second data source the data agent queried

Seuraava taulukko kuvaa jokaisen jäljen tason ja siihen liitetyn metatiedon tyyppin.

Tämän rakenteen avulla voit vastata tärkeisiin kysymyksiin, kun jokin näyttää oudolta:

• Kun vaste on hidas, kunkin vaiheen kesto kertoo, mikä vaihe vei eniten aikaa.
• Kun vastaus on väärä, työkalujen kokonaisuudet näyttävät, mitkä tietolähteet on haettu ja missä järjestyksessä.
• Kun pyyntö epäonnistuu, jokaisen sängyn tila näyttää, missä vika tapahtui.

Kuka näkee lokit ja jäljet

Application Insights -resurssi, joka tallentaa dataagentin lokit ja jäljitykset, ohjaa pääsyä. Jokainen, jolla on lukuoikeus kyseiseen resurssiin, voi nähdä telemetrian. Resurssin yhdistäminen projektiin ei anna pääsyä sen sisältämiin tietoihin.

Pääsy Foundry-projektiin yksinään ei sisällä pääsyä telemetriaan. Lukulupa Application Insights -resurssissa vaaditaan aina.

Operatiivisen metatietovuokralaisen asetus

Fabric-hallintaportaalin tenant-asetus ohjaa, lähettävätkö Fabric-dataagentit operatiivisia metatietoja havaittavuutta varten Foundryssa. Asetus on oletuksena päällä.

Asetus lähettää vain toiminnallisia metatietoja. Tähän metatietoon kuuluvat agenttien näyttönimet, tietolähteiden nimet, päättelyvaiheen ID:t ja keskustelutunnisteet. Fabric ei lähetä asiakassisältöä. Käyttäjäkehotteet ja dataagentin vastaukset pysyvät Fabric:n vaatimustenmukaisuuden rajojen sisällä eivätkä sisälly tähän telemetriaan.

Tapahtumapaikka kuuluu seuraavasti.

Fabric-dataagentit voivat lähettää operatiivisia metatietoja havaittavuutta varten Microsoft Foundryssa

Agenttien kehittäjät voivat käyttää operatiivista metadataa seuratakseen agenttien terveyttä, havaitakseen ongelmia ja ymmärtääkseen, miten heidän julkaistuja agenttejaan käytetään sovelluksissa ja palveluissa. Nämä oivallukset auttavat agenttien luojia parantamaan agenttien luotettavuutta ja suorituskykyä.

Kun otat tämän asetuksen käyttöön, Fabric-dataagentit lähettävät operatiivisia metatietoja konfiguroidulle Application Insights -resurssille käsiteltäväksi ja tallennettavaksi. Näihin tietoihin kuuluvat agenttien näyttönimet, tietolähteiden nimet, päättelyvaihe-ID:t ja keskustelutunnisteet. Application Insights -resurssi, joka käsittelee ja tallentaa tätä dataa, saattaa sijaita vuokralaisen maantieteellisen alueen, vaatimustenmukaisuuden rajan tai kansallisen pilvi-instanssin ulkopuolella.

Toiminnallisiin metatietoihin pääsemiseksi tarvitset roolin, jolla on lukuoikeudet (kuten Monitoring Reader tai Log Analytics Reader) konfiguroidussa Application Insights -resurssissa. Käyttäjät, joilla on tämä pääsy, voivat tarkastella tietoja Application Insightsissa. Käyttäjät voivat myös tarkastella dataa Foundry-projektin kautta, joka yhdistyy konfiguroituun Application Insights -resurssiin. Pääsy Foundryn kautta vaatii roolipohjaisen pääsyn Foundry-projektiin (Foundry User tai sitä korkeampi) sekä lukuoikeudet Application Insights -resurssissa. Pelkkä Foundry-projektiin pääsy ei tarkoita pääsyä telemetriadataan.

Liittyvä sisältö

• Käytä dataagenttia Microsoft Foundryssa
• Perusta jäljitys tekoälyagenteille Microsoft Foundryssa
• Havaittavuus luodussa tekoälyssä
• Määritä Fabric data agentin vuokralaisasetukset