Как сделать свой ИИ-чат-бот на базе сервиса Timeweb

Определите задачу чат-бота

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

• для учащихся — объяснять темы, помогать с подготовкой, тренировать ответы;
• для педагогов — готовить материалы, сокращать рутинные операции;
• для посетителей сайта — отвечать на частые вопросы и направлять к нужным разделам.

Подготовьте базу знаний

Соберите материалы, на которые бот должен опираться: учебные параграфы, конспекты, методички, FAQ, HTML-страницы сайта.

• разбейте большие документы на понятные файлы по темам;
• удалите дубли и устаревшие версии;
• добавьте названия тем, классы, даты обновления;
• отдельно подготовьте файл «Правила ответа» или «Инструкция для бота».

Создайте базу знаний в Timeweb Cloud

В панели Timeweb Cloud откройте раздел «AI-агенты» → «Базы знаний» и создайте новую базу.

1. Нажмите «Создать» или «Добавить».
2. Загрузите файлы или подключите источник по ссылке.
3. Выберите тариф для хранения и индексации.
4. Дайте базе понятное имя, например «Учебные материалы 9–11 классы».
5. Дождитесь индексации.

Создайте AI-агента

В разделе «AI-агенты» создайте нового агента и задайте основные параметры.

• выберите модель под задачу: быстрая — для FAQ, более сильная — для сложных объяснений;
• установите лимит токенов, чтобы контролировать расход;
• подключите базу знаний;
• добавьте системный промпт;
• при необходимости включите веб-поиск или генерацию изображений.

Протестируйте агента в плейграунде

До публикации проверьте, как бот отвечает на реальные запросы.

Встройте чат-бота на сайт

Самый простой вариант — готовый виджет Timeweb.

1. Откройте нужного AI-агента.
2. Перейдите во вкладку «Интеграции».
3. В блоке «Чат для встраивания» нажмите «Настроить».
4. Включите чат и настройте имя, приветствие, цвет, шрифт, иконку и положение виджета.
5. Во вкладке «Домены» укажите сайты, где разрешён виджет.
6. Во вкладке «Вставка» скопируйте готовый код и разместите его перед закрывающим тегом </body>.

Нативный API

Подходит для простого MVP: отправляете одно сообщение агенту и получаете ответ. История может продолжаться через parent_message_id.

const response = await fetch(
  "https://api.timeweb.cloud/api/v1/cloud-ai/agents/YOUR_AGENT_ID/call",
  {
    method: "POST",
    headers: {
      "authorization": `Bearer ${process.env.TIMEWEB_TOKEN}`,
      "content-type": "application/json"
    },
    body: JSON.stringify({
      message: "Объясни тему простыми словами"
    })
  }
);

const data = await response.json();
console.log(data.message);

OpenAI-совместимый API

Подходит, если уже есть готовый чат-интерфейс, SDK, LangChain, Open WebUI или похожая инфраструктура.

const response = await fetch(
  "https://agent.timeweb.cloud/api/v1/cloud-ai/agents/YOUR_AGENT_ID/v1/chat/completions",
  {
    method: "POST",
    headers: {
      "authorization": `Bearer ${process.env.TIMEWEB_TOKEN}`,
      "content-type": "application/json"
    },
    body: JSON.stringify({
      model: "model-from-agent-settings",
      messages: [
        { role: "system", content: "Ты образовательный помощник. Отвечай точно и понятно." },
        { role: "user", content: "Что такое RAG?" }
      ],
      stream: false
    })
  }
);

const data = await response.json();
console.log(data.choices?.[0]?.message?.content);