Політика використання AI та реєстр, який мала команда здатна втримувати
Політика використання AI каже людям, що їм дозволено. Реєстр показує, що кожна AI-можливість у вашій команді може робити, хто її запускає і коли потрібне схвалення людини. Тримайте його одним файлом у репозиторії, і нехай тест валить збірку, коли в можливості немає рядка.
🎯 Для Тімлід або розробник, який керує AI-агентами у спільній роботі
- Що належить до реєстру AI і що мусить казати політика використання в шести рядках
- Як збудувати реєстр приблизно за 30 хвилин і захистити його тестом
- Де реєстр перестає допомагати
📋 Що таке реєстр і чому самої політики не досить
Політика використання каже, що люди можуть робити з AI. Реєстр каже, що кожна AI-можливість у вашій команді насправді має право робити, хто може її запустити і коли рішення ухвалює людина. Без реєстру політика — це побажання: ніхто не скаже конкретного вівторка, який агент може змінювати файли, який може писати в систему замовника, а який лише читає.
Реєстр — це звичайний файл у вашому репозиторії. Один рядок на можливість: роль агента, бібліотека промптів, конектор, задача за розкладом. Кожен рядок відповідає на ті самі сім питань, тож рецензент прочитає сорок рядків за десять хвилин.
| Поле | Питання, на яке відповідає | Приклад значення |
|---|---|---|
| id | Як воно називається? | release-notes-writer |
| purpose | Правило чи дія: воно лише описує, як працювати, чи діє? | правило / діє |
| authority | Це наше власне правило чи зовнішня порада, яку можна проігнорувати? | власне / дорадче |
| risk class | Найгірше, до чого воно може дотягнутися? | лише читання · запис у репозиторій · зміна у віддаленій системі · платне або незворотне |
| lowest level | Який виконавець може його запускати? | дешева модель · середня · старша · людина |
| needs a person | Чи мусить людина схвалити, перш ніж воно подіє? | так / ні |
| owner | Хто відповідає, коли воно зламалося? | ім'я, а не псевдонім команди |
🧭 Політика в шести рядках
- Кожна AI-можливість у використанні має рядок у реєстрі, перш ніж почне працювати з реальними задачами.
- Зовнішня порада (інструкція постачальника, шаблон, знайдений у мережі) позначена як дорадча і ніколи не може стати обов'язковим правилом.
- Можливість, яка змінює віддалену систему або торкається грошей чи чогось незворотного, завжди потребує названої людини, яка схвалює кожне використання.
- Дійова можливість такого типу не може працювати на найдешевшому виконавці.
- Правило, яке лише описує, як працювати, діє на кожному рівні, зокрема для скриптів без моделі.
- Реєстр перевіряє тест. Можливість, що існує на диску без рядка, валить збірку.
🛠️ Практика: збудуйте реєстр приблизно за 30 хвилин
- Перелічіть кожну AI-можливість, яку ваша команда використовує сьогодні. Шукайте в трьох місцях: репозиторій (файли промптів, конфігурації агентів), налаштування редактора і задачі за розкладом. Запишіть по одному рядку на кожну.
- Для кожного рядка заповніть сім полів. Коли двоє розходяться в оцінці класу ризику, беріть вищий.
- Позначте кожен рядок, який змінює щось поза вашим репозиторієм, як потрібна людина. Про винятки поки не сперечайтеся.
- Збережіть рядки одним файлом YAML або CSV,
ai-register.yaml, у корені репозиторію. - Напишіть тест, який читає файл і валиться на чотирьох речах: відсутнє обов'язкове поле, повторюваний id, рядок із зовнішньою порадою, позначений як обов'язкове правило, і файл можливості в репозиторії без рядка.
- Запустіть тест. Виправте те, що він знайшов. Закомітьте реєстр і тест разом.
✅ Перевірте себе
- Виберіть навмання одну можливість і дайте відповідь на сім питань лише за файлом, ні в кого не питаючи.
- Додайте порожній файл можливості без рядка. Тест валиться і називає цей файл.
- Позначте рядок зі зміною у віддаленій системі як людина не потрібна. Тест валиться і називає цей рядок.
- Нова людина за дві хвилини скаже, які можливості можуть діяти без схвалення.
🚧 Коли це не працює
- Реєстр описує те, що ви задекларували, а не те, що використовується. Людина, яка вставляє промпт в інструмент, якого ви не внесли, обходить його. Тест бачить лише файли, які ви відстежуєте.
- Команда з однієї людини без спільного репозиторію. Тестові нема чого охороняти. Короткий письмовий перелік усе одно варто мати, але він не завадить вам про нього забути.
- Можливості, що живуть усередині хостованого інструмента, який ви не можете оглянути. Ви можете внести до реєстру підключення та його дозволи, але не внутрішню поведінку постачальника.
- Реєстр, який ніхто не переглядає, дрейфує. Якщо рядків не торкалися квартал, вважайте реєстр застарілим і повторіть крок 1.
- Імітація політики. Шість правил без тесту й без власника нічого не змінюють. Якщо ви не можете написати тест, скоротіть політику, доки зможете.
📊 Докази
Ми тримаємо цей реєстр для власних навичок агентів. Станом на 3 листопада 2026 (UTC) у ньому було 32 рядки: 17 лише читання, 6 запису в репозиторій, 6 змін у віддалених системах і 3, пов'язані з грошима; 12 потребують рішення людини; 24 діють, а 8 — правила, що лише описують, як працювати. Сім тестів, що його охороняють, пройшли того самого дня. Серед іншого вони перевіряють схему й унікальність id, що зовнішня порада ніколи не позначена як обов'язкова, що рядки зі змінами у віддалених системах і з грошима потребують людини і, коли діють, виконуються на середньому рівні або вище, що правила походять з нашої власної влади, і що файли на диску та рядки збігаються в обидва боки.
| Що ми виміряли | Рядки за класом ризику та за потребою в людині у нашому власному реєстрі |
| Коли | 3 листопада 2026, 21:17 UTC |
| Артефакт | Наш реєстр навичок і його тестовий файл у нашому приватному репозиторії (пройшло 7 тестів) |
| Обмеження | Він рахує те, що ми задекларували. Він не показує, як часто кожна можливість запускалася, і нічого не каже про вашу команду |
➡️ Далі
Коли реєстр існує, вирішіть, що робити, якщо агент усе одно помилиться: Пам'ятка дій при інциденті з AI для малої команди. Щоб побачити, що квитанція доводить про запуск, прочитайте Квитанції задач агента.
Джерела
- Дозволи та потік даних: до чого агент може дотягнутися і що виходить із вашої машини.
- Оцінювання AI: чому «воно каже, що готово» — не приймання: приймання через перевірки.
- Розробка через специфікації з наявними пакетами задач: передача роботи з критеріями приймання.
- Витрати, бюджети та ліміти: як задати бюджет на задачу.
🔗 Зв'язки статті
Відкрити повний граф знань ↗Зв’язки опублікованих статей. Виберіть вузол, щоб відкрити статтю біля заголовка.
Зв’язки статей · клавіатура / текст
Та сама тема
- Векторна база — це мапа, а не джерело: що ми з'ясували про пошук
- Коли невідомо, скільки коштував виклик моделі: заморожування, потім звіряння
- Розбиття великого завдання для дешевої моделі: урок про 24 000 байтів
- Навички, інструменти MCP і правила: три способи дати агенту можливості
- Вісім помилок з shell і git, яких припускалися наші агенти, і правило для кожної
- Кілька агентів, один репозиторій: правила володіння з реальних інцидентів
Наступні кроки
Пов'язані матеріали
Векторна база — це мапа, а не джерело: що ми з'ясували про пошук
Векторна база знаходить уривки, близькі за змістом до вашого запиту. Вона не знає, які з них правдиві чи актуальні. Сприймайте кожен результат як вказівник: відкрийте названий файл, перевірте хеш і беріть числа з артефакту, а не зі знайденого абзацу.
AI agents and MCP explainedКоли невідомо, скільки коштував виклик моделі: заморожування, потім звіряння
Іноді виклик моделі перевищує час очікування, і ви не знаєте, чи провайдер списав кошти. Ніколи не записуйте це як нуль. Позначте витрату як непевну, зупиніть нові платні виклики й доручте названій людині звірити її з випискою провайдера. Виняток — відмови, що сталися до генерації.
AI agents and MCP explainedРозбиття великого завдання для дешевої моделі: урок про 24 000 байтів
Дешева модель добре дає раду з однією невеликою чітко окресленою роботою, але погано з великим нагромадженням. Ми обмежуємо завдання 24 000 байтами і відмовляємо більшим ще до виклику моделі. Діліть на одиниці — один файл або одна країна на завдання — і перевіряйте розмір до початку.
AI agents and MCP explainedНавички, інструменти MCP і правила: три способи дати агенту можливості
Агенти отримують можливості по-різному. Правило обмежує те, що вони роблять, навичка підказує, як виконати роботу, а інструмент MCP дозволяє викликати функцію. Кожен із трьох має власний ризик, тож фіксуйте всі три в реєстрі й перевіряйте тестом, що нічого не існує поза ним.
💬 Коментарі