Агенты

Агент — это роль воркспейса, а не аккаунт и не место в тарифе. Две есть с первого дня — Продакт и Аналитик, — воркспейс может завести свои. У них нет ни пароля, ни токена, ни собственного доступа: они видят то же, что видит позвавший человек, и меньше.

Зовут агента так же, как коллегу: по имени, в той ветке, где уже стоит вопрос. Он читает задачу и либо отвечает в ветке, либо выкладывает вам решение — вопрос с вариантами, на который отвечаете вы. Или не отвечаете.

Агент не принимает решение. Его предложение записывается вопросом к вам, а в задаче остаётся, кто выбрал и что именно. Предложение, на которое никто не ответил, так и останется без ответа: у резолюции нет варианта по умолчанию, поэтому молчание ничего не решает.

1. Напишите комментарий в задаче и упомяните роль: @product — подсказка предлагает агентов воркспейса отдельным разделом, под людьми.
2. Комментарий публикуется от вашего имени. Строка под ним говорит, что агент позван и работает.
3. Ответ приходит в ту же ветку — комментарием без собственного автора: он подписан ролью и тем, кто её позвал.

• Упоминание внутри кода или блока кода — это текст, а не вызов.
• Агенты не зовут агентов. Упоминание в словах самого агента не зовёт никого: на вопрос «от чьего имени» у цепочки нет честного ответа, поэтому такой ситуации просто не бывает.
• Один и тот же вопрос можно задать двум ролям сразу — каждая отвечает сама по себе, и в ветке видно, где чей ответ.
• Вызов можно отозвать, пока он в очереди или в работе.

Вся конструкция держится на одной фразе: агент не может ничего, чего не можете вы. Это не обещание в подсказке модели, а то, откуда код берёт права.

• Он работает как вы, и ваши права спрашиваются заново в момент работы, а не такими, какими были при написании комментария. За человека, потерявшего доступ к проекту в промежутке, не сделают ничего.
• Он заперт в проекте этой задачи. Связанная задача из другого проекта видна ему только ключом — вопрос про один проект не отправляет модели остальные девять.
• Его инструменты — только чтение, по закрытому списку. Инструмента записи, на который его можно было бы уговорить, не существует.
• Комментарий, предложение и строку журнала пишет Kaiku по структурированному ответу агента — сама модель в ваш воркспейс не пишет.
• Каждый вызов — строка: кто какую роль позвал, в какой задаче, чем кончилось и сколько стоило. Владелец и админы воркспейса видят все, остальные — свои.

К ответу приложен список того, что было прочитано на самом деле, — задачи и страницы, которые вернули инструменты. Рассуждение можно сверить с источниками, а не принимать на веру. У предложения тот же список плюс довод за предложенные варианты.

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

Если вызов отклонён, в ветку ничего не пишется, а в отказе сказано, что именно:

• agent_unknown — роли с таким именем в этом воркспейсе нет.
• agent_off — роль выключена администратором.
• agent_plan — в тарифе нет ИИ.
• agent_budget — лимит воркспейса на агентов пока исчерпан.
• agent_user_budget — исчерпан ваш личный лимит.
• agent_credit — на тарифе со своим ключом: ключа нет или его не приняли.
• agent_unpaid — счёт воркспейса не оплачен, ИИ остановлен до оплаты.
• too_many — слишком много вызовов сразу на одной задаче.

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

Настройки → Агенты, для владельца и администраторов воркспейса: переключатель на каждую роль, правила, которые роль несёт с собой, и расход по всем. Остальные видят там свои вызовы.

• Роль можно выключить, не выключая саму возможность.
• Правила — это обычный текст, который роль несёт в каждый вызов: что всегда оставлять человеку, чего не обещать, насколько подробно отвечать.
• Лимит — на воркспейс, и его можно разделить по людям, чтобы один увлёкшийся читатель не израсходовал месяц.
• Сколько стоил вызов — видно на вызове, итоги — в журнале.

Что такое лимит и что бывает, когда период не оплачен, — на странице Оплата и режим чтения.

Ваш собственный агент может позвать этого — инструментами собственного MCP-сервера Kaiku:

• ask_agent — это ровно комментарий [~agent:<роль>] <текст>, написанный вами: комментарий публикуется, вызов встаёт в очередь, ответ приходит в ветку.
• get_agent_request — что с этим вызовом, что он прочитал и сколько стоил.
• list_agent_requests — вызовы, новые сверху; по умолчанию свои.
• cancel_agent_request — отозвать, пока он в очереди или в работе.

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