ui_type

Экран, окна и интерфейс · macOS · Windows

Эффект: выполнение. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Вводит текст в активный элемент управления (или сначала переводит фокус на element_ref, затем вводит). Отправляет реальные события клавиш, поэтому срабатывают проверка и обработчики. Результат ПРОВЕРЯЕТСЯ ОБРАТНЫМ ЧТЕНИЕМ элемента, а не фактом выполнения записи: {typed, verified:true} означает, что значение действительно изменилось; input_not_applied — явная ошибка, означающая, что события были отправлены, но значение НЕ изменилось (ничего не введено — обычно окно не на переднем плане); verified:false + verification:'unavailable' означает, что цель не публикует читаемое значение, поэтому доставку подтвердить нельзя и следует самостоятельно прочитать элемент. Требуется разрешение Accessibility.

Обязательные входные данные

text

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

Разрешения и подтверждение

Схема не объявляет явного параметра подтверждения. Это не разрешает действовать без согласия: проверьте эффект и получите разрешение.

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — macOS

{
  "properties": {
    "element_ref": {
      "description": "Optional; focus this element first.",
      "type": "string"
    },
    "text": {
      "description": "The text to type.",
      "type": "string"
    }
  },
  "required": [
    "text"
  ],
  "type": "object"
}

Пример для документации

Пример документации для ui_type. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

{
  "text": "Can we review the launch checklist on Tuesday?"
}

Windows

Назначение

Обязательные входные данные

text

Разрешения и подтверждение

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — Windows

{
  "properties": {
    "element_ref": {
      "description": "Optional; focus this element first.",
      "type": "string"
    },
    "text": {
      "description": "The text to type.",
      "type": "string"
    }
  },
  "required": [
    "text"
  ],
  "type": "object"
}

Пример для документации

{
  "text": "Can we review the launch checklist on Tuesday?"
}