ГлавнаяМатериалы из Reels/ShortsЧек-лист
Чек-листНовое
кодовое словоКоманда

Один ИИ-агент на всю команду

Чек-лист запуска общего командного ИИ-агента на TrueForge: локальная проверка, подключение моделей и инструментов, создание агента и перенос в общий Hosted-режим с авторизацией сотрудников.

Содержание6 глав
  1. 011. Подготовьте доступы
  2. 022. Проверьте агента локально
  3. 033. Соберите первого агента
  4. 04Готовые инструкции для поля агента
  5. 054. Перенесите запуск в командный режим
  6. 065. Проверьте типовые сбои

1. Подготовьте доступы

  • Выберите режим: Local для пробы на своём компьютере или Hosted для общего агента. Local хранит данные в SQLite; Hosted использует Postgres и Redis. Репозиторий TrueForge.
  • Для локального запуска проверьте Node.js: нужна версия 22.14 или новее.
  node -v
  • Подготовьте API-ключ провайдера модели: OpenAI, Anthropic, Google Gemini, другого провайдера из каталога или сервиса с OpenAI-совместимым адресом. TrueForge бесплатен; токены оплачиваются провайдеру модели.
  • Для командного запуска подготовьте сервер или компьютер в общей сети с Docker и корпоративный OIDC-вход: Okta, Microsoft Entra ID или другой OIDC-провайдер.

2. Проверьте агента локально

  npx @truefoundry/trueforge@latest
  • Откройте http://localhost:8790. В локальном режиме нет входа, данные хранятся в файле SQLite. Не выставляйте этот режим в интернет.
  • Откройте Settings → Models, найдите провайдера, нажмите Configure, вставьте API-ключ в Configure Provider Details и нажмите Create.
  • Откройте Settings → Connectors, выберите Exa для веб-поиска без авторизации и нажмите Connect. Для собственного MCP-сервера используйте Add MCP Server.
  • Если нужен скилл web-artifacts-builder, включите его через Settings → Skills → Enable. Подготовьте ключ Daytona с правами на запись и удаление снапшотов и на запись песочниц. Затем откройте Settings → Sandbox providers → Daytona → Configure, вставьте ключ и нажмите Save. Скиллы запускаются в песочнице; без неё этот скилл не заработает. Шаги настройки TrueForge.

3. Соберите первого агента

  • Откройте Build Agent. Выберите модель, вставьте инструкцию в поле инструкций, включите Exa через Select MCP Tools и подключите нужный скилл.
  • Проверьте агента в чате справа: он должен отвечать в рамках выбранной инструкции и использовать подключённые инструменты.
  • Нажмите Save Agent, укажите имя и описание, затем Save changes.
  • Откройте Agents и проверьте, что кнопка Try запускает новый чат с сохранённым агентом.

Готовые инструкции для поля агента

  • Выберите подходящий вариант и замените текст в угловых скобках перед сохранением.
Промт 11 строка · 254 знака
Ты исследователь команды <название>. На любой вопрос сначала ищешь свежие источники через веб-поиск, потом отвечаешь коротким брифом: вывод в 3 строках, 5 фактов со ссылками, что осталось непроверенным. Не выдумывай цифры: если источника нет, так и пиши.

Разбор входящих задач

Промт 21 строка · 239 знаков
Ты помогаешь команде <название> разбирать входящие задачи. Для каждой задачи верни: суть в одном предложении, кто из ролей <список ролей> должен взять, срок по срочности, первые 3 шага. Если данных не хватает, задай один уточняющий вопрос.

Черновики для клиентов

Промт 31 строка · 220 знаков
Ты готовишь черновики писем клиентам компании <название>. Тон: прямой, без канцелярита, на «вы». Всегда заканчивай письмо одним конкретным следующим шагом. Перед отправкой человеку покажи черновик и спроси подтверждение.

4. Перенесите запуск в командный режим

  • Разверните Hosted на сервере через Docker Compose. Этот режим использует Postgres и Redis. Быстрый старт.
  git clone https://github.com/truefoundry/trueforge && cd trueforge
  cp packages/trueforge/.env.example packages/trueforge/.env
  docker compose up --build
  • Откройте интерфейс на порту 8791. В packages/trueforge/.env замените пароль Postgres и задайте PUBLIC_BASE_URL — публичный адрес, по которому коллеги будут открывать TrueForge.
  • До передачи адреса коллегам включите вход. Без OIDC любой, кто откроет адрес, получит права администратора. Настройка входа.
  • В OIDC-провайдере создайте приложение типа Web с Authorization Code. Укажите адрес возврата https://<адрес-trueforge>/api/v1/auth/callback; он должен соответствовать PUBLIC_BASE_URL. Разрешите вход нужным людям или группам и добавьте группы в ID-токен. Тип приложения SPA не подходит.
  • В окружении TrueForge задайте OIDC_ISSUER_URL, OIDC_CLIENT_ID, OIDC_CLIENT_SECRET, OIDC_USER_ROLE_CLAIM и OIDC_ADMIN_ROLE_VALUE. Последнее значение должно совпадать с группой администраторов в ID-токене; остальные пользователи получат роль user. Параметры OIDC.
  • Перезапустите TrueForge и проверьте, что без входа интерфейс не открывается.
  • Подключите модель, инструменты и скиллы в Settings, сохраните общего агента. Попросите коллег войти со своими аккаунтами и открыть его в Agents.

5. Проверьте типовые сбои

  • Если npx сообщает о несовместимой версии, обновите Node.js до 22.14 или новее.
  • Если порт 8790 занят, запустите локальный режим на другом порту:
  PORT=3000 npx @truefoundry/trueforge
  • Если модель не отвечает, проверьте API-ключ и баланс у провайдера, затем пересоздайте подключение в Settings → Models.
  • Если коллеги не могут войти, сверьте адрес возврата OIDC-приложения с PUBLIC_BASE_URL и /api/v1/auth/callback; проверьте, что приложение имеет тип Web, а не SPA. Диагностика входа.
Скачать материал