LangChain + Gonka AI — AI-додатки за копійки

Мінімальний приклад — підключення LangChain до Gonka:

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    base_url="https://gate.joingonka.ai/v1",
    api_key="jg-ваш-ключ",
    model="MiniMaxAI/MiniMax-M2.7",
)

response = llm.invoke("Поясни що таке RAG")
print(response.content)

Це все. Три рядки — і ваш LangChain-проєкт працює через децентралізовану мережу Gonka за копійки.

Встановлення залежностей:

pip install langchain langchain-openai

Рекомендація: явно вказуйте max_tokens=8192 — це стеля виводу через JoinGonka Gateway для всіх моделей мережі. Контекстне вікно моделей мережі — 200K токенів — враховуйте це при налаштуванні chunk_size в RAG-пайплайнах.

RAG (Retrieval-Augmented Generation) — найпопулярніший патерн AI-додатків. Завантажуєте документи, розбиваєте на чанки, створюєте ембеддінги, шукаєте релевантні фрагменти та генеруєте відповідь з контекстом.

from langchain_openai import ChatOpenAI
from langchain.text_splitter import RecursiveCharacterTextSplitter
from langchain.chains import RetrievalQA
from langchain_community.vectorstores import FAISS
from langchain_community.embeddings import HuggingFaceEmbeddings
from langchain_community.document_loaders import TextLoader

# 1. LLM через Gonka
llm = ChatOpenAI(
    base_url="https://gate.joingonka.ai/v1",
    api_key="jg-ваш-ключ",
    model="MiniMaxAI/MiniMax-M2.7",
    streaming=True,
)

# 2. Завантаження та індексація документів
loader = TextLoader("docs/my_document.txt")
docs = loader.load()
splitter = RecursiveCharacterTextSplitter(chunk_size=1000)
chunks = splitter.split_documents(docs)

# 3. Векторне сховище (локальне, безкоштовне)
embeddings = HuggingFaceEmbeddings()
vectorstore = FAISS.from_documents(chunks, embeddings)

# 4. RAG-ланцюжок
qa = RetrievalQA.from_chain_type(
    llm=llm,
    retriever=vectorstore.as_retriever(),
)

# 5. Запит
result = qa.invoke("О чому цей документ?")
print(result["result"])

Вартість: один запит RAG-пайплайну (retrieval + generation) використовує ~2-5K токенів LLM. Через Gonka це $0.00001-0.000024. Через OpenAI — $0.005-0.05. Різниця — 2,000x.

Для production-систем, що обробляють тисячі запитів на день, економія складає десятки тисяч доларів на місяць.

LangChain дозволяє створювати агентів з інструментами (tools). Kimi K2.6 підтримує нативний tool calling — агенти працюють надійно, без парсингу текстових відповідей.

from langchain_openai import ChatOpenAI
from langchain.agents import create_openai_tools_agent, AgentExecutor
from langchain.tools import tool
from langchain.prompts import ChatPromptTemplate

llm = ChatOpenAI(
    base_url="https://gate.joingonka.ai/v1",
    api_key="jg-ваш-ключ",
    model="MiniMaxAI/MiniMax-M2.7",
)

@tool
def calculator(expression: str) -> str:
    """Обчислює математичний вираз."""
    return str(eval(expression))

@tool
def search_web(query: str) -> str:
    """Шукає інформацію в інтернеті."""
    return f"Результати пошуку для: {query}"

prompt = ChatPromptTemplate.from_messages([
    ("system", "Ти корисний асистент."),
    ("human", "{input}"),
    ("placeholder", "{agent_scratchpad}"),
])

agent = create_openai_tools_agent(llm, [calculator, search_web], prompt)
executor = AgentExecutor(agent=agent, tools=[calculator, search_web])

result = executor.invoke({"input": "Скільки буде 2**10 * 3.14?"})
print(result["output"])

Агент викликає calculator, отримує результат і формує відповідь. Весь цикл коштує ~$0.00005 через Gonka. Через OpenAI — $0.01-0.05. Для систем з тисячами користувачів це різниця у десятки тисяч доларів.