У Гоголя так описан молодой чиновник, которому нравится распутывать сложное дело и объяснять его ясно. Он радуется, когда удаётся поймать нужные нити. Для своего первого помощника возьмём дело поменьше: выяснить время встречи по короткому файлу. Зато пройдём весь путь до сохранённой настройки.
Допустим, вы собираете вечер настольных игр. Коробка уже на столе, а в переписке снова спрашивают, когда приходить. Время есть в заметке, про ведущего ещё не договорились. Дадим помощнику эту маленькую разницу: одно известно, другое пока отсутствует. Начнём с файла, в котором легко найти каждую строку, и двух вопросов к нему.
В конце у вас останутся исходный текст, сохранённый агент и запись о его настройках. Пока вся работа идёт в консоли AI Studio. Подключать сайт или мессенджер для этого результата не понадобится.
Как устроен ИИ-агент в Яндексе на нашем примере
Нам нужны три вещи. Файл содержит сведения о встрече. Поисковый индекс позволяет находить в нём нужное. Агент получает вопрос, использует поиск и формулирует ответ. Текстовая модель делает языковую работу, инструкция задаёт ей способ отвечать, а File search даёт инструмент для обращения к подготовленному материалу.
Представьте папку на столе организатора: на одном листе время и правило входа. Вопрос «Когда встреча?» ведёт к строке со временем. А для вопроса о ведущем строка пока пустует. Хороший результат во второй ситуации выглядит скромно: помощник сообщает, что имени в базе нет. Благодаря этому понятно, что ещё нужно решить самим организаторам.
Путь рассчитан на уже подготовленный доступ к AI Studio: существующие организация, облако и каталог, связанный платёжный аккаунт со статусом ACTIVE или TRIAL_ACTIVE. У сервиса свои правила оплаты и лимиты; тестовые обращения оплачиваются как вызовы модели. Перед работой проверьте доступные средства, актуальную стоимость и лимиты своего аккаунта на странице Яндекса. Здесь используем вымышленные сведения: файл и вопросы отправляются в облачный сервис.
Для файлов и индексов нужны роли ai.playground.user и ai.assistants.editor или выше, для агента — ai.canvasAgents.editor или выше. Если роль отсутствует, её назначает администратор вашего каталога. Права на публикацию в каналах относятся к отдельному следующему действию; в нашем пути оно не требуется.
Сначала файл, который легко проверить
В обычном текстовом редакторе создайте файл rules.txt в UTF-8. Вставьте ровно этот текст:
Правила встречи клуба настольных игр.
Встреча состоится 6 октября в 18:00.
Вход по записи.Это дата из нашего примера, а не объявление о ближайшем событии. Год, адрес, имя ведущего и способ записи мы не добавляли. Файл должен сохранить именно имеющиеся сведения: позже будет понятно, откуда взялся ответ. Проверьте, что редактор не приписал к имени лишнее расширение вроде rules.txt.txt.
Если на первом шаге трудно разобраться с программой, можно попросить DeepSeek сопровождать вас текстом:
Хочу сделать файл rules.txt для учебного агента в Yandex AI Studio. В нём будут три строки про встречу настольных игр. Уточни мою систему и редактор, затем помоги сохранить обычный текст в UTF-8. Давай одно действие: что открыть, куда вставить текст, что должно получиться. Жди моего ответа. Позже помоги понять непонятный шаг консоли по моему описанию; путь, который зависит от текущего интерфейса, сверяй с официальной справкой, если доступен поиск.
Для дальнейших шагов опирайтесь на названия полей и результат у себя в окне. Помощнику достаточно описания; пароли, ключи и содержимое чужих документов для объяснения не нужны.
Создать поисковый индекс и дождаться готовности
Откройте интерфейс Yandex AI Studio и выберите свой каталог. На панели слева разверните AI Search, затем откройте Поисковые индексы и нажмите Создать поисковый индекс. Задайте имя, например Правила встречи.
Нажмите Загрузить, выберите rules.txt и затем Создать. Теперь дождитесь, когда у индекса появится статус Готов. Смысл этого ожидания простой: файл должен стать материалом для поиска. Само появление имени файла ещё не означает, что обработка завершилась.
Путь создания индекса показан схематически. Переходим к агенту после готовности именно нашего индекса.
Если статус не становится готовым, посмотрите, нет ли сообщения об ошибке обработки. Сверьте, что загрузили обычный текст, и откройте исходный файл у себя: три строки должны читаться правильно. При обращении к помощнику передайте название шага и обезличенный текст ошибки. Повторная загрузка наугад мало помогает понять причину.
Зафиксируйте имя созданного индекса. Оно пригодится в следующем выборе: в каталоге могут быть и другие базы, а мы хотим проверять именно эти три строки. В документации о поисковых индексах описаны поддерживаемые файлы и готовность к использованию.
Подключить файл к агенту
Основной путь ниже соответствует быстрому старту Agent Atelier. На панели слева откройте Agent Atelier → Агенты → Создать агента. Если раздел у вас назван Текстовые агенты, сверяйтесь также с вариантом формы, который приведён чуть ниже.
Для имени используйте game-meeting-helper, для описания — «Ответы по правилам встречи настольных игр». В поле Модель выберите доступную текстовую модель и запишите её название. Теперь в поле Инструкция вставьте:
Помогай разобраться в правилах встречи настольных игр.
Перед ответом на вопрос о встрече ищи сведения в подключённой базе знаний.
Отвечай только по найденным сведениям. Не добавляй детали по догадке.
Если ответа в базе нет, прямо сообщи, что таких сведений в базе нет.
Для времени встречи сохраняй дату и время из источника.В разделе Инструменты нажмите Добавить, выберите File search и укажите индекс Правила встречи. Название инструмента означает поиск по файлам. Сама инструкция «смотри в базу» ещё не подключает файл — в настройке должен быть выбран нужный индекс.
Инструкция задаёт способ ответа, а подключённый инструмент даёт доступ к поисковому материалу.
Если у вас форма с сохранением версии
В подробной инструкции создания агента Яндекс описывает другой вариант интерфейса. В разделе Текстовые агенты после Создать агента сначала вводят имя и описание и нажимают Создать. Затем открывается конфигурация версии: там выбирают модель, наш индекс в поле Поисковые индексы и добавляют инструкцию. После этого нажимают Сохранить версию, а тестируют в форме справа.
Это тот же результат: агент настроен на выбранный индекс. Если индекс выбирается отдельным полем, не ищите обязательную вторую кнопку File search в списке других инструментов. Дальше выполните те же две проверки. В варианте быстрого старта финальное Создать нажмём после тестирования; в форме версий конфигурация уже сохраняется своей кнопкой.
Два вопроса, на которых видно работу
В форме тестирования задайте «Когда встреча?». Сверьте ответ с rules.txt: в нём указаны 6 октября и 18:00. Формулировка может отличаться, но обе части должны сохраниться. Если вместо времени пришло только «скоро» или «вечером», попросите назвать точные дату и время по базе и ещё раз проверьте настройку поиска.
Теперь задайте «Кто ведёт встречу?». Нужная реакция — сообщить, что в базе нет таких сведений. Если в ответе возникнет «наш опытный ведущий», которого в файле нет, за игровым столом только что появилось лишнее кресло. Пока пустое, зато уже с должностью. Верните помощника к инструкции: сведений об этом человеке в базе нет. Нам важно увидеть, что он способен остановиться на границе своего материала.
| Вопрос | Что есть в rules.txt | Что хотим увидеть в ответе |
|---|---|---|
| Когда встреча? | 6 октября в 18:00 | Обе части: дата и время |
| Кто ведёт встречу? | Имя не указано | Сообщение, что таких сведений в базе нет |
Ожидаемые ответы для проверки агента: сверяйте с ними результат в своей форме.
Посмотрите и на сведения об обработке ответа, которые показывает ваша форма: был ли вызван поиск по файлам и к какому индексу он обращался. Красивый текст сам по себе не позволяет понять, нашёл ли агент строку в нужной базе. Если вызов инструмента не виден, проверьте доступные сведения теста и настройку индекса; отсутствие отображения не записывайте как подтверждённый поиск.
Предположим, вместо даты помощник ответил про время открытия другой площадки. Начните с выбранного источника: что он вообще мог найти? Когда ответ расходится с файлом, полезно разделить два случая. Не тот материал: выбран другой индекс, наш ещё не готов или нужный файл в нём отсутствует. Материал тот, ответ неточен: пересмотрите инструкцию, повторите вопрос и сравните фактические слова с исходником. Так вы меняете конкретную причину, вместо того чтобы за один раз переставлять все настройки.
Если хотите дополнительно проверить вход по записи, спросите об этом. В файле такая строка есть. А вот «Где записаться?» относится к отсутствующим сведениям: адреса или ссылки мы не дали. Это удобное различие между самим правилом и способом его выполнения.
Сохранить агента и запись о настройке
В варианте быстрого старта после проверки нажмите завершающее Создать. Это отдельное действие после открытия формы Создать агента. В форме конфигурации версии сохранение выполнено кнопкой Сохранить версию; если меняли параметры после теста, сохраните актуальное изменение и проверьте его снова.
Откройте сохранённого агента и убедитесь, что у него остались нужные модель, инструкция и индекс. В соседней заметке запишите имя агента, название модели, индекс, показанную версию и оба фактических ответа. Рядом оставьте rules.txt и ожидаемые реакции из таблицы. Завтра вы сможете открыть помощника и увидеть, что именно проверили сегодня. А когда поменяете инструкцию, у вас будет с чем сравнить новый результат.
По описанию текстовых агентов Яндекса, каждое сохранение изменений в Agent Atelier создаёт новую версию. Поэтому после правки инструкции отмечайте, какую конфигурацию вы проверяли. Старая удачная проверка не рассказывает о новом варианте, если в нём поменялись модель, файл или инструмент.
Наш ИИ-агент в Яндексе теперь имеет маленькую, но законченную работу: обратиться к своим сведениям и ответить на вопросы встречи. Два теста относятся именно к этому примеру. Когда появятся другие материалы, для них понадобятся свои известные и отсутствующие факты — зато способ сравнения у вас уже есть.
Вопросы и ответы о создании агента
Почему обычной инструкции недостаточно?
Инструкция сообщает, как отвечать. Поисковый индекс и его подключение дают материал, к которому агент обращается. Проверьте обе части: просьбу искать в базе и выбранный источник поиска.
Нужно ли сразу подключать Telegram или сайт?
Для сохранения и проверки агента достаточно консоли. Публикация в канале — следующий самостоятельный сценарий, со своими правами и настройками. Начать можно с вопросов в форме тестирования.
Почему помощник не называет ведущего?
Мы намеренно оставили файл без этого факта. Сообщение об отсутствии сведений в таком случае соответствует задаче. Когда захотите получать имя, добавьте достоверные сведения в базу и отдельно проверьте обновлённую настройку.
Можно ли взять свой настоящий документ?
После знакомства с методом выберите материал, который вправе отправить в облачный сервис. Для первой попытки достаточно приведённых трёх вымышленных строк: по ним легко заметить ошибку и понять роль поиска.
У маленького помощника появилось своё дело
Дальше интересно развивать уже свою задумку: помощника по правилам кружка, заметкам проекта или небольшой коллекции инструкций. Практика агентов в «Первопроходцах» знакомит с направлением и условиями участия. В клубе можно учиться постепенно, задавать вопросы и улучшать проект; раз в две недели проходят эфиры, Никита лично проверяет проектные работы. Путь к участию — на странице клуба.
Если следующим делом станет цепочка внешних действий, пригодится разбор ИИ-агента в n8n. А сейчас оставим нашему помощнику свою папку: время в ней есть, ведущего пока нет. На стол можно поставить игру и позвать настоящих участников. Лишнее кресло для выдуманного распорядителя нам уже не понадобится.