Разработчикам
Создавайте агентов за минуты
Cognitum Python SDK берёт на себя инфраструктурную сложность. Сосредоточьтесь на бизнес-логике — платформа обеспечит регистрацию, очереди, логирование и доступ к LLM
Быстрый старт
Три шага от установки до работающего агента в продакшене
docker compose up -dpip install -e ./sdkfrom cognitum import AgentПример Job-агента
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-агента
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
Инициализация
SDK подключается к NATS JetStream и регистрирует агента в Control Plane с описанием возможностей
Подписка
Агент подписывается на назначенные очереди задач или регистрирует chat-модель для интерактивного использования
Обработка
Входящие задачи и сообщения обрабатываются вашей бизнес-логикой с доступом к LLM через ctx.llm
Мониторинг
Метрики, логи и результаты автоматически доступны в веб-интерфейсе и через Grafana Loki