Risoluzione dei problemi del framework dell'agente

Questa pagina ti aiuta a diagnosticare e risolvere i problemi comuni quando utilizzi Agent Framework.

In questa pagina:

Installazione e configurazione

Problemi comuni: errori di installazione, errori di importazione, problemi di autenticazione API.

Controlla:

  • Versioni di Python e pip
  • Integrità e percorso del file .whl
  • Configurazione del file .env (chiavi API, dettagli del progetto)
  • Configurazione di gcloud auth (per Vertex AI)
  • Installazione delle dipendenze (requirements.txt)
  • Attivazione dell'ambiente virtuale

Problemi di definizione dell'agente

Problemi comuni: l'agente non si comporta come previsto, gli strumenti non vengono chiamati, errori in agent.py.

Controlla:

  • Sintassi del codice agent.py (linting)
  • Chiarezza e correttezza instruction dell'agente
  • Definizioni degli strumenti (nomi, descrizioni, parametri)
  • Attributi agente (name, model, tools, flow): errori ortografici, validità
  • Logica del codice all'interno di agent.py: utilizza le istruzioni di stampa per il debug

Problemi di esecuzione

Problemi comuni: errori dei comandi a riga di comando (af run, af web, af test), errori dell'interfaccia utente web, problemi del server API.

Controlla:

  • Sintassi e argomenti dei comandi dell'interfaccia a riga di comando (--help)
  • Directory di lavoro (directory principale del progetto dell'agente)
  • Messaggi di errore del terminale (copia gli errori completi)
  • Conflitti di porte (per l'interfaccia utente web/il server API: prova porte diverse)
  • Compatibilità del browser (per l'interfaccia utente web)
  • Errori della console del browser (per l'interfaccia utente web)

Problemi di valutazione

Problemi comuni: errori di test, risultati di valutazione inaspettati.

Controlla:

  • Sintassi del file *.test.json (JSON valido)
  • Verifica i contenuti del file (query, expected_tool_use, accuratezza reference)
  • Percorsi file nel comando af test o nel codice pytest
  • Criteri di valutazione in test_config.json (se utilizzati)
  • Esegui test nell'interfaccia utente web per il feedback visivo

Messaggi di errore comuni

  • Problema di installazione
  • Problema con la chiave API o l'autenticazione
  • Attributo model errato
  • Conflitto di porte sul server web/API

Suggerimenti generali per la risoluzione dei problemi:

  • Semplifica e isola: inizia con qualcosa di semplice e aggiungi gradualmente la complessità.
  • Controlla i log: terminale, Cloud Logging, console del browser.
  • Fai riferimento alla documentazione: rileggi le sezioni pertinenti.
  • Ricerca online: Stack Overflow, forum.
  • Fornisci informazioni dettagliate quando chiedi aiuto: codice, errori, passaggi, ambiente.