Nyomkövetés és adatkezelés

Az öntödei nyomkövetés a Microsoft Foundry megfigyelhető képessége, amely az ügyféladatokat AI-ügynököktől rögzíti. Segít a fejlesztőknek és az operátoroknak megérteni a rendszer viselkedését, a hibakeresési problémákat és optimalizálni a teljesítményt.

A nyomonkövetési rekordok információi például a következők:

  • Felhasználói bemenetek és kérések
  • Ügynök- és modellbemenetek és -kimenetek
  • Eszközhívások és köztes lépések
  • Végrehajtási metaadatok (időbélyegek, késés, tokenhasználat, hibák stb.)

Ezek az adatok tartalmazhatnak felhasználó által létrehozott tartalmakat és működési telemetriát.

Ezek az adatok az ügynökök működésének átláthatóságát biztosítják, lehetővé téve a hibaelhárítást és a teljesítmény javítását az ügynök munkafolyamatai között. Az Foundry OpenTelemetry szabványokat használ, és nyomkövetési adatokat tárol csatlakoztatott telemetriai rendszerekben Azure Monitor Application Insightsban.

Important

Amikor engedélyezi az AppInsightst egy projekthez, az AppInsights naplózza a nyomkövetéseket, hogy segítsen a felhasználói szintű interakciók figyelésében és kiértékelésében az ügynökökkel. Project AppInsights Log Analytics Olvasó szerepkörrel rendelkező tagjai megtekinthetik a nyomkövetési adatokat, amelyek személyes adatokat és ügyféltartalmakat tartalmazhatnak. Ha a mögöttes Log Analytics táblák védettek (védelmi szintjük védett), a tagoknak a kiemelt figyelési adatolvasó szerepkörre van szükségük a nyomkövetési adatok megtekintéséhez. Tekintse át, hogy milyen nyomkövetési adatokat gyűjtünk, és ki tekintheti meg és használhatja ezeket az adatokat. További információ a következő szakaszban található.

Alapértelmezett állapot:

  • A nyomkövetés alapértelmezés szerint ki van kapcsolva.
  • A nyomkövetési adatokat nem gyűjtik és nem tárolják, kivéve, ha ezt a Foundry Account Owner vagy a Foundry Owner kifejezetten engedélyezi.

További Azure Monitor App Insights-díjszabás vonatkozhat.

Ez biztosítja, hogy az ügyfelek megtartsák az irányítást az adatgyűjtés megkezdésekor.

Nyomkövetés engedélyezése

A nyomkövetés akkor engedélyezett, ha egy projekt egy Azure Monitor Application Insights-erőforráshoz csatlakozik. A gyakori engedélyezési folyamatok a következők:

  • Application Insights-erőforrás létrehozása vagy csatlakoztatása a projekt létrehozása során.
  • Application Insights-erőforrás létrehozása vagy csatlakoztatása meglévő projekthez csatlakoztatott Application Insights-erőforrás nélkül.

Ha engedélyezi a nyomkövetést:

  • A nyomkövetési adatok gyűjtése és tárolása megkezdődött a projekten belüli összes ügynök számára.
  • Az Foundry nyomkövetési felhasználói felületén lévő nyomkövetések megtekintéséhez a felhasználóknak hozzáférésre van szükségük az Foundry-projekthez, és olvasási jogosultságra van szükségük a csatlakoztatott Application Insightsban vagy Log Analytics munkaterületen. Ezt a hozzáférést például olyan szerepkörök adhatják meg, mint például Log Analytics Olvasó, Figyelési olvasó vagy Olvasó az Application Insights-erőforrásban, Log Analytics munkaterületen vagy egy megfelelő szülőhatókörben. Ha a mögöttes Log Analytics táblák védettek, a hozzárendelt személyeknek a Privileged Monitoring Data Reader szerepkörre is szükségük van az adatok olvasásához.

Nyomkövetés letiltása

Nyomkövetés letiltása a következővel:

  • Az Application Insights-erőforrás leválasztása vagy eltávolítása.

A nyomkövetés letiltása után:

  • A projektben lévő ügynökök nem gyűjtenek új nyomkövetési adatokat.
  • A korábban gyűjtött adatokra az Application Insights adatmegőrzési szabályzatai vonatkoznak.

Megjegyzés:

A nyomkövetés letiltásának pontos lépései a felhasználói felülettől vagy az SDK-felülettől függenek, és igazodniuk kell a termékdokumentációhoz.

Az adatok tárolási helye

  • Az Foundry-projekthez csatlakoztatott Application Insights-erőforrás nyomkövetési adatokat tárol.
  • Az Application Insights és Log Analytics konfigurációja szabályozza az adatmegőrzést és a tárolást. További információ: Adatmegőrzés kezelése Log Analytics-munkaterületen.

Adatmegosztási szempontok

  • A nyomkövetési adatok elérhetők lehetnek a csatlakoztatott telemetriai erőforráshoz megfelelő engedélyekkel rendelkező felhasználók számára.
  • A konfigurációtól függően az ugyanabban a projektben vagy bérlőben lévő felhasználók láthatják az adatokat.
  • Az Foundry nyomkövetési felhasználói felületén lévő nyomkövetések megtekintéséhez a felhasználóknak hozzáférésre van szükségük az Foundry-projekthez, és olvasási engedélyt kell olvasniuk a csatlakoztatott Application Insights vagy Log Analytics munkaterületen. Ezt a hozzáférést például olyan szerepkörök adhatják meg, mint például Log Analytics Olvasó, Figyelési olvasó vagy Olvasó az Application Insights-erőforrásban, Log Analytics munkaterületen vagy egy megfelelő szülőhatókörben. Ha a mögöttes Log Analytics táblák védettek, a hozzárendelt személyeknek a Privileged Monitoring Data Reader szerepkörre is szükségük van az adatok olvasásához.
  • Az üzemeltetett ügynökökre vonatkozó további szempontokért és fontos információkért tekintse át az üzemeltetett ügynököket és az üzemeltetett ügynök platform által injektált környezeti változóit.

Az ügyfelek felelősek a hozzáférés-vezérlések konfigurálásáért és a szervezeti szabályzataiknak való megfelelésért.

Adatvédelem

A nyomkövetés a következő személyes adatokat képes rögzíteni:

  • Felhasználói kérések és válaszok
  • Alkalmazásspecifikus tartalom

Bevált gyakorlatok

  • Kerülje a titkos kódok, hitelesítő adatok vagy jogkivonatok naplózását.
  • A személyes adatok naplózása előtt helyezze át vagy minimalizálja a személyes adatokat.
  • Hozzáférés-vezérlési és adatmegőrzési szabályzatok alkalmazása az adatok nyomon követéséhez.

Adatvédelmi vezérlők

  • Személyes adatok kitakarása: Takarja ki a személyes adatokat, például az e-mail-címeket és a telefonszámokat.
  • A nyomkövetési adatokhoz való hozzáférés korlátozásához gondosan felügyelheti, hogy mely felhasználók kapják meg az RBAC Log Analytics Olvasó szerepkört. Ha a mögöttes Log Analytics táblák védettek, akkor azt is kezelheti, hogy ki rendelkezik kiemelt figyelési adatolvasói szerepkörsel, mert olvasási hozzáférést biztosít a védett táblákhoz.
  • Konfigurálható szabályzatok: A rögzített és látható adatok szabályozása.

Ezek a vezérlők segítenek a kockázatok kezelésében és az adatvédelmi követelményeknek való megfelelésben.

Ügyfél felelősségi köre

Ha engedélyezi a nyomkövetést, a következő a feladata:

  • A végfelhasználók tájékoztatása az adatgyűjtésről, beleértve az összegyűjtött adatok típusait, a célokat, a láthatóságot, a lehetőségeket és egyéb információkat, amelyek szükségesek ahhoz, hogy ésszerű döntéseket hozzanak (adott esetben).
  • Az adatvédelmi, jogi és szabályozási követelményeknek való megfelelés biztosítása.
  • A megfelelő hozzáférési vezérlők és adatmegőrzési szabályzatok konfigurálása.

Összefoglalás

A Foundry Tracing egy hatékony megfigyelhetőségi funkció, amely lehetővé teszi az AI-ügynökök hibakeresését, monitorozását és optimalizálását. Ez a következő:

  • Alapértelmezés szerint ki van kapcsolva.
  • Telemetria-erőforrások csatlakoztatásával explicit módon engedélyezve.
  • Az adatgyűjtés és -kezelés ügyfél általi vezérlésével lett kialakítva.

Kapcsolódó tartalom

  • Utolsó frissítés időpontja: