Перейти к основному содержимому

Панель анализа AI-сервисов

Необязательный модуль AIBudsAIDashboard запускает локальную веб-панель для просмотра отчётов AI-сессий на iOS-устройстве. Она помогает диагностировать AI-диалоги, аудиозапись, перевод и синхронный перевод без добавления экранов отчётов в приложение.

AI Dashboard — служебный инструмент. Она не настраивает поставщика, не запускает AI-сессии и не заменяет руководства по функциям.

Animated workflow

Контролируемая сессия панели

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

AI-функция

Завершить AI-сессию

Завершить поддерживаемый AI-процесс, создающий отчёт.

AIBuds AI

Сохранить отчёт

Сохранить диагностический отчёт сессии на iOS-устройстве.

Приложение

Запустить панель

Запустить один локальный HTTP-сервер только для разработки.

Разработчик

Открыть в браузере

Открыть адрес из журнала в сети с взаимной доступностью.

контролируемый доступ
Приложение

Остановить и безопасно сохранить

Остановить endpoint и применить политику хранения отчётов.

Останавливайте локальный сервер после диагностики и не используйте его как production-интерфейс администрирования без отдельной проверки.

Архитектурные границы

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

Упаковка и жизненный цикл

Для прямой интеграции нужны AIBudsAIDashboard и веб-ресурсы AIBudsAIDashboard.bundle. AIBudsAllInOne также предоставляет методы жизненного цикла панели; используйте выбранную приложением модель владения и не запускайте оба варианта.

Запускайте сервер один раз владельцем приложения только для разработки и останавливайте после диагностики.

Swift
#if DEBUG
    import AIBudsAIDashboard

    if !AIDashboardSDK.isRunning {
        let accepted = AIDashboardSDK.start(withPort: 3000)
        if !accepted { print("AI Dashboard start was rejected") }
    }
#endif

Объявления приведены в AIDashboardSDK.

Доступ и проверка

При запуске SDK записывает адрес панели в журнал. Откройте его в браузере, имеющем доступ к iOS-устройству. Возвращаемый Bool означает принятие команды, а не полную проверку работоспособности: публичный API не возвращает URL привязки, интерфейс, сведения о конфликте порта или ошибку сервера.

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

Безопасность и конфиденциальность

:::warning Только для разработки и контролируемой диагностики Текущая панель — локальный HTTP-сервис, публичный API которого не предоставляет настраиваемую авторизацию, TLS или ограничение интерфейса привязки. Отчёты могут содержать распознанный текст и чувствительные данные сессии. Не включайте панель в production без явного одобрения модели доступа и хранения службой безопасности и конфиденциальности. :::

  • Разрешайте запуск только в debug- или внутренних сборках.
  • Используйте доверенную изолированную сеть.
  • Не публикуйте адреса или учётные данные в аналитике и журналах.
  • Останавливайте сервер сразу после диагностики.
  • Применяйте к отчётам политику хранения и удаления AI-данных.

Устранение неполадок

ПроявлениеЧто проверить
Запуск отклонёнВозможно, сервер уже работает; оставьте одного владельца жизненного цикла.
Ресурсы страницы отсутствуютУбедитесь, что AIBudsAIDashboard.bundle включён в приложение.
Браузер не подключаетсяПроверьте адрес из журнала, порт, доступность и политику локальной сети.
Панель пустаЗавершите поддерживаемую AI-сессию и убедитесь, что отчёт сохранён.
Endpoint работает после диагностикиОстановите его тем же владельцем приложения, который запустил сервер.