Меню документации

Файлы, предпросмотр и локальная среда выполнения

На этой странице

Проверяйте файлы перед редактированием. Инструментам управления локальными процессами нужны подключение stdio и локальное расположение проекта.

Как пользоваться инструментами

  1. Сначала вызовите подходящий инструмент чтения или проверки статуса.
  2. Проверьте расположение проекта и обязательные аргументы.
  3. Запустите одно запланированное действие. Если нужно явное подтверждение человека, сначала получите его.
  4. Затем проверьте статус или заново прочитайте затронутый ресурс.

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

list_files

Файлы сгенерированного проекта.

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

АргументОбязательныйТип или допустимые значения
projectIdНетстрока
kindНетsources, stories, meta, all
categoryНетba, ux, ui

Операция: только чтение.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; облачное подключение по HTTP.

В машиночитаемых контрактах инструментов приведены вложенные схемы аргументов.

read_file

Прочитать один сгенерированный файл.

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

АргументОбязательныйТип или допустимые значения
projectIdНетстрока
pathДастрока; минимальная длина 1; максимальная длина 512

Операция: только чтение.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; облачное подключение по HTTP.

В машиночитаемых контрактах инструментов приведены вложенные схемы аргументов.

write_file

Записать один сгенерированный файл.

Записывает исходный код и может повлиять на текущее приложение. Прочитайте существующий файл и не добавляйте в исходный код конфиденциальные учётные данные.

АргументОбязательныйТип или допустимые значения
projectIdНетстрока
pathДастрока; минимальная длина 1; максимальная длина 512
contentДастрока

Операция: может изменить состояние или запустить работу; возможны деструктивные изменения.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; облачное подключение по HTTP.

В машиночитаемых контрактах инструментов приведены вложенные схемы аргументов.

delete_file

Удалить один сгенерированный файл.

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

АргументОбязательныйТип или допустимые значения
projectIdНетстрока
pathДастрока; минимальная длина 1; максимальная длина 512
confirmДалогическое значение

Операция: может изменить состояние или запустить работу; возможны деструктивные изменения.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; облачное подключение по HTTP.

В машиночитаемых контрактах инструментов приведены вложенные схемы аргументов.

preview_control

Запустить, перезапустить, остановить или пересобрать предпросмотр.

Меняет среду выполнения предпросмотра, а не продакшен. Проверяйте состояние, которое возвращает инструмент. Если сборка завершилась с ошибкой, выясните причину, прежде чем продолжать.

АргументОбязательныйТип или допустимые значения
projectIdНетстрока
actionДаstart, restart, stop, rebuild

Операция: может изменить состояние или запустить работу.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; облачное подключение по HTTP.

В машиночитаемых контрактах инструментов приведены вложенные схемы аргументов.

local_status

Проверить, готов ли этот компьютер к запуску приложения.

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

Аргументы: нет ({}).

Операция: только чтение.

Доступные конфигурации: stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс.

В машиночитаемых контрактах инструментов приведены вложенные схемы аргументов.

run_local

Собрать и запустить приложение на этом компьютере.

Запускает выбранное локальное приложение и по запросу собирает его. Сначала ознакомьтесь с результатами local_status и local_setup_guide.

АргументОбязательныйТип или допустимые значения
buildНетлогическое значение

Операция: может изменить состояние или запустить работу.

Доступные конфигурации: stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс.

В машиночитаемых контрактах инструментов приведены вложенные схемы аргументов.

stop_local

Остановить приложение на этом компьютере.

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

Аргументы: нет ({}).

Операция: может изменить состояние или запустить работу.

Доступные конфигурации: stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс.

В машиночитаемых контрактах инструментов приведены вложенные схемы аргументов.

local_setup_guide

Как запустить сгенерированное приложение на этом компьютере.

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

Аргументы: нет ({}).

Операция: только чтение.

Доступные конфигурации: stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс.

В машиночитаемых контрактах инструментов приведены вложенные схемы аргументов.

set_local_service

Сохранить выбранную пользователем базу данных или очередь.

Сохраняет настройки выбранной базы данных и сервиса Valkey. Передавайте конфиденциальные параметры подключения через подходящий канал для секретов.

АргументОбязательныйТип или допустимые значения
databaseUrlНетстрока
valkeyUrlНетстрока
schemaНетстрока

Операция: может изменить состояние или запустить работу.

Доступные конфигурации: stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс.

В машиночитаемых контрактах инструментов приведены вложенные схемы аргументов.

Связанные справочные материалы

Главная страница MCP · Процесс восстановления работы · Стоимость

Названия и товарные знаки

Valkey — проект Linux Foundation. Его название и товарные знаки используются для обозначения упомянутой технологии. Правила использования. Документация OwlMeans не подразумевает спонсорской поддержки или одобрения со стороны этих владельцев.