Collecte de données de diagnostic pour les problèmes de performance

1. Informations sur le locataire et l'environnement

Commencez par partager des informations de base sur l'environnement. Il aide l'assistance IBM à identifier votre déploiement et votre région, ce qui est essentiel pour localiser les problèmes liés à l'infrastructure.

Partagez les informations suivantes :

• ID du locataire ou CRN : indiquez le CRN de votre locataire. Vous pouvez le trouver en cliquant sur votre profil > À propos. Joindre une capture d'écran de la page "A propos".

• Plate-forme : Indiquez si votre environnement fonctionne sur AWS ou IBM Cloud.

• Région : vous pouvez la trouver en cliquant sur votre profil > Région.

Les détails relatifs au locataire et à la région permettent à l'assistance IBM de vérifier les facteurs de performance spécifiques à la plate-forme ou à la région.

2. Détails du modèle AI

Indiquez le nom du modèle d'IA utilisé par l'agent concerné. Il s'agit d'un point critique car les différents modèles ont des architectures, des capacités et des limites connues qui leur sont propres.

Suivez ces étapes pour trouver les détails du modèle d'IA :

1. Dans le menu principal, cliquez sur Construire.

2. Allez dans Tous les agents et sélectionnez l'agent concerné.

3. Sur la page de configuration de l'agent, copiez et enregistrez les détails du modèle d'IA à partir de la liste des modèles d'IA.

Exemple :

llama-3-2-90b-vision-instruct

Connaître le modèle exact permet à l'assistance IBM de diagnostiquer les problèmes de performance spécifiques au modèle et d'appliquer des correctifs ciblés.

3. Configuration du profil de l'agent

La configuration de l'agent détermine la manière dont l'agent interprète les requêtes et y répond. Des paramètres incorrects peuvent entraîner un comportement ou une latence inattendus.

Voici les étapes à suivre pour trouver les détails :

1. Dans le menu principal, cliquez sur Construire.

2. Allez dans Tous les agents et sélectionnez l'agent concerné.

3. Sur la page de configuration de l'agent, cliquez sur Connaissance.

4. Confirmez le style de l'agent (Défaut ou ReAct ).

5. Vérifiez si la modalité vocale est activée et identifiez les modèles STT et TTS utilisés.

4. Détails de la configuration des connaissances

Les sources de connaissances influencent la manière dont les agents récupèrent et traitent les données. Les étapes suivantes permettent de trouver les détails de la configuration des connaissances :

1. Dans le menu principal, cliquez sur Construire.

2. Allez dans Tous les agents et sélectionnez l'agent concerné.

3. Sur la page de configuration de l'agent, cliquez sur Connaissance.

4. Notez les détails suivants sous Source de connaissances.

   • Sources d'information : Milvus, Elasticsearch, Service personnalisé, Astra DB.

   • Téléchargement de fichiers (le cas échéant) :

     • Types de documents :.docx,.pdf,.pptx,.xlsx,.csv,.html,.txt.

     • Taille du document.

5. Outils et agents collaborateurs

Les outils et les agents collaborateurs jouent un rôle majeur dans les performances de votre agent. Chaque outil ajoute des étapes de traitement, et les intégrations peuvent introduire des temps de latence ou des erreurs. En fournissant ces détails, IBM Support comprend la complexité de votre agent et identifie les goulots d'étranglement potentiels.

Voici les étapes à suivre pour trouver les outils et les détails de l'agent collaborateur :

1. Dans le menu principal, cliquez sur Construire.

2. Allez dans Tous les agents et sélectionnez l'agent concerné.

3. Sur la page de configuration de l'agent, cliquez sur Toolset.

4. Notez les détails sous Outils. Le nombre d'outils utilisés et le type d'outil utilisé ( OpenAPI,Python, MCP Server, Flow, Langflow).

5. Notez les informations relatives aux agents, tels que les agents de catalogue, les agents externes, l'assistant d' watsonx Orchestrate ou les agents externes {{ site.data.keyword. conversationcourte}}.

6. Canaux et configurations personnalisées

Répertoriez tous les canaux et toutes les configurations personnalisées, telles que : agent intégré, Microsoft Teams, Facebook Messenger, etc. Voici les étapes à suivre pour trouver les détails des chaînes :

1. Dans le menu principal, cliquez sur Construire.

2. Allez dans Tous les agents et sélectionnez l'agent concerné.

3. Sur la page de configuration de l'agent, cliquez sur Canaux.

4. Notez les canaux activés.

7. Documenter les changements et les événements récents

Les changements entraînent souvent des problèmes de performance. Examinez et notez les détails suivants :

• Changements récents apportés aux agents (outils, configurations)

• Facteurs environnementaux au moment où le problème est apparu

8. Collecter et exporter des données de traçage

Les traces sont essentielles pour diagnostiquer les problèmes de performance. Les étapes suivantes permettent de collecter les données de traçage :

1. Dans le menu principal, allez dans Analyser et sélectionnez l'agent.

2. Cliquez sur l'état d'un message dans le tableau _Traces_ pour afficher tous les détails de la trace.

3. Cliquez sur Nouvelle fenêtre pour ouvrir la trace dans l'interface utilisateur d' Jaeger.

4. Dans l' Jaeger, sélectionnez Trace Timeline > Trace JSON pour afficher la trace au format JSON.

5. Pour sauvegarder la trace :

   • Cliquez avec le bouton droit de la souris et sélectionnez « Enregistrer sous… »

   • Nommez le fichier et enregistrez-le pour référence.

Pour plus d'informations, consultez la page « Analyses de l'agent de surveillance ».

9. Optionnel : Détails de l'agent d'exportation

L'exportation des détails de l'agent permet à l'assistance IBM de disposer d'un aperçu complet de la configuration et de l'installation de votre agent.

Vous pouvez exporter la configuration de votre agent à l'aide du kit de développement d'agents d' watsonx Orchestrate.

Exécutez la commande suivante pour exporter les détails de l'agent :

orchestrate agents export -n <agent_name> -k native -o <agent_name>.zip