Термины

Слова, которые встречаются в дашборде и в этой документации

Слова расставлены по тому, что на что опирается. Заучивать заранее ничего не нужно — возвращайтесь, когда слово начнёт мешать.

Агент и из чего он состоит

Агент — постоянная сущность: своя модель, свои инструкции, свои доступы, свой канал связи. Он существует независимо от того, разговаривает ли с ним кто-то прямо сейчас. Ему можно написать, и он сам может запуститься по событию.

Навык — описание того, как агент должен выполнять свою работу. Навык описывает работу, но не расширяет доступ. Очень часто навыку нужны инструменты, которые предоставляются коннектором.

Модель — в нашем контексте LLM-модель, нейросеть, обученная на массиве данных; программа, которая генерирует контент. Именно модель получает сообщения от пользователя и решает, что ответить или каким инструментом воспользоваться. Доступ к моделям предоставляется LLM-провайдерами.

Токен — единица, которой модель меряет текст: и то, что ей отправили, и то, что она ответила. Расход считается по каждому прогону и каждой модели и виден в журнале. Платите вы своему LLM-провайдеру по его тарифу. С ключами и токенами сессии это слово не связано.

Чем агент дотягивается до внешнего мира

Коннектор — единственная точка, в которой платформа расширяется, а агенты получают дополнительные возможности. Одна интеграция приносит инструменты, триггеры, блоки промпта и повторяемые задачи. Например, коннектор Почта.

Подключение — экземпляр коннектора с вашими учётными данными. Коннектор описывает, что умеет интеграция, подключение говорит, от чьего имени. Например, подключение к определённому почтовому ящику.

Инструмент (в интерфейсе — тул) — команда или инструкция на коннекторе, которую может вызвать агент. Например, отправить сообщение, прочитать таблицу, поставить задачу. У одного подключения может быть множество инструментов.

Триггер — событие, от которого запускается агент: входящее сообщение, наступивший срок, изменение в сервисе. Именно благодаря триггерам все агенты проактивны. Благодаря им агенты сравнимы с самостоятельными коллегами по работе и могут автоматизировать вашу рутину и даже сделать работу за вас.

Канал — это то, через что агент взаимодействует с вами. Это может быть как встроенный чат, так и подключённый через коннектор Telegram-бот.

Приложение — программа-компаньон на вашем устройстве, зарегистрированная ключом: десктопный клиент, телефон или браузер. Подключившись, она приносит агенту свои инструменты и триггеры. Прямого доступа к машине у агента всё ещё нет — всё ограничено возможностями приложения.

Кому что разрешено

Учётные данные подключения хранятся на платформе зашифрованными и в модель не попадают: агент называет инструмент, а ключ подставляется за пределами модели. Ключ LLM-провайдера нужен, чтобы обратиться к самой модели и запустить агента на её основе.

Политика — разрешение или запрет на отдельный инструмент или триггер внутри подключения. Проверяется до обращения к внешнему сервису или перед обращением к агенту.

Подключение, которое вы не открыли конкретному агенту, для него не существует. Открытое разрешено целиком — все его тулы и триггеры, пока политика не запретит лишнее.

Что остаётся после работы

Прогон — одна обработка одного события: от триггера или сообщения до ответа. Шаг — одна ступень внутри прогона: обращение к модели или вызов инструмента с параметрами и результатом.

Сессия — разговор с агентом, чем бы он ни вёлся: вкладкой чата, мессенджером, IDE. Обычно одна сессия — отдельная тема разговора с агентом.

Журнал — прогоны, шаги и вызовы, которые можно открыть и прочитать: что агент сделал, с какими параметрами и что ответил сервис.

Когда агентов больше одного

Агентная команда — несколько агентов над общей доской задач, где видно, кто что взял.