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

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

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

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

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

Сначала вызовите подходящий инструмент чтения или проверки состояния.
Проверьте целевой объект и обязательные аргументы.
Выполните одно запланированное действие. Если требуется явное подтверждение человека, сначала получите его.
После этого проверьте состояние или повторно прочитайте затронутый ресурс.

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

`list_files`

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

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

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

| projectId | Нет | строка |

| kind | Нет | sources, stories, meta, all |

| category | Нет | ba, ux, ui |

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

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

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

`read_file`

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

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

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

| projectId | Нет | строка |

| path | Да | строка; минимальная длина 1; максимальная длина 512 |

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

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

`write_file`

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

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

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

| projectId | Нет | строка |

| path | Да | строка; минимальная длина 1; максимальная длина 512 |

| content | Да | строка |

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

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

`delete_file`

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

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

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

| projectId | Нет | строка |

| path | Да | строка; минимальная длина 1; максимальная длина 512 |

| confirm | Да | логическое значение |

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

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

`preview_control`

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

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

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

| projectId | Нет | строка |

| action | Да | start, restart, stop, rebuild |

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

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

`local_status`

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

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

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

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

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

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

`run_local`

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

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

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

| build | Нет | логическое значение |

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

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

`stop_local`

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

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

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

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

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

`local_setup_guide`

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

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

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

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

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

`set_local_service`

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

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

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

| databaseUrl | Нет | строка |

| valkeyUrl | Нет | строка |

| schema | Нет | строка |

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

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

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

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

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

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