Что агент умеет

Инструменты делятся надвое: читающие работают сразу, пишущие — только через подтверждение человека. Тот же набор — у ассистента во вкладке «Чат»: что умеет агент в редакторе кода, то умеет и он.

Читать

Инструмент	Что делает
`search_knowledge`	поиск по смыслу; фрагменты с документом, разделом и ссылкой
`find`	найти документ или задачу по названию — дешевле поиска, когда название известно
`list_pages`	дерево страниц с идентификаторами — всё или одну ветку
`get_document`	документ целиком: текст, теги, связи, авторы и заведённые из него задачи
`list_documents`	подключённые Google-доки, презентации и доски Miro
`list_templates` / `get_template`	какие в проекте заготовки и что внутри
`list_tasks` / `get_task`	задачи проекта и задача целиком, вместе с описанием
`get_proposed_change`	своё же неподтверждённое предложение — чтобы восстановить текст устаревшей правки

Читаются не только страницы: get_document умеет и Google-док, и презентацию, и доску Miro — по ссылке или идентификатору. Отсюда сценарий «прочитай вот этот док и заведи по нему страницу».

Связи приходят вместе с текстом. Агент, читающий документ, сразу видит родителя, вложенные страницы и ссылки в обе стороны — и может прочитать соседа тем же инструментом. Поэтому он не переписывает страницу, не заметив, что раздел вокруг неё говорит обратное. Отдельного инструмента «обойти граф» не нужно. См. Граф связей.

Задачи приходят туда же. Вопрос «описано, но сделано ли» задаётся ровно в момент чтения документа: то, на что уже есть задача, — «взято на карандаш», а не «забыли».

Писать

create_page, update_page, rename_page, move_page, delete_page, create_task, update_task, set_task_status, delete_task.

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

Пишущих инструментов агент читателя не получает вовсе: применять его правки было бы некому.

Практические следствия, о которых стоит знать заранее:

Агент может ссылаться на то, что сам предложил. Идентификаторы будущей страницы и будущей задачи выдаются сразу, поэтому просьба «опиши документ, поставь по нему задачу и сошлись на неё в тексте» выполняется за один заход. Ссылки оживают в момент, когда вы нажмёте «Принять».
Своё неподтверждённое предложение он дописывает, а не кладёт поверх второе: на экране проверки вы увидите одну правку с итоговым текстом.
Чужое предложение агент править не может — только своё.
Отменять и восстанавливать он не умеет вовсе. Ни отката версий, ни возврата из корзины, ни принятия собственных правок — это остаётся человеку.

Чего у агента нет намеренно

Инструментов подтверждения. Нажать «принять» должен человек, и другим каналом — в этом весь смысл барьера.
Массового сброса базы знаний. Точечно удалить документ можно, «очистить всё» — нет.
Журнала действий. Разбирать последствия правок должен человек в вебе.
Вставки картинок. Агент правит текст, файлы приносит человек.
Слияния задач. Решать, чьё описание остаётся, — не работа модели; делается двумя обычными шагами.
Работы с чужим проектом. Адрес подключения — это конкретный проект, и границы запроса берутся из него же.
Паролей. Ключ секрета в тексте — это ссылка на запись в менеджере паролей; самого пароля в базе знаний нет, и агенту его взять неоткуда. См. Хранение паролей.

Шаблоны

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

Выбирает агент по описанию шаблона, а не по названию, — поэтому в описании стоит писать, когда его применять.

Права

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

Всё, что агент делает, попадает в журнал отдельной строкой — с пометкой, каким входом и каким клиентом.