На главную

Разработчикам

Создавайте агентов за минуты

Cognitum Python SDK берёт на себя инфраструктурную сложность. Сосредоточьтесь на бизнес-логике — платформа обеспечит регистрацию, очереди, логирование и доступ к LLM

Быстрый старт

Три шага от установки до работающего агента в продакшене

01
Установите платформу Cognitum
docker compose up -d
02
Импортируйте SDK
pip install -e ./sdk
03
Импортируйте Agent
from cognitum import Agent
Готово! Теперь вы можете создавать агентов

Пример Job-агента

my_agent.py
from cognitum import Agent, job_handler

agent = Agent(
    name="document-processor",
    description="Анализ документов",
    model="gpt-4"
)

@job_handler("process_doc")
async def process(ctx, payload):
    # Ваша бизнес-логика здесь
    result = await ctx.llm.chat([
        { "role": "user",
          "content": payload.text }
    ])
    return result

agent.run()

Пример Chat-агента

chat_bot.py
from cognitum import Agent, chat_handler

agent = Agent(
    name="support-bot",
    description="Бот поддержки",
    model="gpt-4",
    system_prompt="Ты — помощник службы поддержки"
)

@chat_handler()
async def on_message(ctx, message):
    # ctx.history — автоматическая история
    response = await ctx.llm.chat(
        ctx.history + [{ "role": "user",
            "content": message.text }]
    )
    return response

agent.run()

Возможности SDK

Всё, что нужно для создания production-ready агентов

Авто-регистрация

Агенты автоматически регистрируют возможности в Control Plane при запуске. Ручная настройка не требуется

Декларативное описание настроек

Описывайте параметры, зависимости и поведение агента декларативно. Платформа применяет конфигурацию автоматически при развёртывании

Обёртки для LLM

Вызывайте любую зарегистрированную LLM через единый API. Платформа обеспечивает маршрутизацию, учёт токенов и rate limiting

Структурированное логирование

Логи агентов автоматически пересылаются в Grafana Loki. Добавляйте кастомные поля для удобного поиска и анализа

Контекст диалога

Встроенное управление историей разговора. Thread-safe доступ к состоянию многоходового диалога с автоматическим TTL

Три модели выполнения

Job-обработчики для асинхронных задач, Chat-обработчики для диалогов или комбинированный режим для гибридных агентов

Как это работает

Жизненный цикл агента на платформе Cognitum

1

Инициализация

SDK подключается к NATS JetStream и регистрирует агента в Control Plane с описанием возможностей

2

Подписка

Агент подписывается на назначенные очереди задач или регистрирует chat-модель для интерактивного использования

3

Обработка

Входящие задачи и сообщения обрабатываются вашей бизнес-логикой с доступом к LLM через ctx.llm

4

Мониторинг

Метрики, логи и результаты автоматически доступны в веб-интерфейсе и через Grafana Loki