ММООЗЗГГ.ru

Разбор

Архитектура ИИ-агента для тех, кто не программирует

7 мин26 источников

Архитектура ИИ-агента складывается из семи деталей: модель, инструкция, инструменты, знания, память, канал и контроль. Почти у каждой есть открытый вариант: например, модели семейства Qwen 3 вышли 29 апреля 2025 года с открытыми весами на лицензии Apache 2.0.

На странице · 5 разделов

Для всех уровней

Семь деталей агента

Как эти детали работают вместе в цикле «подумать, сделать, проверить», разобрано на странице о том, как работает агент. Здесь каждая деталь по отдельности.

1. Модель: нейросеть, которая понимает задачу и выбирает следующий шаг.

2. Инструкция (системный промпт): постоянное задание, где сказано, кто агент, что ему можно и когда звать человека.

3. Инструменты: подключения, через которые агент действует, например поиск заказа в CRM или отправка письма. Для них есть общий стандарт MCP (Model Context Protocol), который Anthropic открыла 25 ноября 2024 года как единый способ подключать ИИ к данным и сервисам.

4. Знания (RAG): ваши документы, в которых агент ищет ответ перед тем, как ответить.

5. Память: история текущего разговора и сведения о клиенте, которые нужны в следующих разговорах.

6. Канал: где агент работает с людьми, например Telegram, почта, чат на сайте или телефон.

7. Контроль: права доступа, журнал действий и проверка человеком перед рискованным шагом.

Не каждому агенту нужны все семь. Ассистенту для себя хватает модели, инструкции и пары файлов. Агенту, который отвечает клиентам, нужны все детали, и чаще всего экономят на последней, контроле, а потом платят за это ошибками.

Открытые варианты каждой детали

Модель. DeepSeek R1 вышла 20 января 2025 года с открытыми весами (файлами модели, которые можно скачать) на лицензии MIT, Qwen 3 на лицензии Apache 2.0. Запускает их на вашем компьютере или сервере программа Ollama, ее лицензия тоже MIT.

Какие открытые модели подходят бизнесу и сколько им нужно памяти, подробно на странице об открытых моделях.

Инструкция. Это обычный текст, отдельная программа для нее не нужна. Инструменты подключают через MCP или через готовые узлы конструктора.

Знания. Векторные базы (хранилища, где текст ищется по смыслу) Chroma и Qdrant распространяются по лицензии Apache 2.0. Конструктор Flowise на той же лицензии загружает документы, делит их на фрагменты и по кнопке «Upsert» сохраняет в такую базу.

Память. В документации открытой библиотеки LangChain описаны оба вида памяти: краткосрочная хранит историю одного разговора, долгосрочная хранит сведения между разговорами.

Канал. Бота в Telegram создают в @BotFather командой /newbot, после чего BotFather выдает токен (ключ, через который программа управляет ботом). Храните токен как пароль: по документации Telegram, любой, у кого он есть, управляет ботом.

Контроль. Langfuse, открытая платформа для журнала и оценки работы ИИ-приложений, распространяется по лицензии MIT, кроме папок ee, и ставится на свой сервер. Сравнение открытых инструментов для сборки собрано на странице об открытых инструментах.

ИИ-агент1Модель2Инструкция3Инструменты4Знания (RAG)5Память6Канал7Контроль
Семь деталей ИИ-агента

Что стоит денег

Открытая лицензия убирает плату за программы, но не за работу. Деньги уходят на три вещи: железо или облако для модели, время на сборку и проверку, сопровождение после запуска.

Модель на своем железе. Мощная видеокарта для открытой модели средней величины стоит около 749 990 ₽, аренда похожей карты в России около 66 ₽ в час; цены проверены 29 сентября 2026.

Модель в облаке. Вы платите за токены (кусочки слов, которыми модель считает текст), и цена зависит от модели и объема. Посчитать расход на своей нагрузке можно в калькуляторе облачного API.

Облако за рубежом подходит не для всех данных. По 152-ФЗ сбор и хранение данных граждан России ведутся в базах на территории России, а до передачи за рубеж оператор подает уведомление в Роскомнадзор; как мы с этим работаем, на странице о безопасности данных.

Сопровождение тоже стоит денег, даже если все программы открыты. Меняются прайс, правила и сами модели, и кто-то должен обновлять инструкцию, базу знаний и проверять журнал хотя бы раз в неделю.

Больше всего обычно стоит время: проверка агента на реальных вопросах, правки инструкции, разбор ошибок после запуска. Сравнить свой сервер и облако по деньгам поможет калькулятор стоимости локального ИИ.

Где в деталях прячутся риски

Каждая деталь добавляет агенту возможности и вместе с ними риск. Вот что проверить в каждой до запуска.

Инструменты. Локальный MCP-сервер по документации MCP работает с правами пользователя: видит файлы и переменные окружения и может выходить в сеть. Описания инструментов модель читает как инструкции, и в них можно спрятать команды. Ставьте серверы с открытым кодом и известным автором, фиксируйте версию, запускайте в контейнере и давайте каждому свой ключ с узкими правами.

Знания. Если в одной базе документы разных отделов или клиентов, агент может показать одному то, что положено видеть другому. OWASP относит это к рискам векторных баз и советует разграничивать доступ на уровне хранилища. Qdrant, например, рекомендует хранить метку владельца у каждого фрагмента и фильтровать по ней каждый запрос.

Память и журнал. В них оседают персональные данные клиентов. По статье 21 152-ФЗ, когда цель обработки достигнута или согласие отозвано, данные уничтожают не позже чем через 30 дней. Журнал Dify, например, по умолчанию хранит полные разговоры бессрочно, и очистку нужно включать отдельно.

Контроль. Его нельзя отложить на потом. OWASP называет три причины избыточной свободы агента: лишние функции, лишние права и лишняя самостоятельность. Журнал действий ошибку не предотвращает, но ограничивает ущерб и показывает, где она случилась.

Схема типового агента

Возьмем агента поддержки интернет-магазина, который отвечает на вопрос «где мой заказ». Вот как в нем работают семь деталей.

Модель на сервере компании понимает вопрос. Инструкция велит спросить номер заказа и не обещать сроки, которых нет в системе.

Инструмент читает статус заказа в учетной системе. Знания дают правила доставки и возврата, чтобы агент отвечал по ним, а не по памяти модели.

Память хранит историю разговора, чтобы клиент не повторял номер заказа. Канал это чат в Telegram.

Контроль: агент только читает заказы и ничего в них не меняет, каждое его действие пишется в журнал. Возврат денег оформляет человек: OpenAI советует отдавать человеку рискованные действия вроде отмены заказов, крупных возвратов и платежей.

Убрать деталь можно, но агент потеряет часть работы. Без инструмента он не знает статуса заказа, без знаний путает правила, без контроля его нельзя пускать к клиентам.

Вопросы и ответы

Можно ли собрать агента только из открытых деталей?

Да: модель Qwen 3 или DeepSeek R1 в Ollama, база Chroma или Qdrant, конструктор Flowise, журнал Langfuse. Но открытая лицензия не всегда значит «бесплатно для любого дела». n8n, например, по своей лицензии разрешает использовать программу для внутренних задач компании, а перепродавать ее как облачный сервис нельзя.

Нужна ли векторная база, если документов немного?

Не всегда. По данным Anthropic, базу знаний меньше 200 000 токенов, это около 500 страниц, можно целиком положить в запрос к модели. Векторная база нужна, когда документов больше или они часто меняются.

Сколько памяти нужно модели на своем сервере?

Зависит от размера модели. В каталоге Ollama qwen3:8b занимает 5,2 ГБ, qwen3:14b 9,3 ГБ, qwen3:32b 20 ГБ. Открытая gpt-oss-20b по описанию OpenAI работает в 16 ГБ памяти. Начинают с модели поменьше и переходят на большую, если ответы не устраивают.

Какую деталь нельзя пропускать?

Контроль. Компания отвечает за ответы своего бота: в феврале 2024 года трибунал Британской Колумбии признал Air Canada ответственной за неверный ответ чат-бота на сайте и не принял довод, что бот отвечает за себя сам. Права доступа, журнал и проверка человеком перед рискованным шагом нужны агенту с первого дня.

Можно ли поменять одну деталь, не переделывая агента?

Да, если детали разделены. Модель меняют в настройках, когда она подключена через Ollama или общий интерфейс. Инструменты через MCP подключаются к любому приложению, которое поддерживает протокол. Сложнее всего менять базу знаний: при смене модели эмбеддингов документы приходится загружать заново, потому что размерность векторов должна совпадать.

Источники и проверка

Проверено редакцией 16 октября 2026.

  1. GitHub, 16 октября 2026 (github.com)
  2. Alpine Linux packages, 2026 (pkgs.alpinelinux.org)
  3. Anthropic, 25 ноября 2024 (anthropic.com)
  4. Simon Willison, 20 января 2025 (simonwillison.net)
  5. Simon Willison, 29 апреля 2025 (simonwillison.net)
  6. Brace Law Firm, 9 июля 2023 (brace-lf.com)
  7. GitHub, chroma-core/chroma, 2026 (github.com)
  8. GitHub, qdrant/qdrant, 2026 (github.com)
  9. LangChain Docs, 2026 (docs.langchain.com)
  10. GitHub, langfuse/langfuse, 2026 (github.com)
  11. OpenAI, A practical guide to building agents, апрель 2025 (cdn.openai.com)
  12. Документация Flowise: Document Stores, проверено 16 октября 2026 (docs.flowiseai.com)
  13. Документация Telegram: Bot Features: BotFather, проверено 16 октября 2026 (core.telegram.org)
  14. Документация Ollama: README, проверено 16 октября 2026 (github.com)
  15. Документация MCP: Local Server Security, 2026 (modelcontextprotocol.io)
  16. OWASP, LLM08:2025 Vector and Embedding Weaknesses (genai.owasp.org)
  17. Документация Qdrant: Multitenancy, 2026 (qdrant.tech)
  18. КонсультантПлюс, 152-ФЗ, статья 21 (consultant.ru)
  19. Документация Dify: Logs, 2026 (docs.dify.ai)
  20. OWASP, LLM06:2025 Excessive Agency (genai.owasp.org)
  21. Документация n8n: Sustainable Use License, 2026 (docs.n8n.io)
  22. Anthropic, Contextual Retrieval, 19 сентября 2024 (anthropic.com)
  23. Каталог Ollama: qwen3, 2026 (ollama.com)
  24. GitHub, openai/gpt-oss, 2026 (github.com)
  25. Law360 Canada, Moffatt v. Air Canada, 16 февраля 2024 (law360.ca)
  26. Документация Flowise: Document Stores, 2026 (docs.flowiseai.com)

Нашли ошибку? Напишите нам

Публикации

Как создать чат-бот в Максе: инструкция для компании

Чтобы создать чат-бот в Максе, компании нужно пройти четыре шага на платформе MAX для партнеров: проверить профиль организации через Госуслуги, заполнить карточку бота, дождаться модерации до 48 часов по рабочим дням и собрать сценарий в конструкторе или своим кодом. Ниже каждый шаг по документации MAX, проверенной 16 октября 2026 года, а также как связать бота с сайтом, CRM и командой и на чем бо

ИнструкцияИТСредний11 мин
Написать в Telegram