𝗦𝗲𝘁𝘁𝗶𝗻𝗴 𝗨𝗽 𝗬𝗼𝘂𝗿 𝗘𝗻𝘃𝗶𝗿𝗼𝗻𝗺𝗲𝗻𝘁: 𝗟𝗮𝗻𝗴𝗖𝗵𝗮𝗶𝗻, 𝗟𝗮𝗻𝗴𝗚𝗿𝗮𝗽𝗵 & 𝗖𝗵𝗮𝘁 𝗟𝗟𝗠𝘀
Una volta ho passato due ore a fare il debugging di un progetto LangChain. Il problema era una variabile d'ambiente mancante. La mia chiave API era in un file .env, ma avevo dimenticato di caricarla.
Ho scritto questa guida affinché non sprechiate tempo come ho fatto io.
Imparerai a configurare un ambiente Python funzionante con LangChain, LangGraph e un Chat LLM.
Pacchetti richiesti:
- langchain: Framework principale per catene e agenti
- langchain-openai: Integrazione con i modelli OpenAI
- langchain-core: Primitivi condivisi come i messaggi
- langgraph: Workflow di agenti basati su grafi
- python-dotenv: Carica le variabili da un file .env
- openai: SDK Python ufficiale di OpenAI
Passaggio 1: Controlla la versione di Python LangChain richiede Python 3.9 o versioni superiori. Esegui questo comando nel tuo terminale: python --version
Passaggio 2: Crea un ambiente virtuale Usa sempre un ambiente virtuale per evitare conflitti di dipendenze.
mkdir langchain-agents-series cd langchain-agents-series python -m venv venv
Per attivare su Mac/Linux: source venv/bin/activate
Per attivare su Windows: venv\Scripts\activate
Passaggio 3: Installa le dipendenze Con l'ambiente attivo, esegui: pip install langchain langchain-openai langchain-core langgraph python-dotenv openai
Passaggio 4: Proteggi le tue chiavi API Non inserire mai la tua chiave API direttamente nel codice. È pericoloso. Se la carichi su GitHub, i bot la ruberanno.
- Crea un file .env: touch .env
- Aggiungi la tua chiave: OPENAI_API_KEY=your-key-here
- Crea un file .gitignore per nascondere le cartelle .env e venv.
Passaggio 5: Il tuo primo agente Crea un file chiamato hello_agent.py. Usa la funzione load_dotenv() per leggere le tue chiavi.
Usa temperature=0 quando costruisci gli agenti. Questo rende l'output del modello prevedibile e coerente.
Errori comuni a cui prestare attenzione:
- OPENAI_API_KEY not found: Controlla se il tuo file .
Community di apprendimento opzionale: https://t.me/GyaanSetuAi