СпонсорУвійтиПодати
Блог

Siri AI тепер відкрита для всіх розробників. Ось що я зробив би зі своїм застосунком для Mac

Від Justinas Rolando, розробника MacPip

Коротка відповідь

3 листопада Apple відкрила попередню версію Siri AI для розробників усім, у бета-версіях macOS 27.3, iOS 27.3, iPadOS 27.3 і visionOS 27.3. Ваш застосунок підключається через App Intents: позначте інтент як @AppIntent(.tool), дайте йому зрозумілі title і description, і Siri зможе його запускати. Поки це працює лише в збірках для розробки та у внутрішньому TestFlight. Надсилання до App Store відкриється навесні.

Учора, 3 листопада, Apple виклала коротку публікацію Siri AI тепер відкрита для всіх розробників. Вона вийшла того самого дня, що й перша бета-версія macOS 27.3, і це найкорисніше в ній для таких, як я, хто робить невеликі застосунки для Mac. Тож цей ранок я витратив на читання нової документації замість справжньої роботи.

Ось що змінилося, що з цим можна й не можна робити вже зараз і що я збираюся зробити першим.

Що змінилося

Чого поки не можна

Ця частина важливіша за блискучу.

Тож нікому не потрібно поспішати з оновленням цього тижня. У вас є кілька місяців, щоб зробити все як слід, перш ніж користувачі вашого застосунку зможуть це спробувати.

Як це працює, простими словами

Тут три частини, і перша становить більшу частину роботи.

  1. Інтенти-інструменти. Ви додаєте макрос @AppIntent(.tool) до інтенту застосунку. Так він стає інструментом, який Siri може викликати. Apple радить дати інтенту і кожному його параметру справжні title та description, бо Siri читає їх, щоб зрозуміти, який інструмент пасує до сказаного людиною. Якщо ваш інтент уже використовує одну зі схем Apple, що підтримують Siri, макрос додавати не потрібно.
  2. Вміст, який Siri може знайти. Siri знаходить лише те, що ви зробили доступним. Документація радить додати сутності застосунку до Spotlight, і тепер Siri може показати будь-яку сутність із семантичного індексу Spotlight, а не лише ті, що пасують до схеми.
  3. Навички, лише якщо вони потрібні. Ви додаєте один Skills.skillsbundle до цільового модуля застосунку. Усередині його папки Skills кожна навичка має власну папку з назвою з малих літер, цифр і дефісів, а в ній один файл SKILL.md. Apple чітко каже, що навичка це підказка, а не скрипт: Siri не виконує перелічені вами кроки по порядку.

Apple вже робить це у своїх застосунках, зокрема Finder, «Файли», «Нотатки», «Перегляд», «Нагадування», Safari і Shortcuts. Якщо ви маєте одну зі звичок, які Siri тепер уміє, наприклад «архівувати файли, які я не відкривав рік», це непоганий орієнтир, де проходить планка.

Що б я зробив першим, по порядку

Це мої власні думки, а не список Apple.

  1. Запишіть п'ять речей, про які попросила б людина. Не функції, а запити простими словами. «Запусти сесію фокусу на 25 хв.» «Покажи кліпи, які я скопіював сьогодні вранці.» Якщо п'ять вигадати не виходить, можливо, вашому застосунку це поки не потрібно, і це нормально.
  2. Перевірте інтенти, які ви вже маєте. Багато застосунків для Mac уже містять App Intents для Shortcuts. Прочитайте їхні назви й описи так, ніби ви Siri. Інтент «Run Action» без опису обрано не буде.
  3. Позначте як інструменти два-три інтенти. Почніть із дій із кроку 1. Не позначайте все підряд: за словами документації, інтент, який лише налаштовує віджет і нічого не робить у perform(), не повинен бути інструментом.
  4. Додайте свій вміст до Spotlight. Якщо люди питатимуть про речі з вашого застосунку (нотатки, кліпи, проєкти, таймери), Siri зможе знайти їх лише через Spotlight.
  5. Запустіть перевірки від Apple. Скористайтеся Siri Integration Advisor в Xcode, потім опишіть скриптами кілька з ваших п'яти запитів у SiriEvaluations, щоб помітити, якщо якась зміна погіршить роботу Siri.
  6. Пишіть навичку лише для справжнього багатокрокового завдання. Один зрозумілий SKILL.md кращий за п'ять розпливчастих.
  7. Поки не обіцяйте це користувачам. Не пишіть «Works with Siri AI» на сторінці застосунку чи в нотатках до випуску, доки люди не зможуть справді цим користуватися у версії, яку можна завантажити.

Якщо ви не можете запустити бета-версію 27.3, кроки 1, 2 і 3 усе одно підійдуть: це здебільшого читання власного коду й написання кращих описів, що й сьогодні допомагає Shortcuts.

Поговоріть з Apple, поки це недорого

Apple проводить Apple Intelligence Group Labs сьогодні, 4 листопада, з 9 до 10 ранку за тихоокеанським часом, і завтра, 5 листопада, з 6 до 7 вечора за тихоокеанським часом. Посилання для запису є в публікації Apple. Це попередня версія, і Apple каже, що API може змінитися, тож зараз саме той момент, коли відгук ще може щось змінити.

Погляд MacPip

На MacPip я публікую багато застосунків зі ШІ та застосунків для продуктивності, і більшість із них роблять саме такі невеликі зрозумілі дії, які тепер може запускати Siri. Мені здається, що застосунки, які впораються з цим до весни, матимуть новий спосіб бути знайденими: люди проситимуть Siri про завдання, а не шукатимуть назву застосунку. Я стежитиму за цим.

Якщо ви користуєтеся кодувальним агентом, промпт підготовка до наступної macOS непогано підходить, щоб вивчити проєкт перед бета-версією. Навичок він за вас не напише, але підкаже, де живуть ваші інтенти. А якщо функції ШІ у вашому застосунку коштують вам грошей за кожен запит, новий калькулятор підписки чи разової ціни покаже, скільки лишається після комісій за кожної моделі ціни.

Коли це вийде, напишіть про це в нотатках до випуску й оновіть сторінку застосунку. Якщо вашого застосунку ще немає на MacPip, додати його можна безкоштовно.

Джерела

Читайте далі

Подайте свій застосунокБезкоштовні інструменти для розробників