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

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

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

- [ ] Выберите режим: **Local** для пробы на своём компьютере или **Hosted** для общего агента. Local хранит данные в SQLite; Hosted использует Postgres и Redis. [Репозиторий TrueForge](https://github.com/truefoundry/trueforge).
- [ ] Для локального запуска проверьте [Node.js](https://nodejs.org/en/download): нужна версия **22.14 или новее**.

```bash
  node -v
```

- [ ] Подготовьте API-ключ провайдера модели: OpenAI, Anthropic, Google Gemini, другого провайдера из каталога или сервиса с OpenAI-совместимым адресом. TrueForge бесплатен; токены оплачиваются провайдеру модели.
- [ ] Для командного запуска подготовьте сервер или компьютер в общей сети с [Docker](https://docs.docker.com/get-started/get-docker/) и корпоративный OIDC-вход: Okta, Microsoft Entra ID или другой OIDC-провайдер.

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

- [ ] Запустите TrueForge по [инструкции быстрого старта](https://trueforge.dev/quickstart):

```bash
  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](https://www.daytona.io/) с правами на запись и удаление снапшотов и на запись песочниц. Затем откройте **Settings → Sandbox providers → Daytona → Configure**, вставьте ключ и нажмите **Save**. Скиллы запускаются в песочнице; без неё этот скилл не заработает. [Шаги настройки TrueForge](https://trueforge.dev/quickstart).

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

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

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

- [ ] Выберите подходящий вариант и замените текст в угловых скобках перед сохранением.

```text
Ты исследователь команды <название>. На любой вопрос сначала ищешь свежие источники через веб-поиск, потом отвечаешь коротким брифом: вывод в 3 строках, 5 фактов со ссылками, что осталось непроверенным. Не выдумывай цифры: если источника нет, так и пиши.
```

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

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

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

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

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

- [ ] Разверните **Hosted** на сервере через Docker Compose. Этот режим использует Postgres и Redis. [Быстрый старт](https://trueforge.dev/quickstart).

```bash
  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 любой, кто откроет адрес, получит права администратора. [Настройка входа](https://trueforge.dev/authentication/overview).
- [ ] В 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](https://trueforge.dev/authentication/overview).
- [ ] Перезапустите TrueForge и проверьте, что без входа интерфейс не открывается.
- [ ] Подключите модель, инструменты и скиллы в **Settings**, сохраните общего агента. Попросите коллег войти со своими аккаунтами и открыть его в **Agents**.

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

- [ ] Если `npx` сообщает о несовместимой версии, обновите Node.js до **22.14 или новее**.
- [ ] Если порт **8790** занят, запустите локальный режим на другом порту:

```bash
  PORT=3000 npx @truefoundry/trueforge
```

- [ ] Если модель не отвечает, проверьте API-ключ и баланс у провайдера, затем пересоздайте подключение в **Settings → Models**.
- [ ] Если коллеги не могут войти, сверьте адрес возврата OIDC-приложения с `PUBLIC_BASE_URL` и `/api/v1/auth/callback`; проверьте, что приложение имеет тип **Web**, а не **SPA**. [Диагностика входа](https://trueforge.dev/authentication/overview).

---

Источник: https://localhost:3000/m/odin-ii-agent-na-vsyu-komandu-chek-list-zapuska-trueforge