Что это такое?
Большинство руководств по агентам ограничиваются одним вызовом API. Этот репозиторий начинается с простого цикла и доводит вас до создания полноценного шлюзового решения.
Основные концепции:
- Agent Loop: Основы работы агентов через цикл
whileи обработку завершения (finish_reason). - Tool Use: Возможность вызова инструментов моделью через таблицу маршрутизации.
- Sessions & Context: Сохранение контекста разговора и обработка его переполнения.
- Channels: Реализация каналов связи с внешними сервисами (Telegram, Feishu).
- Gateway & Routing: Построение многоуровневой системы привязки и изоляции сессий.
- Intelligence: Добавление памяти, навыков и сборки подсказок.
- Heartbeat & Cron: Создание активного агента с запланированными задачами.
- Delivery: Надежная доставка сообщений.
Архитектура проекта
Проект состоит из десяти секций, каждая из которых представляет собой отдельный исполняемый файл на языке Python (~7 тысяч строк кода). Каждая новая секция добавляет одну новую концепцию, сохраняя при этом весь предыдущий код неизменным.
Быстрый старт
Для начала вам потребуется установить необходимые зависимости и настроить переменные окружения. После этого вы сможете запустить каждую секцию индивидуально или целиком проект.
Обучение шаг за шагом
Каждая секция содержит подробное описание того, что именно она делает и как работает. Это позволяет постепенно осваивать материал от простых концепций к более сложным.
Структура репозитория
Репозиторий разделен на несколько папок, каждая из которых соответствует определенной секции. Внутри каждой папки находятся файлы с исходным кодом и документацией.
Предварительные требования
Перед началом работы убедитесь, что у вас установлены все необходимые инструменты и библиотеки. Также рекомендуется ознакомиться с основами языка программирования Python.