Tvijo wiki
Каталог

Теми

Політика використання AI та реєстр, який мала команда здатна втримувати

Політика використання AI каже людям, що їм дозволено. Реєстр показує, що кожна AI-можливість у вашій команді може робити, хто її запускає і коли потрібне схвалення людини. Тримайте його одним файлом у репозиторії, і нехай тест валить збірку, коли в можливості немає рядка.

🎯 Для Тімлід або розробник, який керує AI-агентами у спільній роботі

📚 Ви дізнаєтеся
  • Що належить до реєстру AI і що мусить казати політика використання в шести рядках
  • Як збудувати реєстр приблизно за 30 хвилин і захистити його тестом
  • Де реєстр перестає допомагати

📋 Що таке реєстр і чому самої політики не досить

Політика використання каже, що люди можуть робити з AI. Реєстр каже, що кожна AI-можливість у вашій команді насправді має право робити, хто може її запустити і коли рішення ухвалює людина. Без реєстру політика — це побажання: ніхто не скаже конкретного вівторка, який агент може змінювати файли, який може писати в систему замовника, а який лише читає.

Реєстр — це звичайний файл у вашому репозиторії. Один рядок на можливість: роль агента, бібліотека промптів, конектор, задача за розкладом. Кожен рядок відповідає на ті самі сім питань, тож рецензент прочитає сорок рядків за десять хвилин.

Поле Питання, на яке відповідає Приклад значення
id Як воно називається? release-notes-writer
purpose Правило чи дія: воно лише описує, як працювати, чи діє? правило / діє
authority Це наше власне правило чи зовнішня порада, яку можна проігнорувати? власне / дорадче
risk class Найгірше, до чого воно може дотягнутися? лише читання · запис у репозиторій · зміна у віддаленій системі · платне або незворотне
lowest level Який виконавець може його запускати? дешева модель · середня · старша · людина
needs a person Чи мусить людина схвалити, перш ніж воно подіє? так / ні
owner Хто відповідає, коли воно зламалося? ім'я, а не псевдонім команди

🧭 Політика в шести рядках

  1. Кожна AI-можливість у використанні має рядок у реєстрі, перш ніж почне працювати з реальними задачами.
  2. Зовнішня порада (інструкція постачальника, шаблон, знайдений у мережі) позначена як дорадча і ніколи не може стати обов'язковим правилом.
  3. Можливість, яка змінює віддалену систему або торкається грошей чи чогось незворотного, завжди потребує названої людини, яка схвалює кожне використання.
  4. Дійова можливість такого типу не може працювати на найдешевшому виконавці.
  5. Правило, яке лише описує, як працювати, діє на кожному рівні, зокрема для скриптів без моделі.
  6. Реєстр перевіряє тест. Можливість, що існує на диску без рядка, валить збірку.

🛠️ Практика: збудуйте реєстр приблизно за 30 хвилин

  1. Перелічіть кожну AI-можливість, яку ваша команда використовує сьогодні. Шукайте в трьох місцях: репозиторій (файли промптів, конфігурації агентів), налаштування редактора і задачі за розкладом. Запишіть по одному рядку на кожну.
  2. Для кожного рядка заповніть сім полів. Коли двоє розходяться в оцінці класу ризику, беріть вищий.
  3. Позначте кожен рядок, який змінює щось поза вашим репозиторієм, як потрібна людина. Про винятки поки не сперечайтеся.
  4. Збережіть рядки одним файлом YAML або CSV, ai-register.yaml, у корені репозиторію.
  5. Напишіть тест, який читає файл і валиться на чотирьох речах: відсутнє обов'язкове поле, повторюваний id, рядок із зовнішньою порадою, позначений як обов'язкове правило, і файл можливості в репозиторії без рядка.
  6. Запустіть тест. Виправте те, що він знайшов. Закомітьте реєстр і тест разом.

✅ Перевірте себе

  • Виберіть навмання одну можливість і дайте відповідь на сім питань лише за файлом, ні в кого не питаючи.
  • Додайте порожній файл можливості без рядка. Тест валиться і називає цей файл.
  • Позначте рядок зі зміною у віддаленій системі як людина не потрібна. Тест валиться і називає цей рядок.
  • Нова людина за дві хвилини скаже, які можливості можуть діяти без схвалення.

🚧 Коли це не працює

  • Реєстр описує те, що ви задекларували, а не те, що використовується. Людина, яка вставляє промпт в інструмент, якого ви не внесли, обходить його. Тест бачить лише файли, які ви відстежуєте.
  • Команда з однієї людини без спільного репозиторію. Тестові нема чого охороняти. Короткий письмовий перелік усе одно варто мати, але він не завадить вам про нього забути.
  • Можливості, що живуть усередині хостованого інструмента, який ви не можете оглянути. Ви можете внести до реєстру підключення та його дозволи, але не внутрішню поведінку постачальника.
  • Реєстр, який ніхто не переглядає, дрейфує. Якщо рядків не торкалися квартал, вважайте реєстр застарілим і повторіть крок 1.
  • Імітація політики. Шість правил без тесту й без власника нічого не змінюють. Якщо ви не можете написати тест, скоротіть політику, доки зможете.

📊 Докази

Ми тримаємо цей реєстр для власних навичок агентів. Станом на 3 листопада 2026 (UTC) у ньому було 32 рядки: 17 лише читання, 6 запису в репозиторій, 6 змін у віддалених системах і 3, пов'язані з грошима; 12 потребують рішення людини; 24 діють, а 8 — правила, що лише описують, як працювати. Сім тестів, що його охороняють, пройшли того самого дня. Серед іншого вони перевіряють схему й унікальність id, що зовнішня порада ніколи не позначена як обов'язкова, що рядки зі змінами у віддалених системах і з грошима потребують людини і, коли діють, виконуються на середньому рівні або вище, що правила походять з нашої власної влади, і що файли на диску та рядки збігаються в обидва боки.

Що ми виміряли Рядки за класом ризику та за потребою в людині у нашому власному реєстрі
Коли 3 листопада 2026, 21:17 UTC
Артефакт Наш реєстр навичок і його тестовий файл у нашому приватному репозиторії (пройшло 7 тестів)
Обмеження Він рахує те, що ми задекларували. Він не показує, як часто кожна можливість запускалася, і нічого не каже про вашу команду

➡️ Далі

Коли реєстр існує, вирішіть, що робити, якщо агент усе одно помилиться: Пам'ятка дій при інциденті з AI для малої команди. Щоб побачити, що квитанція доводить про запуск, прочитайте Квитанції задач агента.

Джерела

Зв’язки опублікованих статей. Виберіть вузол, щоб відкрити статтю біля заголовка.

100%
→ Пов'язані статті← Посилаються сюди⋯ Та сама тема
Зв’язки статей · клавіатура / текст

💬 Коментарі

Коментарі публічні та модеруються. Не публікуйте персональні дані.
  • Коментарів ще немає. Будьте першим!

Наступні кроки

AI agents and MCP explained

Векторна база — це мапа, а не джерело: що ми з'ясували про пошук

Векторна база знаходить уривки, близькі за змістом до вашого запиту. Вона не знає, які з них правдиві чи актуальні. Сприймайте кожен результат як вказівник: відкрийте названий файл, перевірте хеш і беріть числа з артефакту, а не зі знайденого абзацу.

AI agents and MCP explained

Коли невідомо, скільки коштував виклик моделі: заморожування, потім звіряння

Іноді виклик моделі перевищує час очікування, і ви не знаєте, чи провайдер списав кошти. Ніколи не записуйте це як нуль. Позначте витрату як непевну, зупиніть нові платні виклики й доручте названій людині звірити її з випискою провайдера. Виняток — відмови, що сталися до генерації.

AI agents and MCP explained

Розбиття великого завдання для дешевої моделі: урок про 24 000 байтів

Дешева модель добре дає раду з однією невеликою чітко окресленою роботою, але погано з великим нагромадженням. Ми обмежуємо завдання 24 000 байтами і відмовляємо більшим ще до виклику моделі. Діліть на одиниці — один файл або одна країна на завдання — і перевіряйте розмір до початку.

AI agents and MCP explained

Навички, інструменти MCP і правила: три способи дати агенту можливості

Агенти отримують можливості по-різному. Правило обмежує те, що вони роблять, навичка підказує, як виконати роботу, а інструмент MCP дозволяє викликати функцію. Кожен із трьох має власний ризик, тож фіксуйте всі три в реєстрі й перевіряйте тестом, що нічого не існує поза ним.