Глоссарий
Термины продукта одним списком.
Термины с пометкой (разработка) относятся только к проектам разработки; в пространстве без кода они не встречаются.
| Термин | Значение |
|---|---|
| ИИ-агент | Модель, которая выполняет работу в Buff: отвечает на вопросы, пишет документ исследования, ведёт задачу разработки. На страницах документации то же называется «модель». Читает документы и код, пишет только ответ, документ исследования и записи в базу знаний. |
| Токен | Кусочек текста — часть слова, — которым модель читает и пишет. Всё прочитанное считается «входом», всё написанное — «выходом»; за них и идёт оплата. См. Сколько стоит вопрос. |
Обращение к боту (@buff) | Комментарий в Notion, Google Документе, Confluence, Figma или тикете трекера с упоминанием бота или командой /ask, /research: вопрос или заказ исследования там, где вы работаете; ответ приходит туда же. См. Спросить прямо в ваших инструментах. |
| Вложение | Файл, приложенный к вопросу, черновику задачи, уточнению или замечанию: Word, Excel, PowerPoint, PDF, текст — до 10 МБ; читается содержимым. Сканы без текстового слоя не читаются. |
| Наблюдатель | Участник, который только смотрит: Contributor с выключенными правами создавать задачи, задавать вопросы, начинать исследования и добавлять замечания. Ничего не запускает и баланс не расходует. См. Сценарии для команд. |
| Организация | Изолированное пространство команды: владелец и участники. |
| Владелец | Участник с полными правами в организации: состав, права, биллинг, коннекторы. |
| Роль участника | Набор прав по умолчанию: Contributor (свои задачи) или Maintainer (и чужие тоже). См. Участники и права. |
| Область прав | Где действует роль участника: вся организация, проект разработки (или пространство) или репозиторий. Самая узкая область главнее. |
| Право | Атомарное разрешение на одно действие («утверждать формулировку чужих задач»); роль — их набор, который можно поправить точечно. |
| Журнал аудита | Неизменяемая запись действий в организации: кто, когда, откуда, что и с каким результатом. Не путать с аудитом проекта. См. Журнал аудита. |
| База знаний | Общее хранилище знаний организации для человека и модели: правила, факты и ловушки. Доходит до модели на всех этапах работы. См. База знаний. |
| Знание | Одна запись базы: заголовок, описание одной строкой, тип, область, тело. Один факт — одна запись. |
| Индекс знаний | Список всех записей области (заголовок + описание одной строкой), который попадает в каждый прогон модели; тела открываются по требованию. |
| «Показывать модели сразу» | Признак записи: модель получает её целиком в каждой задаче, а не открывает по необходимости. Увеличивает расход каждой задачи. |
| Перманентная запись | Признак записи: ИИ не может её изменить или убрать в архив; человек с правом изменения — может. |
| Архив знаний | Куда уходит запись вместо удаления: видна по праву чтения, возвращается по праву изменения. Удаления в базе знаний нет. |
| Проход извлечения | Прогон по итогам законченной работы: читает её и записывает уроки в базу знаний. |
| Проход консолидации | Прогон следом за извлечением: сливает дубли, актуализирует описания, архивирует своё устаревшее, помечает расхождения в записях человека. |
| «Требует проверки» | Пометка, которую модель ставит записи человека, разошедшейся с текущим кодом: сама она такую запись не меняет. Снимается кнопкой «Проверено» или правкой записи. |
| Единый вход (SSO) | Вход через корпоративный провайдер идентификации (IdP) по OIDC или SAML 2.0 вместо пароля и кода на почту; аккаунт создаётся при первом входе. См. Единый вход. |
| Провайдер идентификации (IdP) | Система компании, которая подтверждает личность сотрудника: Keycloak, AD FS, Entra ID, Avanpost и другие. |
| Проект разработки | Проект, где идёт разработка; собирает репозитории как источники. |
| Пространство | Рабочее место без кода: вопросы, исследования и база знаний по документам команды. Область прав и записей — как проект. См. Пространство без кода. |
| Репозиторий | Импортированное зеркало внешнего git-репозитория (upstream). |
| Источник | Репозиторий и ветка (repo@branch), подключённые в проект. |
| Upstream | Внешний оригинал репозитория (GitHub / GitLab / Bitbucket / Gitea и Forgejo). |
| Коннектор | Агент в вашей сети: подключает self-hosted git за фаерволом (или избавляет от передачи нам токенов) и запускает у вас интеграции с трекерами, источниками знаний и свои MCP-серверы. См. Коннектор. |
| Интеграция (плагин) | Код из каталога, который коннектор запускает у себя: связь с трекером или другой вашей системой. См. Каталог. |
| Подключение | Связь интеграции с конкретной системой: адрес, учётные данные, область видимости, проект разработки или пространство. Двух Jira — два подключения одной интеграции. |
| Слаг | Короткое имя подключения. Попадает в имена инструментов, которые видит модель. |
| Каталог интеграций | Подписанный список того, что можно поставить, с границами доступа каждой версии. |
| Область видимости | Репозитории, проекты, пространства или папки, где подключение читает документы и обращения и пишет ответы. У трекеров пустой список означает «нигде»; у Notion, Confluence, Google Диска, Figma и файлов — всё, что доступно учётной записи (см. Источники знаний). |
| Источник знаний | Интеграция, которая даёт модели читать написанное и нарисованное командой (Confluence, Notion, Google Диск, Figma, файлы на диске и сетевые папки, при желании — интернет), а не ведёт задачи. См. Источники знаний. |
| Инструмент | Действие, которое интеграция отдаёт модели (найти задачи, прочитать тикет, взять diff). Пишущие модели не отдаются. |
| Приёмник событий | Порт коннектора для вебхуков внешних систем — трекеров, Confluence, Figma. Обычно необязателен — без него работает опрос. Обязателен для комментариев к коммитам GitLab и для Figma без списка файлов и проектов; для Figma он должен быть доступен из интернета. |
| Свой MCP-сервер | MCP-сервер, который вы добавили в коннектор сами — из архива, репозитория GitHub или по адресу; модели отдаются только инструменты, отмеченные администратором как читающие. См. Свои MCP-серверы. |
| Задача | Единица работы: постановка → формулировка → декомпозиция → разработка → ревью. |
| Черновик | Задача, которую вы ещё редактируете и не отправили в проработку. |
| Постановка | Исходная формулировка задачи от автора. |
| Проработка / формулировка (разработка) | Этап, где аналитик превращает постановку в согласованную спецификацию. |
| Аналитик | Роль ИИ-агента, а не сотрудник: в формулировке задачи превращает постановку в спецификацию и задаёт уточнения; в глубоком исследовании пишет документ, который проверяет второй агент. |
| Уточнения (разработка) | Уточняющие вопросы аналитика к автору задачи. |
| Декомпозиция (разработка) | Разбиение задачи на атомы. |
| Атом (подзадача) (разработка) | Наименьшая независимо собираемая единица работы. |
| Волна (разработка) | Группа атомов, выполняемых параллельно в порядке зависимостей. |
| Схема выполнения (разработка) | Граф атомов и волн задачи. |
| Прогон (разработка) | Один запуск пайплайна задачи; его можно остановить и возобновить. |
| Ревью (разработка) | Проверка изменений человеком до публикации. |
| Замечание (разработка) | Комментарий ревью (от модели или пользователя) со статусом. |
| Публикация (разработка) | Открытие pull request / merge request в upstream после одобрения. |
| Аудит (разработка) | Понимание кодовой базы «как есть», по разделам. |
| Инструменты разработки (разработка) | Подготовка сборки/тестов — «точки отсчёта» проекта. |
| Спросить | Вопросы по документам компании или по коду, только на чтение: ответ со ссылкой на страницу, файл, тикет или запись базы знаний. См. Спросить. |
| Глубокое исследование | Два агента (аналитик и ревьюер) готовят выверенный документ по документам компании или по коду. См. Глубокое исследование. |
| Токены | Расход модели: ввод, кэш, вывод, рассуждения — см. Токен выше. |