اتصال LangChain به پیکو هوش

LangChain برای ساخت زنجیره‌های پرامپت، بازیابی اطلاعات و ایجنت رایج‌ترین فریمورک است. کلاس ChatOpenAI در بسته‌ی langchain-openai پارامتر base_url دارد، بنابراین هر مدل چت پیکو هوش مثل یک مدل OpenAI در زنجیره‌های شما قرار می‌گیرد.

نتیجه این است که می‌توانید بدون تغییر ساختار زنجیره، مدل را از gpt-6-sol به claude-sonnet-5-5 یا مدل اقتصادی دیگری عوض کنید و فقط هزینه و کیفیت را مقایسه کنید.

پیش‌نیازها

• یک حساب پیکو هوش و یک کلید API از داشبورد (کلید فقط یک‌بار کامل نمایش داده می‌شود).
• شناسه‌ی دقیق مدل از کاتالوگ؛ در مثال‌ها از gpt-6-sol و claude-sonnet-5-5 استفاده شده است.
• کمی موجودی در کیف پول تومانی یا اعتبار؛ تعرفه را در صفحه‌ی قیمت‌ها ببینید.

راه‌اندازی گام‌به‌گام

1. ۱نصب بسته‌ها

   بسته‌ی هسته و ادغام OpenAI را نصب کنید.

   کپی

   pip install -U langchain langchain-openai

2. ۲ساخت مدل چت (پایتون)

   پارامترهای model، api_key و base_url را بدهید.

   کپی

   import os
   from langchain_openai import ChatOpenAI
   from langchain_core.prompts import ChatPromptTemplate
   
   llm = ChatOpenAI(
       model="gpt-6-sol",
       api_key=os.environ["PICOAI_API_KEY"],
       base_url="https://api.picoai.ir/v1",
       temperature=0.3,
   )
   
   prompt = ChatPromptTemplate.from_messages([
       ("system", "تو یک دستیار فارسی‌زبان هستی."),
       ("human", "{question}"),
   ])
   chain = prompt | llm
   print(chain.invoke({"question": "تفاوت RAG و fine-tuning چیست؟"}).content)

3. ۳نسخه‌ی جاوااسکریپت

   در LangChain.js آدرس پایه داخل configuration داده می‌شود.

   کپی

   import { ChatOpenAI } from "@langchain/openai";
   
   const llm = new ChatOpenAI({
     model: "gpt-6-sol",
     apiKey: process.env.PICOAI_API_KEY,
     configuration: { baseURL: "https://api.picoai.ir/v1" },
   });
   const res = await llm.invoke("سلام!");
   console.log(res.content);

4. ۴تغییر مدل در یک خط

   چون همه‌ی مدل‌ها پشت یک آدرس هستند، فقط پارامتر model را عوض کنید.

   کپی

   for m in ["gpt-6-sol", "claude-sonnet-5-5", "deepseek-v4-pro"]:
       out = llm.bind(model=m).invoke("یک جمله درباره‌ی ایران بنویس.")
       print(m, "->", out.content)

تست سریع اتصال

پیش از نوشتن منطق برنامه، یک بار فهرست مدل‌ها را بگیرید. اگر پاسخ ۲۰۰ و فهرستی از شناسه‌ها برگشت، کلید، شبکه و آدرس درست است و هر مشکل بعدی مربوط به تنظیمات LangChain خواهد بود.

curl https://api.picoai.ir/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

نکته‌های کاربردی برای LangChain

• Embeddings در حال حاضر در پیکو هوش ارائه نمی‌شود؛ برای RAG از یک مدل امبدینگ محلی یا سرویس جداگانه استفاده کنید و فقط تولید پاسخ را به پیکو هوش بسپارید.
• برای خروجی ساخت‌یافته از with_structured_output استفاده کنید، اما ابتدا روی مدل انتخابی تست کنید چون پشتیبانی ابزار در همه‌ی مدل‌ها یکسان نیست.
• از LangSmith یا ثبت لاگ خودتان برای مقایسه‌ی هزینه‌ی توکن میان مدل‌ها استفاده کنید.

عیب‌یابی

هزینه و صورتحساب

هر درخواست قبل از اجرا مقداری از موجودی را رزرو می‌کند و پس از پاسخ موفق بر پایه‌ی توکن‌های واقعی تسویه می‌شود؛ مابه‌التفاوت برمی‌گردد و درخواست ناموفق چیزی کم نمی‌کند. جدول قیمت هر مدل در صفحه‌ی قیمت‌ها منتشر شده و مصرف هر درخواست در داشبورد قابل مشاهده است. اگر قبلاً از سرویس دیگری استفاده می‌کردید، راهنمای مهاجرت و صفحه‌ی مقایسه را ببینید.