𝗦𝗲𝘁𝘁𝗶𝗻𝗴 𝗨𝗽 𝗬𝗼𝘂𝗿 𝗘𝗻𝘃𝗶𝗿𝗼𝗻𝗺𝗲𝗻𝘁: 𝗟𝗮𝗻𝗴𝗖𝗵𝗮𝗶𝗻, 𝗟𝗮𝗻𝗴𝗚𝗿𝗮𝗽𝗵 & 𝗖𝗵𝗮𝘁 𝗟𝗟𝗠𝘀
ผมเคยเสียเวลาถึงสองชั่วโมงในการดีบั๊ก (debug) โปรเจกต์ LangChain ปัญหาคือตัวแปรสภาพแวดล้อม (environment variable) หายไปหนึ่งตัว API key ของผมอยู่ในไฟล์ .env แต่ผมลืมโหลดมันขึ้นมา
ผมจึงเขียนคู่มือนี้ขึ้นมา เพื่อที่คุณจะได้ไม่ต้องเสียเวลาเหมือนที่ผมเคยเจอ
คุณจะได้เรียนรู้วิธีการตั้งค่าสภาพแวดล้อม Python ให้พร้อมใช้งานสำหรับ LangChain, LangGraph และ Chat LLM
แพ็กเกจที่จำเป็น:
- langchain: โครงสร้างหลัก (Core framework) สำหรับ chains และ agents
- langchain-openai: การเชื่อมต่อกับโมเดล OpenAI
- langchain-core: พื้นฐานที่ใช้ร่วมกัน (Shared primitives) เช่น messages
- langgraph: เวิร์กโฟลว์ของ agent แบบใช้กราฟ (Graph-based)
- python-dotenv: โหลดตัวแปรจากไฟล์ .env
- openai: OpenAI Python SDK อย่างเป็นทางการ
ขั้นตอนที่ 1: ตรวจสอบเวอร์ชัน Python LangChain ต้องการ Python เวอร์ชัน 3.9 ขึ้นไป รันคำสั่งนี้ใน terminal ของคุณ: python --version
ขั้นตอนที่ 2: สร้าง Virtual Environment ควรใช้ virtual environment เสมอเพื่อหลีกเลี่ยงปัญหาความขัดแย้งของ dependency
mkdir langchain-agents-series cd langchain-agents-series python -m venv venv
วิธีเปิดใช้งานบน Mac/Linux: source venv/bin/activate
วิธีเปิดใช้งานบน Windows: venv\Scripts\activate
ขั้นตอนที่ 3: ติดตั้ง Dependencies เมื่อเปิดใช้งาน environment แล้ว ให้รันคำสั่ง: pip install langchain langchain-openai langchain-core langgraph python-dotenv openai
ขั้นตอนที่ 4: รักษาความปลอดภัยของ API Keys อย่าเขียน API key ลงในโค้ดโดยตรง (hardcode) เพราะมันอันตรายมาก หากคุณ push ขึ้น GitHub บอทต่างๆ จะขโมยมันไปทันที
- สร้างไฟล์ .env: touch .env
- เพิ่ม key ของคุณ: OPENAI_API_KEY=your-key-here
- สร้างไฟล์ .gitignore เพื่อซ่อนโฟลเดอร์ .env และ venv
ขั้นตอนที่ 5: Agent ตัวแรกของคุณ
สร้างไฟล์ชื่อ hello_agent.py และใช้ฟังก์ชัน load_dotenv() เพื่ออ่าน key ของคุณ
ควรใช้ temperature=0 เมื่อสร้าง agent เพื่อให้ผลลัพธ์ของโมเดลสามารถคาดเดาได้และมีความสม่ำเสมอ
ข้อผิดพลาดที่พบบ่อยที่ควรระวัง:
- OPENAI_API_KEY not found: ตรวจสอบว่าไฟล์ .env อยู่ในโฟลเดอร์ที่ถูกต้องและคุณได้เรียกใช้
load_dotenv()แล้วหรือยัง - ModuleNotFoundError: virtual environment ของคุณยังไม่ได้ถูกเปิดใช้งาน
- AuthenticationError: API key ของคุณไม่ถูกต้อง
- RateLimitError: คุณใช้งานเกินขีดจำกัด หรือต้องเติมเครดิตในบัญชี OpenAI ของคุณ
แนวทางปฏิบัติที่ดีที่สุด:
- ใช้ virtual environment เสมอ
- ระบุเวอร์ชันที่แน่นอนด้วย
pip freeze > requirements.txt - ใช้
temperature=0เพื่อความเสถียร - บันทึก (Log) การใช้งาน token เพื่อติดตามค่าใช้จ่าย
Source: https://dev.to/ikram_khan/setting-up-your-environment-langchain-langgraph-chat-llms-43cf
ชุมชนการเรียนรู้ (เลือกเข้าร่วมได้): https://t.me/GyaanSetuAi