# Как cоздать cвоего ИИ-агента с базой знаний: за 3 шага с Timeweb Cloud
![[обложка.jpg]]
Реклама. ООО «ТАЙМВЭБ.КЛАУД». ИНН: 7810945525. Erid: 2W5zFJYfkGG
Ссылка на ИИ агента - [AI-агенты](https://tweb.link/krcf4)
>[!quote] Специальное предложение:
>- Промокод ELTON для удваивания платежа
>- Для активации удвоенного платежа вводите промокод, а после пополняйте кабинет
---
## Оглавление
1. [[15. Создаем ИИ агентов без программирования#^528857|Введение: От Ограниченного ИИ к Персональному Агенту]]
2. [[15. Создаем ИИ агентов без программирования#^5966d7|Технический Базис: RAG, Векторы и Токены]]
- [[15. Создаем ИИ агентов без программирования#^2db2fd|RAG (Retrieval Augmented Generation)]]
- [[15. Создаем ИИ агентов без программирования#^e35b59|Векторы и Семантический Поиск]]
- [[15. Создаем ИИ агентов без программирования#^4d80b0|Токены: Топливо для ИИ]]
3. [[15. Создаем ИИ агентов без программирования#^e6ba56|Timeweb Cloud: Платформа для Вашего Агента]]
- [[15. Создаем ИИ агентов без программирования#^2006c9|Шаг 1: Создание ИИ-Агента (Выбор Модели и Тарифа)]]
- [[15. Создаем ИИ агентов без программирования#^ee15a3|Шаг 2: Настройка и Интеграция Агента]]
- [[15. Создаем ИИ агентов без программирования#^5a6aa9|Настройка Системного Промпта (Плейграунд)]]
- [[15. Создаем ИИ агентов без программирования#^5454c8|Интеграция Агента]]
- [[15. Создаем ИИ агентов без программирования#^8bbf9e|Шаг 3: Создание и Подключение Базы Знаний (RAG-Сервис)]]
4. [[15. Создаем ИИ агентов без программирования#^0dd73d|Расширенный Кейс: Корпоративный ИИ с Open WebUI и Docker]]
5. [[15. Создаем ИИ агентов без программирования#^e2f7a7|Примеры Применения: От Личной Рутины до Бизнес-Автоматизации]]
---
## Введение: От Ограниченного ИИ к Персональному Агенту
![[TW1.jpg]]
>[!quote] Ежедневно мы взаимодействуем с искусственным интеллектом, который помогает нам решать задачи и находить ответы. Однако его возможности часто ограничены, а ответы могут страдать «галлюцинациями» или быть слишком общими.
Причина проста: у стандартных моделей нет контекста о нас — наших проектах, личных заметках или специфических инструкциях.
>[!success] Предоставив ИИ всю необходимую информацию, мы не просто делаем его умнее. Мы создаем персонального ИИ-Агента, способного автоматизировать рутину, от личных задач до сложных бизнес-процессов. Такой агент может:
- Ускорить ваше обучение и поиск информации.
- Взять на себя общение с клиентами.
- Управлять вашими проектами, экономя время и ресурсы.
В этом подробном руководстве мы пошагово разберем, как создать такого агента на платформе Timeweb Cloud без необходимости писать код, а также как интегрировать его в сложные рабочие процессы с помощью n8n и Docker/Open WebUI.
---
## Технический Базис: RAG, Векторы и Токены
^5966d7
Прежде чем приступить к созданию агента, важно понять три ключевых концепции, которые лежат в основе его работы: RAG, векторы и токены.
![[TW2.jpg]]
### 1. RAG (Retrieval Augmented Generation)
^2db2fd
>[!quote] RAG (Retrieval Augmented Generation) переводится как «Генерация, Дополненная Поиском». Это технология, которая решает главную проблему больших языковых моделей (LLM) — галлюцинации.
Вместо того чтобы выдумывать информацию, RAG позволяет модели сначала найти релевантные данные в вашей личной базе знаний, а затем использовать их для генерации точного ответа.
![[TW3.jpg]]
Пример: Если обычный ИИ может порекомендовать вам книги несуществующих авторов, то RAG, опираясь на ваши документы, либо даст точный ответ, либо честно скажет: «У меня недостаточно информации».
---
### 2. Векторы и Семантический Поиск
^e35b59
Основное отличие RAG от традиционного поиска (например, Google) заключается в том, что он ищет не по ключевым словам, а по смыслу. Для этого используются векторы.
![[TW4.jpg]]
Векторы можно представить как точки на огромной карте смысла. Чем ближе две точки на этой карте, тем ближе их смысловое значение. Когда вы загружаете файлы в базу знаний, RAG-сервис превращает их в миллионы таких векторов и сохраняет их в специальной векторной базе данных. Этот процесс называется индексацией.
---
### 3. Токены: Топливо для ИИ
^4d80b0
![[TW5.jpg]]
Токены — это кусочки текста, которые служат топливом для работы ИИ. Одно слово может состоять из нескольких токенов. Токены расходуются в трех основных случаях:
1. Индексация: Превращение ваших документов в векторы.
2. Запрос: Отправка вашего вопроса модели.
3. Ответ: Генерация финального ответа агентом.
Ваши расходы на использование ИИ измеряются именно в токенах.
---
## Timeweb Cloud: Платформа для Вашего Агента
^e6ba56
![[TW6.jpg]]
Timeweb Cloud предлагает удобную и функциональную платформу для создания и интеграции ИИ-агентов.
| Преимущество | Описание |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Удобство и Экосистема | Простая панель управления, где в одном месте можно арендовать сервер, купить домен и создать ИИ-агента. |
| Автоматизация | Аренда сервера позволяет бесплатно использовать такие инструменты, как n8n и nocodb, для создания сложных автоматизаций без программирования. |
| Поддержка | Доступен умный ассистент, который помогает с настройками, а также круглосуточная техническая поддержка 24/7. |
| Финансовая Модель | Пополнение баланса и покупка пакетов токенов популярных LLM-провайдеров происходит в рублях с российских банковских карт. Средства списываются по расходам, что удобно для планирования бюджета. |
>[!quote] Специальное предложение:
>Запустите проект в облаке с промокодом ELTON: https://tweb.link/krcf4
Для активации **удвоенного платежа** вводите промокод, а после пополняйте кабинет
---
## Шаг 1: Создание ИИ-Агента (Выбор Модели и Тарифа)
^2006c9
Процесс начинается в панели управления Timeweb Cloud в разделе «AI-агенты».
![[TW7.jpg]]
1. Добавление Агента: Перейдите в раздел и нажмите «Создать» или «Добавить».
![[TW8.jpg]]
---
2. Выбор Модели: Выберите подходящую модель нейросети.
![[TW9.jpg]]
![[TW10.jpg]]
>[!info] Важный технический нюанс:
>Изменить выбранную модель после создания агента будет невозможно
>Рекомендуется выбирать модель, оптимальную по соотношению цены и качества, например, GPT 5 mini (тратит токены на рассуждение) или gpt-4o-mini (не тратит токены на рассуждение)
---
3. Выбор Тарифа (Токены): Определите необходимое количество токенов.
![[tw11.jpg]]
>[!info] Важный технический нюанс:
>Вы можете увеличить тариф в процессе работы, но уменьшить его будет невозможно 1. Токены можно докупать по мере необходимости.
---
4. Начальная Настройка: На первом этапе вы можете пропустить настройку системного промпта и подключение базы знаний. Мы вернемся к ним позже.
![[tw12.jpg]]
---
5. Заказ: Проверьте параметры и нажмите «Заказать». Запуск агента займет несколько минут.
![[tw13.jpg]]
---
## Шаг 2: Настройка и Интеграция Агента
^ee15a3
После запуска агента переходим к его настройке и интеграции в ваши рабочие процессы.
![[tw14.jpg]]
---
### 2.1. Настройка Системного Промпта (Плейграунд)
^5a6aa9
Для того чтобы агент работал под ваши задачи, ему нужна четкая инструкция — системный промпт. Это делается во вкладке «Плейграунд».
![[tw15.jpg]]
Системный промпт определяет роль, цель, стиль общения и ограничения агента 1. Правильно сформулированная инструкция повышает точность и релевантность ответов.
| Рекомендация | Описание | Пример |
| --------------- | ------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| Личность Агента | Укажите имя, задачи и область экспертизы. | «Ты — Webby, виртуальный помощник, который помогает пользователям находить ответы в документации Timeweb Cloud.» |
| Цель Агента | Сформулируйте основную задачу, ключевые обязанности и приоритеты. | «Твоя главная задача — предоставлять точные, понятные и полные ответы на основе документации Timeweb Cloud.» |
| Экспертиза | Четко укажите, на какие данные он должен опираться, и научите его избегать вымышленных примеров. | «В качестве главного источника информации используй документацию Timeweb Cloud. Никогда не придумывай информацию сам.» |
| Ограничения | Укажите темы, которые запрещены, и что делать, если агент не знает ответа. | «Если ты не знаешь ответа, скажи: 'У меня недостаточно информации, чтобы ответить на этот вопрос.'» |
---
#### Тонкая Настройка Агента
В «Плейграунде» вы также можете настроить параметры генерации:
![[tw17.jpg]]
| Параметр | Назначение | Рекомендация для RAG |
| ------------------------------- | ------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------- |
| Максимальное количество токенов | Задает максимальную длину ответа. | Регулируйте в зависимости от требуемой детализации. |
| Температура | Степень креативности модели. | Снижайте (ближе к 0), чтобы агент работал строго по предоставленным данным и избегал галлюцинаций. |
| Top P | Порог вероятности выбора слов. | Более низкие значения обеспечат сфокусированность и связность ответов. |
| Улучшать запрос для поиска | Агент переформулирует ваш запрос для более точного поиска в базе знаний. | Рекомендуется включить для повышения точности поиска. |
---
### 2.2. Интеграция Агента
^5454c8
Timeweb Cloud предлагает несколько готовых способов интеграции вашего агента.
![[tw19.jpg]]
---
#### Интеграция на Сайт (Виджет)
![[tw18.jpg]]
>[!success] Это идеальное решение для сайтов компаний или личных блогов.
>Агент может выступать в роли онлайн-консультанта, помогая пользователям ориентироваться и консультируя потенциальных клиентов о продуктах.
1. Настройка Виджета: Во вкладке «Чат для встраивания» вы можете настроить внешний вид и указать разрешенные домены.
![[tw22.jpg]]
2. Получение Кода: Timeweb Cloud предоставляет готовый JS-код для вставки.
![[tw23.jpg]]
---
#### Интеграция с Telegram Ботом
Если у вас нет сайта, вы можете создать онлайн-консультанта в Telegram. Для этого достаточно:
1. Получить API-ключ для вашего бота через BotFather.
![[tw24.jpg]]
2. Вставить этот ключ в соответствующее поле в разделе «Интеграции» агента.
![[tw25.jpg]]
---
#### Использование API
![[Pasted image 20251205235737.png]]
Каждый агент получает свой API-эндпоинт.
Timeweb Cloud поддерживает два типа API:
- OpenAI-совместимый API: Подходит для интеграции с внешними библиотеками и UI.
- Нативный API: Более простой для быстрого использования.
API-ключи необходимы для авторизации запросов к приватному эндпоинту и позволяют настроить любые сложные автоматизации через внешние сервисы, такие как n8n.
Об этом поговорим чуть позже.
---
## Шаг 3: Создание и Подключение Базы Знаний (RAG-Сервис)
^8bbf9e
![[TW31.jpg]]
>[!quote] База знаний — это сердце вашего персонального агента.
>Она позволяет дообучить модель ИИ без помощи инженеров, используя ваши документы в качестве контекста.
---
1. Создание Базы Знаний: Вернитесь в раздел «AI-агенты» и выберите вкладку «База знаний». Нажмите «Добавить».
![[TW32.jpg]]
---
2. Тариф Индексации: Вам будет предложен тариф для индексации (например, 10 миллионов токенов).
![[TW33.jpg]]
>[!quote] Важно:
>Эта сумма (например, 450 рублей) списывается сразу и предназначена для превращения ваших документов в векторы. В дальнейшем токены из этого пакета будут тратиться на индексацию новых файлов.
---
3. Загрузка Данных: В разделе «Источник данных» вы можете загрузить свои файлы.
![[TW34.jpg]]
>[!info] Ограничение:
>Суммарный объем загружаемых файлов пока не должен превышать 50 мегабайт. Поддерживаются различные форматы (например, Markdown-заметки из Obsidian).
---
4. Выбор Сервера: Выберите сервер с базой данных, на котором будут храниться ваши векторы.
![[TW35.jpg]]
![[TW36.jpg]]
>[!quote] Производительность:
>От выбора сервера зависит скорость обращения агента к базе знаний. Для индивидуального использования может быть достаточно минимальной конфигурации.
>[!info] Оплата:
>В отличие от токенов, аренда сервера списывается по дням, что позволяет гибко планировать расходы.
---
5. Запуск и Подключение: После заказа RAG-сервис будет готов через 10–15 минут. Вернитесь к вашему ИИ-Агенту, перейдите в «Управление» и выберите созданную базу знаний.
![[TW37.jpg]]
---
После подключения базы знаний обязательно протестируйте агента в «Плейграунде», задав ему вопрос, ответ на который содержится только в ваших новых документах.
![[TW38.jpg]]
![[TW39.jpg]]
---
### Один из самых мощных способов использования ИИ-Агента — это интеграция его в автоматизированные рабочие процессы.
^d18421w
Мы рассмотрим, как создать Telegram-бота-комьюнити-менеджера с помощью n8n, который будет отвечать на вопросы в чате, используя базу знаний Timeweb Cloud.
![[Pasted image 20251206003232.png]]
>[!warning] Предварительное условие:
>У вас должен быть развернут собственный экземпляр n8n (например, на сервере Timeweb Cloud) и получен API-ключ для вашего ИИ-Агента.
---
### 1. Настройка Telegram-Триггера
Первый шаг — настроить ноду, которая будет слушать входящие сообщения в Telegram.
![[Pasted image 20251206003533.png]]
![[Pasted image 20251206003607.png]]
Эта нода будет запускать рабочий процесс при получении любого текстового сообщения в чате или личных сообщениях бота.
---
### 2. Запрос к ИИ-Агенту через HTTP-Ноду
Для отправки запроса к Timeweb Cloud AI Agent мы используем ноду HTTP Request. Агент Timeweb Cloud предоставляет OpenAI-совместимый API, что упрощает интеграцию.
![[Pasted image 20251206003643.png]]
![[Pasted image 20251206003837.png]]
![[Pasted image 20251206003802.png]]
![[Pasted image 20251206004315.png]]
В конце URL обязательно добавляем (как на скрине):
```
/chat/completions
```
Затем настраиваем другие настройки текущего модуля:
- Включаем Send Headers:
И заполняем
- Name: `Authorization`
- Value: `Bearer [и ваш API-ключ] `
Чтобы найти API ключ, открываем настройки timeweb cloud:
![[Pasted image 20251206004745.png]]
![[Pasted image 20251206004807.png]]
Полученный ключ вставляем рядом со словом Bearer в n8n (нода http):
![[Pasted image 20251206004840.png]]
- теперь создаем еще один Header - "Add Parameter"
![[Pasted image 20251206005042.png]]
```
Content-Type
application/json
```
- Теперь нужно сформировать тело запроса к ИИ (то есть, наш текст полученный от ноды Telegram)
![[Pasted image 20251206005334.png]]
- теперь в поле JSON вставляем вот такой код, в котором мы указываем, что именно отправлять - json.data.text и есть текст, полученный от Telegram ноды:
```
{
"model": "gpt-5-mini",
"messages": [
{
"role": "user",
"content": "{{ $json.message.text }}"
}
],
"max_completion_tokens": 3000,
"stream": false
}
```
---
### 3. Обработка Ответа и Отправка в Telegram
После получения ответа от ИИ-Агента (нода HTTP Request) нам нужно извлечь текст ответа и отправить его обратно пользователю.
![[Pasted image 20251206010351.png]]
- и заполняем в этой ноде следующие данные:
**Chat ID:**
```
{{ $('Telegram Trigger').item.json.message.chat.id }}
```
**Text**:
```
{{ $json.choices[0].message.content }}
```
![[Pasted image 20251206010346.png]]
И всё! Наш бот уже работает!
---
### Схема Рабочего Процесса n8n
1.Telegram Trigger (Получает сообщение)
2.HTTP Request (Отправляет сообщение агенту Timeweb Cloud)
3.Set (Извлекает текст ответа)
4.Telegram (Отправляет ответ пользователю)
Таким образом, вы создаете полностью автоматизированного, обученного на ваших данных комьюнити-менеджера, который работает 24/7.
![[TW40.jpg]]
---
## Расширенный Кейс: Корпоративный ИИ с Open WebUI и Docker
^0dd73d
![[tw41.jpg]]
Для командной работы и обеспечения доступа к ИИ-Агенту без VPN и сложных настроек идеально подходит связка Docker + Open WebUI.
Open WebUI предоставляет удобный, похожий на ChatGPT интерфейс, который можно подключить к вашему Timeweb Cloud AI Agent через его OpenAI-совместимый API.
---
### 1. Развертывание Open WebUI с помощью Docker
Этот подход позволяет получить интерфейс, похожий на ChatGPT, для командной работы или личного использования, без необходимости развертывания на удаленном сервере.
![[tw44.jpg]]
## 1. Предварительные Условия
1. Установленный Docker Desktop: Вы должны скачать и установить [Docker Desktop](https://www.docker.com/products/docker-desktop/) для вашей операционной системы.
>[!info] Что это такое?
Docker запускает программы в отдельных коробках, чтобы ничего не конфликтовало. И всё работает одинаково на любом компьютере
2. Timeweb Cloud AI Agent: У вас должен быть создан и настроен ИИ-Агент в панели управления Timeweb Cloud с полученным API-ключом и API-эндпоинтом (URL).
## 2. Запуск Open WebUI одним Командой
Open WebUI распространяется как Docker-образ, что позволяет запустить его одной командой в командной строке (cmd.exe, PowerShell, Terminal).
1. Открываете поиск на Windows
2. Пишете cmd.exe
3. Открывается командная строка и туда вставляете установщик Open WebUI
```
docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name openwebui --restart always ghcr.io/open-webui/open-webui:main
```
- Что этот код делает? Во-первых, запускает docker
| Параметр | Описание |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| -d | Запускает контейнер в фоновом режиме (detached). |
| -p 3000:8080 | Пробрасывает порт 8080 внутри контейнера на порт 3000 на вашем компьютере. Вы будете обращаться к интерфейсу по адресу http://localhost:3000. |
| --name openwebui | Присваивает контейнеру удобное имя openwebui |
| -v open-webui:/app/backend/data | Создает том Docker для сохранения данных (настроек, пользователей, истории чатов ) между перезапусками. |
| --restart always | Гарантирует, что контейнер автоматически запустится после перезагрузки Docker или компьютера. |
### 2.2. Проверка Запуска
После выполнения команды вы можете проверить статус контейнера:
1. Через Docker Desktop: Как показано на скриншоте, контейнер с именем openwebui должен появиться в списке. Убедитесь, что он запущен (или нажмите кнопку Start, если он остановлен).
Скриншот из приложения Docker:
![[Pasted image 20251206012136.png]]
- Запускаем контейнер - нажимаем на Start (см скриншот)
- И открываем локальный страницу (работает только на вашем устройстве) -
```
http://localhost:3000/
```
>[!warning] При первом запуске Open WebUI предложит вам создать учетную запись администратора.
>Зарегистрируйтесь, используя вашу почту и пароль
Open WebUI поддерживает подключение внешних моделей, совместимых с API OpenAI.
**Ваш Timeweb Cloud AI Agent как раз использует такой стандарт.**
1. Перейдите в Настройки: В интерфейсе Open WebUI найдите иконку Settings (Настройки) или ваш профиль.
2. Добавление Подключения: Перейдите в раздел Connections
![[Pasted image 20251206012528.png]]
- Нажимаем на плюсик.
![[Pasted image 20251206012610.png]]
- Теперь заполняем подключение.
3. Конфигурация OpenAI-совместимого API:
- Копируем из сайта timeweb cloud
![[Pasted image 20251206013126.png]]
- и вставляем в open webui
![[Pasted image 20251206013216.png]]
- осталось получить API ключ, который как вы помните, есть "Управление" - Публичный (доступность)
![[Pasted image 20251206013307.png]]
- и добавляем его на open webui
![[Pasted image 20251206013906.png]]
![[Pasted image 20251206013411.png]]
- обязательно нажимаем "Сохранить" в правом нижнем углу и готово!
![[Pasted image 20251206013439.png]]
После сохранения настроек, ваш Timeweb Cloud AI Agent, обученный на вашей корпоративной базе знаний, станет доступен для выбора в выпадающем списке моделей в главном окне чата Open WebUI.
---
## Это обеспечивает:
![[TW50.jpg]]
- Единый интерфейс: Сотрудники работают в привычном чат-интерфейсе.
- Безопасность: Доступ к обученному ИИ без необходимости настройки VPN.
- Корпоративный Поиск: ИИ-Агент выступает в роли умного поиска по внутренней документации и инструкциям компании.
---
## Примеры Применения: От Личной Рутины до Бизнес-Автоматизации
^e2f7a7
![[TW51.jpg]]
### Личные Кейсы (Telegram-Боты)
Вы можете создать несколько ассистентов для разных задач, используя интеграцию с Telegram:
![[TW52.jpg]]
- Наставник: Помогает с целями и задачами, мотивирует, опираясь на ваши личные заметки и прочитанные книги.
- Комьюнити-Менеджер (Подробный Кейс с n8n): Экономит ваше время, автоматически отвечая на типовые вопросы в чатах, используя базу знаний о вашем проекте
Эта автоматизация легко реализуется через n8n, размещенный на сервере Timeweb Cloud.
Создается аналогичным образом, описанным в предыдущем примере - [[15. Создаем ИИ агентов без программирования#^d18421w|клик]]
---
### Бизнес-Кейсы (Автоматизация и Рост)
![[tw56.jpg]]
1. Онлайн-Консультант на Сайте:
>[!quote] Внедрение виджета с ИИ-агентом, обученным на всей информации о ваших продуктах и услугах, способствует росту выручки за счет мгновенной реакции на запросы клиентов.
2. Внутренний Корпоративный ИИ (Open WebUI):
>[!quote] Используя технологию Open WebUI, вы можете предоставить сотрудникам доступ к ИИ с корпоративной базой знаний.
>Интерфейс напоминает ChatGPT, но работает без дополнительных настроек сети (VPN), становясь умным поиском по внутренней документации и инструкциям .
3. Сложные Автоматизации через API: Используя API-ключ Timeweb Cloud и n8n, можно настроить:
- Автоматические ответы на деловые письма: Агент, обученный на корпоративных знаниях, может составлять черновики или отправлять готовые ответы.
![[TW59.jpg]]
- Умные рассылки: Настройка персонализированных рассылок об акциях, повышающих вероятность продаж.
---
## Заключение
Создание персонального ИИ-Агента на Timeweb Cloud — это мощный шаг к автоматизации и повышению эффективности.
Вы получаете возможность быстро и просто создавать ассистентов для бизнеса, рутины и саморазвития, без программистов и сложных интеграций.
Пошаговое объяснение всех действий, включая подробные сценарии автоматизации с n8n и Timeweb Cloud, вы всегда найдете на моем сайте.
**Не забудьте:**
При первом пополнении используйте промокод ELTON, чтобы удвоить сумму на вашем аккаунте.
---
### Источники
1. Документация TimeWeb Cloud по ИИ агентам - [Ссылка](https://timeweb.cloud/docs/ai-agents)
---
© 2025 Elton Labs. Все права защищены.