AI サービス分析ダッシュボード
オプションの AIBudsAIDashboard モジュールは、iOS デバイスに保存された AI セッションレポートを確認するためのローカル Web ダッシュボードを提供します。ホストアプリにレポート画面を実装しなくても、AI チャット、AI 録音、翻訳、同時通訳を診断できます。
AI Dashboard は運用支援ツールです。AI サービスプロバイダーの設定やセッションの開始を行うものではなく、各 AI 機能ガイドの代わりにもなりません。
管理されたダッシュボードセッション
完了した AI 処理のレポートを保存し、開発専用のローカルサーバーから到達可能なブラウザに公開します。
アーキテクチャ上の境界
サーバーはホストアプリ内で動作します。利用可否は、アプリのライフサイクル、ネットワーク到達性、ポート選択、リソースの同梱、レポート保持状態に左右されます。
パッケージングとライフサイクル
直接組み込む場合は AIBudsAIDashboard と Web リソースの AIBudsAIDashboard.bundle が必要です。AIBudsAllInOne もダッシュボードのライフサイクル API を公開しています。アプリで採用した一方の管理方式だけを使用し、両方から起動しないでください。
開発専用のアプリケーション所有者からサーバーを一度だけ起動し、診断が終わったら停止します。
- Swift
- Objective-C
#if DEBUG
import AIBudsAIDashboard
if !AIDashboardSDK.isRunning {
let accepted = AIDashboardSDK.start(withPort: 3000)
if !accepted { print("AI Dashboard start was rejected") }
}
#endif#if DEBUG
@import AIBudsAIDashboard;
if (![AIBudsAIDashboardSDK isRunning]) {
BOOL accepted = [AIBudsAIDashboardSDK startWithPort:3000];
if (!accepted) {
NSLog(@"AI Dashboard start was rejected");
}
}
#endif宣言については AIDashboardSDK を参照してください。
アクセスと動作確認
SDK は起動時にダッシュボードのアドレスをログへ出力します。iOS デバイスに到達できるブラウザから開いてください。戻り値の Bool は起動要求が受理されたことだけを示し、完全な稼働確認ではありません。現在の公開 API からは、バインド URL、ネットワークインターフェース、ポート競合の詳細、サーバーエラーを取得できません。
ライフサイクル状態、ログに出力されたアドレス、リソースバンドル警告の有無、ブラウザからの到達性、対応 AI レポートが作成済みかを確認します。ダッシュボードが空の場合、単にレポートがまだ保存されていない可能性があります。
セキュリティとプライバシーの境界
:::warning 開発環境および管理された診断用途に限定 現在のダッシュボードはローカル HTTP サービスであり、公開 API から認証、TLS、バインド先インターフェースを設定できません。レポートには文字起こしや機密性の高いセッションデータが含まれる場合があります。公開範囲と保持方式がセキュリティおよびプライバシー審査で明示的に承認されない限り、本番環境では有効にしないでください。 :::
- デバッグビルドまたは社内ビルドのポリシーで起動を制限します。
- 信頼できる隔離ネットワークを使用します。
- アドレスや認証情報を分析基盤やログへ送信しないでください。
- 診断が終了したら、直ちにサーバーを停止します。
- レポートにも AI データの保持・削除ポリシーを適用します。
トラブルシューティング
| 症状 | 確認事項 |
|---|---|
| 起動が拒否される | サーバーがすでに動作している可能性があります。ライフサイクルの管理元を 1 つにしてください。 |
| ページのリソースが表示されない | ビルド済みアプリに AIBudsAIDashboard.bundle が含まれているか確認します。 |
| ブラウザから接続できない | ログのアドレス、ポート、ネットワーク到達性、ローカルネットワークポリシーを確認します。 |
| ダッシュボードが空 | 対応する AI セッションを完了し、レポートが保存されたことを確認します。 |
| 診断後もエンドポイントが残る | 起動したものと同じアプリケーション所有者から停止します。 |