Используйте ИИ в вашем приложении

На этой странице объясняются функции ИИ, с которыми пользователи взаимодействуют внутри вашего приложения. Atoms Cloud предоставляет библиотеку моделей и информацию об использовании проекта, а Atoms Agent в Chat создает и обновляет эти функции.

Понимание ИИ в Atoms Cloud

Откройте проект в настольной версии Atoms и убедитесь, что он находится в режиме Web. AI Library содержит модели, которые в данный момент доступны для проекта, а AI Usage показывает использование кредитов проекта и активные модели.

Если Atoms Cloud не подключен или AI недоступен, попросите Agent подключить Atoms Cloud или перейдите по ссылке Atoms Cloud, прежде чем продолжить.

Откройте AI Library в Atoms Cloud

1. На той же панели инструментов рабочего пространства, где находится Просмотр приложений, выберите Atoms Cloud.
2. На боковой панели выберите AI.
3. Откройте AI Library.

AI Library показывает модели, которые в данный момент доступны для вашего проекта. Вы можете просматривать фильтры по категориям или использовать Search, чтобы найти подходящую модель.

Библиотека может со временем меняться. Используйте модели и информацию, показанные там, вместо того чтобы полагаться на устаревший список моделей или провайдеров.

Добавьте модель в ваш запрос

1. Найдите модель в AI Library.
2. Выберите # Add на ее карточке. Atoms вставит тег модели в текущее сообщение Chat.
3. Дополните запрос на функцию после тега, затем отправьте сообщение Atoms Agent.

Выберите # Add, чтобы указать Agent, какую модель ИИ вы хотите использовать. Модель появится как тег в вашем сообщении Chat. Затем вы сможете описать, что именно Agent должен создать или изменить.

Вы также можете прикрепить модель напрямую из Chat: введите #, выберите AI, затем выберите одну из доступных в данный момент моделей.

Выберите # Add, чтобы вставить тег модели в ваш запрос Chat.

Четко опишите функцию

После прикрепления модели сообщите Agent, как вы хотите, чтобы функция работала с точки зрения пользователя. Укажите следующие сведения:

Что описать	Что сообщить Agent
Назначение	Объясните, чего эта функция должна помогать пользователям достигать.
Путь пользователя	Опишите, что пользователи будут вводить, загружать или выбирать и где они должны увидеть результат.
Используемая информация	Уточните, какую информацию ИИ должен использовать и что он не должен включать.
Ожидаемый результат	Опишите предпочтительный формат, тон, язык, длину и любые важные ограничения.
Загрузка и ошибки	Объясните, что пользователи должны видеть во время ожидания, когда информация отсутствует или недействительна, и если запрос завершается ошибкой.

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

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

Выбранная модель ИИ отображается как тег в поле ввода Chat.

Протестируйте функцию в Просмотр приложений

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

Тест	Что сделать	Ожидаемый результат
Обычный ввод	Отправьте типичный пример, для обработки которого предназначена функция.	Запрошенный результат появляется в правильном месте и в правильном формате.
Пустой ввод	Попробуйте продолжить, не предоставив обязательный контент.	Приложение объясняет, что нужно предоставить пользователю, и не отправляет лишний запрос.
Недопустимый ввод	Предоставьте контент в неподдерживаемом формате или вне ожидаемых требований функции.	Приложение остается пригодным для использования и показывает понятное объяснение проблемы.
Состояние загрузки	Отправьте запрос и наблюдайте за приложением во время его обработки.	Приложение показывает, что запрос выполняется, и предотвращает случайные повторные отправки.
Неудачный ответ	Если во время обычного тестирования запрос завершается ошибкой, проверьте, как реагирует приложение.	Приложение показывает полезное сообщение, позволяет пользователю попробовать снова и не раскрывает технические детали или личную информацию.

Не используйте намеренно конфиденциальные данные, не расходуйте все доступные кредиты и не нарушайте работу сервиса, чтобы вызвать ошибку. Если вы не можете безопасно воспроизвести медленный или неудачный ответ, вместо этого сообщите Agent, как приложение должно обрабатывать такую ситуацию.

Просмотрите использование ИИ в Atoms Cloud

1. Вернитесь в Atoms Cloud → AI.
2. Откройте AI Usage.
3. В разделе Overview просмотрите Total Кредиты Used и Active Models для этого проекта.
4. Просмотрите модели, перечисленные в разделе Active Models.

AI Usage показывает обзор на уровне проекта. Чтобы посмотреть баланс кошелька, пополнение и более подробные сведения об использовании Cloud или AI, см. Cloud & AI Wallet.

Чтобы просмотреть кредиты, использованные конкретным ответом Agent, выберите ... под этим ответом, затем просмотрите Кредиты used. Это значение на уровне сообщения отделено от обзора проекта в AI Usage.

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

Скриншот для добавления: AI Usage в чистом тестовом проекте, показывающий Overview, Total Кредиты Used и Active Models. Выделите вкладку AI Usage оранжевым цветом. Оставьте видимым актуальное название модели, чтобы список был понятен, но скройте данные аккаунта, информацию о рабочем пространстве и любую информацию о балансе, которая не требуется. Подпись: “Откройте AI Usage, чтобы просмотреть использование кредитов проекта и активные модели.” Alt text: “Вкладка AI Usage, показывающая использованные кредиты проекта и активные модели.”

Защитите данные пользователей и учетные данные

Контент, отправленный через функцию ИИ, может быть передан выбранному провайдеру модели для обработки. Отправляйте только ту информацию, которая необходима для выполнения запроса.

Никогда не отправляйте пароли, API-ключи, токены доступа или лишнюю личную либо конфиденциальную информацию. Убедитесь, что пользователи понимают, когда их контент отправляется в модель ИИ, и соблюдайте требования вашей организации к конфиденциальности и обработке данных.

Всегда проверяйте результаты, созданные ИИ, прежде чем полагаться на них при принятии важных решений. Дополнительную информацию см. в Atoms Terms of Service.

Если вашему приложению нужны приватные учетные данные от внешнего провайдера, храните их с помощью Ключи and secrets. Никогда не вставляйте учетные данные в Chat и не включайте их в код, который выполняется в браузере.