101

Используйте для локального ролика MP4 (например, из Seedance): передайте его фактическое base64-содержимое, MIME-тип и имя; локальный путь серверу не передавайте.

upload_video_content

Используйте для локального изображения Codex: передайте его фактическое base64-содержимое, MIME-тип и имя; локальный путь серверу не передавайте.

upload_image_content

Используйте для локального файла любого формата до 100 МиБ, когда у вас есть терминал: start с именем и точным размером вернёт upload_url и готовую команду curl, отправьте файл по ней, затем finish вернёт исходные files[].id/name/url от POST /api/user/upload/. Без терминала файл до 256 КиБ передайте в start полем content_base64. Байты большого файла через аргументы не передавайте.

upload_local_file

Используйте, когда пользователь прикрепил к чату файлы; для Wiki-медиа передайте files[].url в content.url и files[].name в content.name, а files[].id — в fileList продуктовой операции.

upload_files

Используйте, когда нужна задача целиком по её GUID: карточка и тело задачи (вики-страница с блоками) одним ответом. Инструмент получает данные без показа виджета. Используйте результат для анализа и внутренних шагов. Если записи должны быть видимы пользователю как часть ответа, вызовите show_result с structuredContent.presentation.token.

get_task

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

create_payment

Используйте, чтобы сохранить факт, который пригодится в будущих разговорах: как к человеку обращаться, его роль и участок работы, устойчивые договорённости. Одна фраза до 200 символов. Не сохраняйте пароли, коды, номера карт, разовые детали и то, что легко узнать инструментом.

remember_about_user

Используйте, чтобы изменить название или позицию CRM-воронки.

edit_crm_pipeline

Используйте, чтобы изменить поля существующей CRM-сделки.

edit_crm_deal

Используйте, когда нужно изменить название, позицию или ожидаемую версию root Wiki.

update_wiki

Используйте, чтобы заменить тип, content или позицию одного блока (PATCH /api/wiki/{wikiUuid}/blocks/{blockUuid}/). content заменяется целиком; передайте expectedVersion из последнего ответа; для медиа сначала вызовите upload_files и передайте files[].url в content.url.

update_wiki_block

Используйте, когда пользователь готов изменить поля существующей задачи.

update_task

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

edit_expense

Используйте, когда пользователь готов изменить существующий перевод.

edit_payment

Используйте, чтобы передать полный новый порядок CRM-воронок компании.

reorder_crm_pipelines

Используйте после актуального списка и подтверждения человеком влияния на приоритет, чтобы передать полный новый порядок правил распределения сделок.

reorder_crm_distribution_rules

Используйте, чтобы передать полный новый порядок этапов CRM-воронки.

reorder_crm_funnels

Используйте, когда пользователь готов изменить существующее поступление.

edit_income

Используйте, когда нужно создать или обновить персональные права root Wiki или child page. Операция записи в два шага: первый вызов возвращает превью и confirmation_token, повторный вызов с _confirmation_token (и теми же аргументами) выполняет её.

update_wiki_permissions

Используйте после актуальной schema, списка правил и подтверждения человеком итоговой интерпретации, чтобы изменить правило автоматического распределения сделок.

edit_crm_distribution_rule

Используйте, когда нужно частично изменить проект, включая заказчика, руководителя, прайс-лист, участников и связанные статьи.

edit_project

Используйте, когда пользователь готов изменить существующую смету.

edit_estimate

Используйте, чтобы частично изменить настройки статьи выбранного проекта.

edit_bill

Используйте, когда нужно изменить title, icon или expectedVersion существующей child page.

update_wiki_page

Используйте, чтобы изменить название или позицию этапа CRM-воронки.

edit_crm_funnel

Используйте, когда нужны реквизиты и основные сведения о выбранной компании. Инструмент получает данные без показа виджета. Используйте результат для анализа и внутренних шагов. Если записи должны быть видимы пользователю как часть ответа, вызовите show_result с structuredContent.presentation.token.

get_company

Используйте после выбора целевого проекта, чтобы получить доступные статьи других проектов для последующего копирования.

list_bill_duplication_sources

Используйте после search_global_knowledge или search_support_media, когда среди mediaCandidates есть материал, который показывает ровно то, о чём спросили: получите его и приложите к ответу. Ссылки берите только из mediaCandidates.

get_support_media

Используйте, когда нужна карточка одного контрагента целиком: профиль, роль, права и балансы в контексте компании.

get_contractor_detail

Используйте, когда нужны средства фонда, непереведённая прибыль проектов и их перерасход. Это не баланс компании при закрытии.

get_company_fund

Используйте, когда нужно показать обсуждение выбранной задачи. Инструмент получает данные без показа виджета. Используйте результат для анализа и внутренних шагов. Если записи должны быть видимы пользователю как часть ответа, вызовите show_result с structuredContent.presentation.token.

list_task_comments

Используйте, когда нужно выбрать или найти контрагента компании.

list_contractors

Используйте, когда нужна лента событий компании со всеми фильтрами и итогами (totals, balanceTotals) — один в один с приложением. Инструмент получает данные без показа виджета. Используйте результат для анализа и внутренних шагов. Если записи должны быть видимы пользователю как часть ответа, вызовите show_result с structuredContent.presentation.token.

list_events

Используйте, когда пользователь готов массово изменить цену или себестоимость позиций выбранного прайс-листа.

bulk_update_price_list_positions

Используйте, когда пользователь явно просит выполнить одно действие над несколькими задачами. Операция записи в два шага: первый вызов возвращает превью и confirmation_token, повторный вызов с _confirmation_token (и теми же аргументами) выполняет её.

update_tasks_bulk

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

list_watches

Используйте только внутри виджета деталки задачи, когда пользователь выбирает или снимает исполнителя.

set_task_assignee

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

set_wiki_page_publication

Используйте, чтобы выполнить или отменить переход, предложенный через mode=offer. Зовите только после явного «да» или «нет» человека: своей волей согласиться нельзя.

resolve_screen_offer

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

resolve_pending_confirmation