---
title: "Проекты и настройки"
id: "1995"
type: "page"
slug: "projects"
published_at: "2026-09-20T16:13:20+00:00"
modified_at: "2026-09-21T00:00:47+00:00"
url: "https://pastukhov.com/agents/ui/docs/projects"
markdown_url: "https://pastukhov.com/agents/ui/docs/projects.md"
excerpt: "Проект — это один проверяемый сайт или приложение. Все настройки проекта лежат обычными файлами в…"
---

# Проекты и настройки

[https://pastukhov.com/agents/ui/docs/projects.md](https://pastukhov.com/agents/ui/docs/projects.md)

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

## Проект — это папка

Один сайт — один проект — одна папка. В папке лежит всё, что описывает ваши проверки, и ничего лишнего: файлы настроек и небольшие скрипты. Папку проектов можно скопировать на другой сервер целиком и продолжить работу там — никакого экспорта и переноса базы для этого не нужно.

| Что в папке | Зачем это |
| --- | --- |
| project.yml | Название, базовый адрес сайта, описание, часовой пояс и модель ИИ-агента для этого проекта |
| screen-types.yml | Типы экранов: «вход», «оплата», «кабинет» — с образцом адреса, по которому тип определяется |
| rules/ | Сами проверки — по одному небольшому файлу на правило |
| actions/ | Записанные и написанные агентом сценарии работы с интерфейсом |
| tests/ | Тесты: последовательности шагов, которые запускаются вместе |
| skills/ | Знания для агента: validator.md (что агент уже понял про ваш интерфейс) и navigation.md (как по нему ходить) |
| comments/ | Замечания к экранам — обычный текст, по файлу на экран |

Все эти файлы удобно держать под контролем версий — так называют программу, которая запоминает историю изменений файлов (например, git). Тогда у каждой правки есть автор и время, а любую неудачную правку можно откатить. **Изменения в историю записывает человек**: сервер сам не записывает изменения в историю, чтобы в истории не появлялись служебные записи без вашего ведома.

## Что хранится в базе

Часть данных живёт не в папке, а в базе продукта: снимки экранов, запуски с их шагами и результатами, проблемы, расписания и разборы замечаний. Причина простая: этого добра много, оно меняется каждый день, и хранить его в папке проекта было бы неудобно и для истории правок, и для самого продукта. Настройки и скрипты, наоборот, меняются редко и важны как документ — поэтому они в файлах.

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

## Создание проекта

- **Название** — как проект будет называться в интерфейсе. Пишите по-человечески: «Магазин», «Личный кабинет».
- **Адрес папки** — из названия предлагается автоматически: строчные латинские буквы, цифры и дефисы, от 3 до 63 знаков. Именно эта папка появится на диске.
- **Базовый адрес** — адрес сайта, который проверяем. По нему панель в браузере сама понимает, к какому проекту относится открытая страница.
- **Описание** — пара слов для себя и для агента: что это за система.
- **Часовой пояс** — по нему считаются расписания. Если ошибиться, запуски будут приходить в неправильное время, поэтому неверное значение продукт не примет и покажет ошибку у поля.
- **Модель агента** — какую модель использовать для разбора замечаний именно в этом проекте. Проекты разные, и требования к модели у них тоже разные.

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

## Как менять настройки

Название, базовый адрес, часовой пояс и модель агента меняются на вкладке «Настройки проекта» в обычной форме — файлы настроек переписываются аккуратно, и неверное значение никогда не оставит файл в половинчатом состоянии. Правила, действия и тесты можно посмотреть и поправить через диалог «Файлы проекта»: если файл изменён на диске, список в интерфейсе сразу это покажет, потому что он читается из файлов, а не из памяти продукта.

## Изоляция проектов

Проекты не видят друг друга: списки экранов, правила и проблемы одного проекта никогда не попадут в другой. Это важно, когда проверяете сразу несколько систем — например, клиентский сайт и внутреннюю программу.

## Удаление проекта

При удалении проекта папка удаляется целиком вместе с правилами, действиями и тестами. Отменить это нельзя — восстанавливать придётся из вашей истории версий, если вы её ведёте. Если проект нужно просто приостановить, удалять его не стоит: снимите галочку с расписаний, и запусков не будет, а накопленные проверки останутся на месте.

Дальше: как установить дополнение Chrome и что в его панели — в разделе [Дополнение Chrome](/agents/ui/docs/addon)
.

[← Оглавление документации](/agents/ui/docs)