langfuse-runnable-config 0.2.0

Утилита для создания RunnableConfig с Langfuse callbacks. Автоматически определяет версию Langfuse и настраивает callbacks с опциональной обрезкой данных.

Langfuse Runnable Config

Утилита для создания RunnableConfig с Langfuse callbacks. Автоматически определяет версию Langfuse и создает правильную конфигурацию. Langfuse не обеспечил обратную совместимость между версиями v2 и v3. API для создания callbacks и конфигураций изменился, и код, написанный для одной версии, не работает с другой. Эта утилита решает проблему, предоставляя единый API, который работает одинаково с обеими версиями.

Установка

pip install langfuse-runnable-config langfuse

Использование

Три способа инициализации:

from langfuse_runnable_config import LangfuseRunnableConfig, LangfuseSettings

# 1. Прямая передача параметров
runnable_config = LangfuseRunnableConfig.create_config(
    url="https://cloud.langfuse.com",
    public_key="pk-...",
    secret_key="sk-...",
)

# 2. Через объект настроек
settings = LangfuseSettings(url="...", public_key="...", secret_key="...")
runnable_config = LangfuseRunnableConfig.create_config(settings=settings)

# 3. Из переменных окружения
runnable_config = LangfuseRunnableConfig.create_config()  # или settings = LangfuseSettings()

Применение:

chain = prompt | llm
chain = chain.with_config(runnable_config)
chain.invoke(input)

Создание callback:

callback = LangfuseRunnableConfig.create_callback()  # все три способа работают
chain.invoke(input, config={"callbacks": [callback]})

С автоматической обрезкой данных:

from langfuse_runnable_config import LangfuseTruncatingRunnableConfig, LangfuseTruncatingSettings

runnable_config = LangfuseTruncatingRunnableConfig.create_config()
# или с параметрами обрезки
runnable_config = LangfuseTruncatingRunnableConfig.create_config(
    url="...", public_key="...", secret_key="...",
    truncate_max_length=5000,
    truncate_max_vector_elements=5,
)

Настройки: LangfuseSettings, LangfuseTruncatingSettings. Переменные окружения читаются автоматически с префиксом LANGFUSE_.