Fonctionnalités principales
Agent Lens fournit les fonctionnalités principales suivantes :- Visibilité sur les sessions d’agent et les conversations sur plusieurs tours de conversation.
- Traçage des sous-agents pour savoir précisément quel travail vos agents délèguent à des sous-agents.
- Analyses agrégées des comportements, des erreurs et des tendances de votre agent.
- Suivi de comportements personnalisés à l’aide de tags qui décrivent les comportements d’agent ou d’utilisateur que vous souhaitez analyser.
- Métriques du tableau de bord indiquant l’utilisation, les taux d’erreur et le coût en jetons.
- Collecte de feedback pour capturer les évaluations et les annotations humaines.
Fonctionnement d’Agent Lens
Agent Lens repose sur OpenTelemetry (OTel) et sur les conventions sémantiques GenAI. Agent Lens accepte n’importe quel span OTel et en stocke les attributs pour que vous puissiez les interroger. Les spans conformes aux conventions GenAI relatives aux agents, commeinvoke_agent et execute_tool, font l’objet d’un rendu dans Agent Lens sous forme de conversations, de tours de conversation et d’appels d’outil.
Options d’intégration
Selon vos besoins, vous pouvez intégrer Agent Lens à l’aide des guides suivants :- Si votre agent est déjà instrumenté avec OTel, vous pouvez envoyer ses spans existants à Agent Lens sans réinstrumenter votre code. Découvrez comment envoyer vos spans existants à Agent Lens sans aucune intégration de SDK.
- Si vous souhaitez tracer un harness existant, comme Codex ou Claude Code, installez son plugin Weave. Le plugin envoie les spans de votre harness vers votre projet, où ils s’affichent dans Agent Lens.
- Si votre agent appelle un modèle via le SDK OpenAI, Anthropic ou Google Gen AI, consultez les intégrations de SDK de fournisseurs de LLM.
- Si vous développez un agent avec un SDK d’agent populaire, consultez les intégrations de SDK d’agent prises en charge.
- Si vous développez un agent personnalisé et avez besoin d’aide pour l’instrumenter, consultez le guide de démarrage rapide pour les agents personnalisés.
Agent Lens et Weights & Biases Weave
Agent Lens est un nouveau produit d’observabilité des agents, conçu par l’équipe qui développe Weights & Biases Weave. Les deux produits font partie de CoreWeave Forge et peuvent être utilisés ensemble. Ils partagent les mêmes données de trace : toutes les traces d’agents que vous envoyez à l’un apparaissent dans l’autre, sans aucune donnée à copier ni à migrer. Agent Lens est la solution recommandée pour le traçage, la surveillance et l’analyse des agents. Il offre des fonctionnalités absentes de Weave, comme des analyses sur les échecs des agents et les intentions des utilisateurs, ainsi qu’une vue simplifiée des conversations, des tours de conversation et des spans. Si vous utilisez déjà Weave pour tracer des agents, ouvrez le même projet dans Agent Lens pour y retrouver vos conversations existantes. Weave continue de prendre en charge les flux de travail qu’Agent Lens ne gère pas encore, notamment :- Les évaluations
- Les traces propres à chaque fonction, à l’aide des ops et des appels
- Les garde-fous
Utilisez l’App Launcher situé dans le coin supérieur gauche de la console CoreWeave Forge pour sélectionner Agent Lens ou Weights & Biases.
Agent Lens et Weave partagent le même backend ; certains noms de configuration conservent donc le nommage Weights & Biases :
WANDB_API_KEY: la variable d’environnement dans laquelle le Forge SDK lit votre clé API CoreWeave Forge.trace.wandb.ai: le point de terminaison qui reçoit les traces.wandb.entityetwandb.project: les attributs de ressource OpenTelemetry qui acheminent les spans vers votre projet.
weave-claude-code, weave-codex et weave-openclaw). Les traces qu’elles envoient apparaissent à la fois dans Agent Lens et dans Weave.