Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
API корректора — это экспериментальный веб-API, который позволяет исправлять грамматические, орфографические и пунктуационные ошибки в тексте с помощью небольшой языковой модели (SLM), встроенной в Microsoft Edge из кода JavaScript вашего веб-сайта или расширения браузера.
Вводные сведения об API корректора см. в разделе Объяснение API корректора.
Подробное содержание:
- Доступность API корректора
- Выбор используемого API
- Модель инструкций Aion
- Включение API корректора
- См. рабочий пример
- Использование API корректора
- Обратная связь
- См. также
Доступность API корректора
API корректора доступен в качестве предварительной версии для разработчиков в Microsoft Edge, начиная с версии 158. Протестировать API корректора можно локально в Microsoft Edge только на своем устройстве. См. раздел "Включение API корректора" ниже.
API корректора оптимизирован для исправления грамматических, орфографических и пунктуационных ошибок в текстовом содержимом. Дополнительные сведения об альтернативе для более пользовательских сценариев разработки запросов, которые могут не обслуживаться этими API, см. в разделе Запрос встроенной языковой модели с помощью API запросов.
Выбор используемого API
Чтобы использовать возможности ИИ на веб-сайтах и в расширениях браузера, вы также можете использовать следующие методы:
Отправляйте сетевые запросы в облачные службы ИИ, такие как решения ИИ Azure.
Запускайте локальные модели ИИ с помощью API нейронной веб-сети (WebNN) или среды выполнения ONNX для Интернета.
API корректора использует малую языковую модель (SLM), которая работает на том же устройстве, где используются входные и выходные данные модели (то есть локально). Это дает следующие преимущества по сравнению с облачными решениями:
Сниженная стоимость: Использование облачной службы ИИ не требует затрат.
Независимость сети: Помимо начальной загрузки модели, задержка сети при запросе модели отсутствует, и модель также можно использовать, когда устройство находится в автономном режиме.
Улучшенная конфиденциальность: Данные, вводимые в модель, никогда не покидают устройство и не собираются (например, для обучения моделей ИИ).
API корректора использует модель, предоставляемую Microsoft Edge и встроенную в браузер, которая обладает дополнительными преимуществами по сравнению с пользовательскими локальными решениями, например на основе WebGPU, WebNN или WebAssembly:
Общие единовременные затраты: Предоставляемая браузером модель загружается при первом вызове API, а затем модель распространяется на все веб-сайты, работающие в браузере, что снижает сетевые издержки для разработчиков и пользователей.
Упрощенное использование для веб-разработчиков: Встроенная модель может быть запущена с помощью простых веб-API и не требует опыта работы с ИИ/ML или использования сторонних платформ.
Модель инструкций Aion
В Microsoft Edge API Proofreader использует модель Aion Instruct, встроенную в браузер. Aion Instruct — это небольшая языковая модель с параметрами 2,3B, которая отлично справляется с текстовыми задачами. Чтобы узнать больше о модели, см. карт модели microsoft / Aion-1.0-Instruct-2.3B в Hugging Face.
Заявление об отказе от ответственности
Как и другие языковые модели такого размера, Aion Instruct потенциально может вести себя ненадежным, неточным, несправедливым или оскорбительным образом. Следует учитывать риски, связанные с передачей ненадежного содержимого в модель, а также проверять источник и целостность содержимого, прежде чем использовать его в качестве входных данных модели. Чтобы узнать больше, см. раздел «Предвзятость, риски и ограничения» в microsoft/Aion-1.0-Instruct-2.3B в Hugging Face.
Требования к оборудованию
Предварительная версия API корректора для разработчиков предназначена для работы на устройствах с аппаратными возможностями, которые создают выходные данные малой языковой модели (SLM) с предсказуемым качеством и задержкой.
API Корректора предъявляет следующие требования:
Операционные системы:
- Windows 10 или 11.
- macOS 13.3 или более поздней версии.
- 64-разрядный (x64) Linux с драйверами графического процессора Vulkan и Microsoft Edge 159 или более поздней версии.
Хранение: На томе, содержащем профиль Microsoft Edge, доступно не менее 20 ГБ. Если объем доступного хранилища упадет ниже 5 ГБ, модель будет удалена, чтобы обеспечить достаточное количество места для работы других компонентов браузера.
Графический процессор: 3 ГБ видеопамяти или больше.
Сеть: Безлимитный тарифный план или безлимитное подключение. Модель не загружается при использовании лимитного подключения.
Чтобы проверить, поддерживает ли ваше устройство предварительную проверку API корректора для разработчиков, см. раздел «Включение API корректора» ниже и проверка класса производительности вашего устройства.
Из-за экспериментального характера API средства корректора вы можете наблюдать проблемы в определенных конфигурациях оборудования. Если вы видите проблемы в определенных конфигурациях оборудования, оставьте отзыв, открыв новую проблему в репозитории MSEdgeExplainers.
Доступность модели Aion Instruct
Начальная загрузка модели Aion Instruct требуется при первом вызове веб-сайтом API, для которого требуется модель на устройстве. Чтобы отслеживать загрузку модели, используйте monitor эту опцию при создании нового сеанса API корректора. См. Мониторинг хода загрузки модели ниже.
Модель недоступна в следующих состояниях:
- Если параметр ИИ на устройстве отключен в разделе "Настройки",>Copilot и ИИ.
- Если корпоративные политики GenAILocalFoundationalModelSettings или ComponentUpdatesEnabled настроены на блокировку скачивания модели.
- Если устройство не соответствует требованиям к оборудованию, месту на диске или сети.
Рассмотрение для Edge Canary, Dev и Beta
В Microsoft Edge Canary, Dev и Beta параметр ИИ на устройстве по умолчанию отключен в настройках>Copilot и ИИ, чтобы не скачивать модель отдельно для каждого канала.
Если включить флаг API Корректора в edge://flags, параметр ИИ на устройстве автоматически включается в Canary, Dev и Beta. См. раздел "Включение API корректора" ниже.
Включение API корректора
Использование API корректора в Microsoft Edge:
Убедитесь, что вы используете Microsoft Edge версии 158 или более поздней.
В Microsoft Edge откройте новую вкладку или окно и перейдите в
edge://flagsразделВ поле поиска вверху страницы введите Proofreader API.
Страница будет отфильтрована для отображения соответствующего флага.
Выберите "Включено" рядом с флагом API Корректора:
Дополнительно, чтобы локально регистрировать сведения, которые могут быть полезны для отладки, также включите флаг " Включить на устройстве журналы отладки модели ИИ ".
Перезапустите Microsoft Edge.
Чтобы проверить, соответствует ли ваше устройство требованиям к оборудованию для предварительной версии API корректора для разработчиков, откройте новую вкладку, перейдите в
edge://on-device-internalsраздел и проверьте значение класса производительности устройства.Если ваш класс производительности устройства средний или выше, ожидается, что API корректора будет поддерживаться на вашем устройстве. Если вы продолжаете замечать проблемы, сообщите о новой проблеме.
См. рабочий пример
Чтобы увидеть API Корректора в действии и изучить существующий код, использующий эти API, выполните следующие действия.
Включите API корректора, как описано выше.
В Microsoft Edge откройте вкладку или окно и перейдите на игровую площадку API корректора.
В информационном баннере вверху проведите проверку состояния. Изначально в состоянии указано " API на устройстве" и загрузка модели:
После загрузки модели на информационном баннере отображается сообщение "API и модель доступно на устройстве", указывая, что API и модель можно использовать:
Если загрузка модели не начинается, перезапустите Microsoft Edge и повторите попытку.
API корректора поддерживается только на устройствах, которые соответствуют определенным требованиям к оборудованию. Дополнительные сведения см. в разделе "Требования к оборудованию" выше.
При необходимости измените содержимое и параметры на странице. Например, измените текст, чтобы проверить правописание, или измените предполагаемый язык ввода.
Нажмите кнопку "Корректура " в нижней части страницы.
Выходные данные создаются в разделе ответов страницы:
См. также:
- /built-in-ai/ — сведения о продукте сведений и исходном коде для демонстрации встроенных ИИ-игровых площадок.
Использование API корректора
Проверка включения API
Прежде чем использовать API Proofreader в коде своего сайта, проверка, что API включен, проверив наличие Proofreader объекта:
if (!Proofreader) {
// The Proofreader API is not available.
}
Проверьте, можно ли использовать модель
API корректора можно использовать только в том случае, если устройство поддерживает запуск модели и после загрузки языковой модели и среды выполнения модели браузером Microsoft Edge.
Чтобы проверка, можно ли использовать API, используйте метод:availability()
const availability = await Proofreader.availability();
if (availability == "unavailable") {
// The model is not available.
}
if (availability == "downloadable" || availability == "downloading") {
// The model can be used, but it needs to be downloaded first.
}
if (availability == "available") {
// The model is available and can be used.
}
Создание сеанса
При создании сеанса браузеру предписывается загрузить языковую модель в память, чтобы ее можно было использовать. Прежде чем использовать API средства корректора для исправления текста, создайте новый сеанс следующим образом create() :
// Create a Proofreader session.
const session = await Proofreader.create();
Для настройки сеанса модели вы можете передать варианты методу create() :
// Create a Proofreader session with options.
const session = await Proofreader.create(options);
Доступные параметры перечислены ниже.
| Вариант | Описание |
|---|---|
monitor |
Функция, используемая для отслеживания хода загрузки модели. См. Мониторинг хода загрузки модели ниже. |
expectedInputLanguages |
Массив строк. Каждая строка является языком, который должен содержаться во входном тексте. Пример: ["en", "es"]. |
Отслеживание хода загрузки модели
Чтобы следить за ходом загрузки модели, воспользуйтесь этой monitor опцией. Это полезно, если модель еще не полностью загружена на устройство, на котором будет использоваться модель, чтобы проинформировать пользователей вашего сайта о том, что им нужно подождать.
// Create a Proofreader session with the monitor option to monitor the model
// download.
const session = await Proofreader.create({
monitor: m => {
// Use the monitor object argument to add an listener for the
// downloadprogress event.
m.addEventListener("downloadprogress", event => {
// The event is an object with the loaded and total properties.
if (event.loaded == event.total) {
// The model is fully downloaded.
} else {
// The model is still downloading.
const percentageComplete = (event.loaded / event.total) * 100;
}
});
}
});
Запуск API корректора
Чтобы создать исправленный текст с помощью API корректора, после создания соответствующего сеанса модели используйте session.proofread() метод. Этот метод возвращает обещание, которое разрешается после того, как API Proofreader завершит генерацию исправленного текста.
// Create a Proofreader session.
const session = await Proofreader.create();
// Correct the text and wait for the result.
const result = await session.proofread(textToBeCorrected);
// Use the result.
console.log(result);
Использование результата API корректора
Метод session.proofread() возвращает отложенный объект, который разрешается в объект со следующими свойствами:
| Свойство | Описание |
|---|---|
correctedInput |
Исправленный текст в виде строки. |
corrections |
Массив корректируемых объектов. |
Исправляемый объект обладает следующими свойствами:
| Свойство | Описание |
|---|---|
startIndex |
Индекс первого исправленного символа во входном тексте. |
endIndex |
Индекс последнего исправленного символа во входном тексте. |
correction |
Строка, заменяющая неправильный текст. |
В следующем примере показано, как получить результат этого метода session.proofread() .
// Create a Proofreader session.
const session = await Proofreader.create();
// Correct the text and wait for the result.
const result = await session.proofread(textToBeCorrected);
// Log the corrected text.
console.log("Corrected text:", result.correctedInput);
// Log each correction.
result.corrections.forEach(({ startIndex, endIndex, correction }) => {
const initialText = textToBeCorrected.slice(startIndex, endIndex);
console.log(`Replaced text "${initialText}" (index ${startIndex} to ${endIndex}) with "${correction}"`);
});
Уничтожение сеанса
Удалите сеанс, чтобы браузер знал, что языковая модель больше не нужна, чтобы модель можно было выгрузить из памяти.
Вы можете уничтожить сеанс двумя способами:
- С помощью
destroy()метода. - С помощью файла
AbortController.
Уничтожение сеанса с помощью метода destroy()
Вы можете использовать session.destroy() этот метод для уничтожения сеанса корректора:
const session = await Proofreader.create();
// Later, destroy the session by using the destroy method.
session.destroy();
Уничтожение сеанса с помощью AbortController
Кроме того, можно создать AbortController объект, создать сеанс, Proofreader а затем вызвать abort():
// Create an AbortController object.
const controller = new AbortController();
// Create a Proofreader session and pass the
// AbortController signal object by using the signal option.
const session = await Proofreader.create({ signal: controller.signal });
// Later, such as when the user interacts with the UI, destroy the session by
// calling the abort() function of the AbortController object.
controller.abort();
Отправка отзывов
Нам очень интересно узнать о диапазоне сценариев, в которых вы собираетесь использовать API корректора, о любых проблемах с API или языковой моделью, а также о том, будут ли полезны новые API для конкретных задач.
Чтобы отправить отзыв о сценариях и задачах, которые вы хотите выполнить, добавьте комментарий к проблеме с отзывами API корректора.
Если вы обнаружите какие-либо проблемы при использовании API вместо этого, сообщите об этом в репозитории.
Вы также можете принять участие в обсуждении разработки API Proofreader в репозитории W3C Web Машинное обучение Working Group.
См. также
- Объяснение API корректора в репозитории GitHub машинного обучения в Интернете.
- Пишите, переписывайте и резюмируйте текст с помощью API помощи при письме.
- Запрашивать встроенную языковую модель с помощью API запросов.
- /built-in-ai/ — исходный код и сведения сведения для демонстрации встроенных игровых площадок с ИИ.