Fehlerbehebung beim Agent Framework

Auf dieser Seite erfahren Sie, wie Sie häufige Probleme bei der Arbeit mit dem Agent Framework diagnostizieren und beheben.

Themen auf dieser Seite

Installation und Einrichtung

Häufige Probleme:Installationsfehler, Importfehler, Probleme mit der API-Authentifizierung.

Prüfen:

  • Python- und Pip-Versionen
  • .whl Dateiintegrität und ‑pfad
  • Konfiguration der .env-Datei (API-Schlüssel, Projektdetails)
  • gcloud auth-Einrichtung (für Vertex AI)
  • Installation von Abhängigkeiten (requirements.txt)
  • Aktivierung der virtuellen Umgebung

Probleme mit der Agentendefinition

Häufige Probleme:Der Kundenservicemitarbeiter verhält sich nicht wie erwartet, Tools werden nicht aufgerufen, Fehler in agent.py.

Prüfen:

  • agent.py-Codesyntax (Linting)
  • Klarheit und Richtigkeit der instruction des Kundenservicemitarbeiters
  • Tooldefinitionen (Namen, Beschreibungen, Parameter)
  • Kundenservicemitarbeiterattribute (name, model, tools, flow) – Tippfehler, Gültigkeit
  • Codelogik in agent.py – Druckanweisungen für die Fehlerbehebung verwenden

Probleme bei der Ausführung

Häufige Probleme:Fehlgeschlagene Befehle in der Befehlszeile (af run, af web, af test), Fehler in der Web-Benutzeroberfläche, API-Serverprobleme.

Prüfen:

  • Syntax und Argumente von Befehlen der Befehlszeile (--help)
  • Arbeitsverzeichnis (Stammverzeichnis des Agentenprojekts)
  • Terminalfehlermeldungen (vollständige Fehler kopieren)
  • Portkonflikte (für Web-UI/API-Server – versuchen Sie es mit anderen Ports)
  • Browserkompatibilität (für die Web-Benutzeroberfläche)
  • Browserkonsolenerre (für die Web-Benutzeroberfläche)

Probleme bei der Bewertung

Häufige Probleme:Testfehler, unerwartete Bewertungsergebnisse.

Prüfen:

  • *.test.json-Dateisyntax (gültiges JSON)
  • Dateiinhalte testen (Abfragen, Genauigkeit von expected_tool_use und reference)
  • Dateipfade im af test-Befehl oder pytest-Code
  • Bewertungskriterien in test_config.json (falls verwendet)
  • Tests in der Web-UI ausführen, um visuelles Feedback zu erhalten

Häufige Fehlermeldungen

  • Installationsproblem
  • API-Schlüssel- oder Authentifizierungsproblem
  • Falsches model-Attribut
  • Portkonflikt auf dem Web-/API-Server

Allgemeine Tipps zur Fehlerbehebung:

  • Vereinfachen und isolieren: Beginnen Sie einfach und fügen Sie nach und nach Komplexität hinzu.
  • Protokolle prüfen: Terminal, Cloud Logging, Browserkonsole
  • Lesen Sie die Dokumentation noch einmal durch.
  • Online suchen: Stack Overflow, Foren.
  • Geben Sie bei der Anfrage nach Hilfe detaillierte Informationen an: Code, Fehler, Schritte, Umgebung.