Dépannage du framework d'agent

Cette page vous aide à diagnostiquer et à résoudre les problèmes courants liés au framework d'agent.

Sur cette page:

Installation et configuration

Problèmes courants:échecs d'installation, erreurs d'importation, problèmes d'authentification de l'API.

Vérifiez les points suivants:

  • Versions de Python et de pip
  • Intégrité et chemin d'accès des fichiers .whl
  • Configuration du fichier .env (clés API, détails du projet)
  • Configuration gcloud auth (pour Vertex AI)
  • Installation des dépendances (requirements.txt)
  • Activation de l'environnement virtuel

Problèmes de définition des agents

Problèmes courants:comportement inattendu de l'agent, outils non appelés, erreurs dans agent.py.

Vérifiez les points suivants:

  • Syntaxe du code agent.py (analyse lint)
  • Clarté et exactitude de l'agent instruction
  • Définitions des outils (noms, descriptions, paramètres)
  • Attributs de l'agent (name, model, tools, flow) : fautes de frappe, validité
  • Logique de code dans agent.py : utilisez des instructions d'impression pour le débogage

Problèmes d'exécution

Problèmes courants:échec des commandes CLI (af run, af web, af test), erreurs de l'interface utilisateur Web, problèmes de serveur d'API.

Vérifiez les points suivants:

  • Syntaxe et arguments de la commande CLI (--help)
  • Répertoire de travail (racine du projet de l'agent)
  • Messages d'erreur de terminal (copie des erreurs complètes)
  • Conflits de port (pour l'UI Web/le serveur d'API, essayez d'autres ports)
  • Compatibilité avec les navigateurs (pour l'UI Web)
  • Erreurs de la console du navigateur (pour l'UI Web)

Problèmes d'évaluation

Problèmes courants:échecs des tests, résultats d'évaluation inattendus.

Vérifiez les points suivants:

  • Syntaxe de fichier *.test.json (JSON valide)
  • Contenu du fichier de test (requêtes, expected_tool_use, précision reference)
  • Chemins d'accès aux fichiers dans la commande af test ou le code pytest
  • Critères d'évaluation dans test_config.json (le cas échéant)
  • Exécuter des tests dans l'interface utilisateur Web pour obtenir des commentaires visuels

Messages d'erreur fréquents

  • Problème d'installation
  • Problème de clé API ou d'authentification
  • Attribut model incorrect
  • Conflit de port sur le serveur Web/API

Conseils de dépannage généraux :

  • Simplifiez et isolez: commencez par quelque chose de simple, puis ajoutez progressivement de la complexité.
  • Vérifiez les journaux: terminal, Cloud Logging, console du navigateur.
  • Consultez la documentation: relisez les sections concernées.
  • Recherchez en ligne: Stack Overflow, forums.
  • Fournissez des informations détaillées lorsque vous demandez de l'aide: code, erreurs, étapes, environnement.