Налаштування середовища: LangChain, LangGraph та Chat LLMs
Одного разу я витратив дві години на налагодження проєкту LangChain. Проблема полягала в одній відсутній змінній середовища. Мій API-ключ був у файлі .env, але я забув його завантажити.
Я написав цей посібник, щоб ви не витрачали час так само, як я.
Ви навчитеся налаштовувати робоче середовище Python з LangChain, LangGraph та Chat LLM.
Required Packages:
- langchain: Основний фреймворк для ланцюжків (chains) та агентів
- langchain-openai: Інтеграція з моделями OpenAI
- langchain-core: Спільні примітиви, такі як повідомлення (messages)
- langgraph: Робочі процеси агентів на основі графів
- python-dotenv: Завантажує змінні з файлу .env
- openai: Офіційний OpenAI Python SDK
Step 1: Check Python Version
LangChain потребує Python 3.9 або вище. Виконайте це у вашому терміналі:
python --version
Step 2: Create a Virtual Environment Завжди використовуйте віртуальне середовище, щоб уникнути конфліктів залежностей.
mkdir langchain-agents-series
cd langchain-agents-series
python -m venv venv
Щоб активувати на Mac/Linux:
source venv/bin/activate
Щоб активувати на Windows:
venv\Scripts\activate
Step 3: Install Dependencies
Коли середовище активовано, виконайте:
pip install langchain langchain-openai langchain-core langgraph python-dotenv openai
Step 4: Secure Your API Keys Ніколи не прописуйте API-ключ безпосередньо у коді. Це небезпечно. Якщо ви завантажите його на GitHub, боти його вкрадуть.
- Створіть файл .env:
touch .env - Додайте свій ключ:
OPENAI_API_KEY=your-key-here - Створіть файл .gitignore, щоб приховати ваші папки .env та venv.
Step 5: Your First Agent
Створіть файл з назвою hello_agent.py. Використовуйте функцію load_dotenv(), щоб зчитати ваші ключі.
Використовуйте temperature=0 під час створення агентів. Це робить відповіді моделі передбачуваними та стабільними.
Common Errors to Watch For:
- OPENAI_API_KEY not found: Перевірте, чи файл .env знаходиться у правильній папці та чи викликали ви
load_dotenv(). - ModuleNotFoundError: Ваше віртуальне середовище не активоване.
- AuthenticationError: Ваш API-ключ неправильний.
- RateLimitError: Ви досягли ліміту або вам потрібно поповнити баланс вашого облікового запису OpenAI.
Best Practices:
- Завжди використовуйте віртуальне середовище.
- Фіксуйте версії за допомогою
pip freeze > requirements.txt. - Використовуйте
temperature=0для стабільності. - Логуйте використання токенів, щоб відстежувати витрати.
Source: https://dev.to/ikram_khan/setting-up-your-environment-langchain-langgraph-chat-llms-43cf
Додаткова спільнота для навчання: https://t.me/GyaanSetuAi