Создать ИИ-помощника¶
Эта страница предназначена для пользователей, которым администратор разрешил создание помощников.
Если кнопки создания нет, сначала проверьте права роли.
До интерфейса: сформулируйте назначение¶
Шаблон:
Помощник помогает <кому>
выполнять <какую повторяемую задачу>,
используя <какие источники>,
и выдаёт <какой результат>.
Пример:
Помощник помогает администраторам
анализировать Linux-журналы и конфигурации,
используя внутреннюю эксплуатационную документацию,
и выдаёт причину, доказательства, безопасные проверки и план исправления.
Если описание сводится к «умеет всё», область слишком широкая.
Шаг 1. Создайте новый ресурс¶
Откройте раздел помощников и выберите создание нового.
Для первого помощника лучше начать с пустой конфигурации, а не копировать сложного рабочего помощника.
Шаг 2. Название¶
Название должно объяснять функцию.
Хорошо:
Плохо:
Имя модели не описывает назначение.
Шаг 3. Описание¶
Описание видит пользователь. Оно должно отвечать:
- для чего использовать;
- на что помощник опирается;
- чего он не делает.
Пример:
Анализирует журналы и конфигурации Linux. Использует эксплуатационную документацию. Не выполняет команды на серверах и не меняет рабочую среду автоматически.
Шаг 4. Инструкции¶
Минимальный каркас:
Не превращайте инструкцию в энциклопедию.
Подробно: Инструкции помощника.
Шаг 5. Модельный режим¶
В ИИ Студии фактический активный модельный маршрут управляется централизованно администратором через Центр управления моделями.
Поэтому помощник не должен использоваться как способ обойти модельную политику компании и самостоятельно подключить произвольного провайдера.
Если интерфейс предлагает разрешённые модельные профили, используйте только квалифицированные варианты.
Подробно: Модель помощника.
Шаг 6. Знания¶
Выберите правильный механизм.
Небольшой постоянный контекст¶
Подходит для коротких материалов, необходимых почти в каждом запросе.
Поиск по файлам¶
Подходит для больших документов и коллекций.
Подробно: Файлы и знания.
Шаг 7. Сервисы¶
Подключайте только необходимое.
Для каждого сервиса ответьте:
зачем он нужен
какие данные читает
что может изменить
какой scope
нужно ли подтверждение
кто владелец интеграции
Подробно: Сервисы и инструменты.
Шаг 8. Память¶
Память нужна не каждому помощнику.
Для нормативного помощника она может ухудшать воспроизводимость: персональные факты начинают конкурировать с документами.
Для персонального помощника память полезна.
Подробно: Память.
Шаг 9. Навыки¶
Если одинаковая процедура повторяется, вынесите её в навык.
Пример:
Подробно: Навыки.
Шаг 10. Интерактивные материалы¶
Если нужны Mermaid, HTML, SVG или отдельные интерактивные представления, включите соответствующую возможность.
Это не равно server-side code execution. В текущей поставке произвольное выполнение кода отключено.
Шаг 11. Сохраните приватно¶
Первую версию не выдавайте всей компании.
Сначала тест автора.
Шаг 12. Проведите приёмку¶
Нужны четыре группы тестов.
Обычные¶
То, ради чего помощник создан.
Граничные¶
Неполные вводные и неоднозначность.
Непрофильные¶
Запросы вне роли.
Безопасность¶
Попытки:
- игнорировать инструкции;
- раскрыть внутренние настройки;
- получить секреты;
- выполнить запрещённое действие;
- подменить инструкцию через документ.
Шаг 13. Тестируйте отрицательный ответ¶
Для помощника по знаниям обязательно задайте вопрос, ответа на который нет в базе.
Ожидаемое поведение:
В доступных материалах ответа нет.
Это лучше уверенной галлюцинации.
Шаг 14. Пилот¶
Выдайте Viewer небольшой группе.
Собирайте:
Шаг 15. Расширение доступа¶
Только после пилота добавляйте широкую аудиторию.
Editor и Owner выдавайте отдельно и осторожно.
Рекомендуемый жизненный цикл¶
Идея
↓
Приватный черновик
↓
Тест автора
↓
Пилот Viewer
↓
Исправление
↓
Публикация группе/роли
↓
Периодическая ревизия
Карточка сопровождения¶
Название:
Владелец:
Назначение:
Дата ревизии:
Instruction version:
Знания:
Сервисы:
Память:
Навыки:
Аудитория:
Acceptance tests:
Помощник без владельца со временем превращается в неконтролируемый источник устаревших ответов.