Suivre la traçabilité de l’API de modèle et du fournisseur
Unity Catalog capture la traçabilité des APIs de modèle (services de modèle) et des fournisseurs de modèles externes (services de fournisseur de modèles) gouvernés via Unity AI Gateway. Vous pouvez suivre les modèles de fondation servis par chaque service, son routage principal ou de fallback, ainsi que les assets en aval qui consomment les données de charge utile. La traçabilité vous permet de :
- Évaluer l’impact avant de déprécier un modèle de fondation ou un service : identifiez les services ou charges de travail en aval affectés avant de déprécier un modèle de fondation restreint ou de remplacer un fournisseur de modèles.
- Suivez les dépendances entre les données et les assets d'IA : suivez un service depuis les modèles de fondation qu'il dessert jusqu'à la table d'inférence où il journalise les charges utiles, puis jusqu'aux workloads en aval qui consomment les données de charge utile.
Exigences
- Le service de modèle ou le service de fournisseur de modèle doit être enregistré dans un metastore Unity Catalog. Voir Gouverner les APIs de modèle (services de modèle) et Gouverner les fournisseurs de modèles externes (services de fournisseur de modèle).
- Pour afficher la traçabilité d'un service, vous devez disposer au minimum du privilège
BROWSEsur le catalogue parent du service, et le catalogue doit être accessible depuis le workspace. Voir Liaison workspace-catalogue. - La traçabilité respecte les autorisations Unity Catalog. Les objets que vous n’êtes pas autorisé à consulter apparaissent sous forme de nœuds masqués. Pour plus de détails, consultez Autorisations.
Unity AI Gateway n’est pas pris en charge sur AWS GovCloud ou Azure Government.
Quelle traçabilité est capturée
Unity Catalog capture les dépendances d'un service à partir de sa définition : les objets qu'il référence lorsque vous créez ou mettez à jour le service. La traçabilité distingue deux directions, conformément à la traçabilité des tables:
- Les dépendances en amont sont les objets dont dépend un service, comme un modèle de fondation servi.
- Les dépendances en aval sont les objets qui dépendent d’un service, tel qu’une table d’inférence.
Le tableau suivant répertorie les relations de traçabilité capturées pour chaque type de service.
Service | En amont | En aval |
|---|---|---|
API de modèle (service de modèle) | Les modèles de fondation servis, annotés comme PRIMARY ou FALLBACK . Un modèle externe servi apparaît comme son fournisseur de modèle externe. | La table d’inférence configurée pour journaliser les charges utiles des requêtes. |
Fournisseur de modèle externe (service de fournisseur de modèle) | Aucun. Les services de modèle de jugement issus de politiques de garde-fous ne sont pas couverts ici. | Chaque service de modèle configuré pour router vers le fournisseur, et la table d'inférence configurée pour journaliser les charges utiles des requêtes. |
La traçabilité est réciproque : un modèle de fondation servi affiche le service de modèle en tant que consommateur aval sur l'onglet Lineage du modèle de fondation lui-même, et une table d'inférence affiche le service en tant que producteur amont.
Afficher la traçabilité du service dans l'Explorateur de catalogues
Pour afficher la traçabilité d'un service de modèle ou d'un service de fournisseur de modèles :
-
Dans votre workspace Databricks, cliquez sur
Catalog . -
Recherchez ou parcourez le service, puis cliquez sur son nom.
-
Sélectionnez l'onglet tab . The tab répertorie la traçabilité en amont et en aval du service, avec les colonnes suivantes :
- Nom : le nom de l’objet associé.
- Direction : indique si l’objet est en amont ou en aval du service.
- Type : le type de l'objet associé, tel que Modèle , Service de fournisseur de modèle ou Table .
- Dernière activité : date à laquelle la relation de traçabilité a été capturée pour la dernière fois.
-
Pour affiner la liste, saisissez un nom dans Filter lineage , ou filtrez par direction, type d’objet, Workspace et plage temporelle.
L'exemple suivant montre l'onglet Lineage pour le service de modèle main.ai_lineage_demo.customer_support_endpoint. Les assets en amont incluent les modèles de fondation databricks-claude-opus-4-8 et databricks-kimi-k3-neo, ainsi que le service de fournisseur de modèles anthropic qu’il dessert. L’asset en aval est la table d’inférence customer_support_endpoint_payload qui logs ses charges utiles de requête.
Voir le graphe de traçabilité
Le graphe de traçabilité affiche les services et leurs objets associés sous forme de nœuds connectés, afin que vous puissiez explorer visuellement les dépendances à plusieurs sauts.
- Sous l’onglet Traçabilité du service, cliquez sur Voir le graphe de traçabilité .
- Cliquez sur l'icône
sur un nœud pour développer ses connexions. - Pour un service de modèle, les arêtes vers les modèles de fondation ou les services de fournisseur de modèles qu’il dessert sont étiquetées PRIMARY ou FALLBACK . Cliquez sur un nœud pour accéder à l’objet ou explorer sa traçabilité.
Par default, le Graphe affiche la traçabilité sur tous les Workspace associés au metastore. Utilisez le filtre de plage temporelle dans la barre d'outils du graphe pour distinguer les dépendances actives des dépendances obsolètes. Pour limiter les résultats au workspace actuel, sélectionnez un nœud, puis sélectionnez Uniquement ce workspace dans le panneau Détails de la traçabilité .
L’exemple suivant montre le graphe accessible depuis le service de modèle main.ai_lineage_demo.customer_support_endpoint. Le service de fournisseur de modèle anthropic se déploie sur trois services de modèle ; ainsi, une vue unique affiche tous les services qu’une modification apportée à ce fournisseur affecterait. Avant de déprécier un modèle de fondation ou de restreindre l’accès à un service, utilisez le graphe de traçabilité pour :
- Trouvez chaque service affecté dans une seule vue : voyez tous les services de modèle qui desservent un modèle ou un fournisseur donné, au lieu de vérifier chaque service un par un.
- Identifiez les services qui seraient interrompus par rapport à ceux qui se dégradent : les étiquettes d'arête PRIMARY et FALLBACK indiquent quels services échouent si vous supprimez un modèle et lesquels basculent vers un autre, afin que vous puissiez prioriser la migration.
- Contactez les bons propriétaires : chaque nœud affiche son propriétaire, afin que vous sachiez qui avertir. Cliquez sur un nœud pour ouvrir l'objet dans l'Explorateur de catalogues.
Comme la table d’inférence d’un service comporte sa propre traçabilité, vous pouvez l’étendre en aval pour suivre le flux des charges utiles des requêtes et réponses journalisées. Dans l’exemple suivant, la table customer_support_endpoint_payload alimente la vue payload_analysis et ses consommateurs en aval. Voir la traçabilité des tables.
Limitations
La traçabilité du service capture uniquement les dépendances dans la définition d'un service. Unity Catalog ne capture pas les charges de travail et les agents qui appellent un service au moment de l'exécution, ni les données auxquelles ils accèdent par son intermédiaire. Les limitations qui s'appliquent à tout le lignage Unity Catalog s'appliquent également.