flutter-ai-integration

Flutter AI Integration

モデルの動作は、明示的なプロダクト契約に基づく、信頼性が保証されない非同期の外部機能として統合します。ユーザーが移行を求めない限り、プロジェクトのプロバイダー、バックエンド、ネットワーククライアント、状態管理、永続化、UI アーキテクチャを維持します。

このスキルを選択したという理由だけで、プロバイダー SDK、アカウント設定、認証情報、バックエンドを追加しないでください。

事前確認

pubspec.yaml、SDK の制約、既存の AI または API アダプター、バックエンドとの境界、認証、モデル設定、状態の所有者、永続化、プライバシー要件、テスト、対象プラットフォームを確認します。モデル、プロバイダー、SDK、UI ツールキットを選ぶ前に、意図する機能と障害発生時の動作を明確にしてください。

モデルやプロバイダーの詳細は、アプリケーションが所有する狭いインターフェースの背後に隠します。出力、ツール引数、引用、構造化データは、信頼できない入力として扱います。キャンセル、タイムアウト、再試行、部分的な結果、クォータ、オフライン、未対応機能に対する動作を定義してください。

条件に応じてリファレンスを読み込む

• クライアントとバックエンドの責務、認証情報、プロバイダーの抽象化、安全性、プライバシー、モデル設定を選択する場合は、サービス境界とシークレットを読んでください。
• ストリーミング出力、会話、添付ファイル、構造化レスポンス、ツール／関数呼び出しを実装する場合は、ストリーミング、ツール、状態を読んでください。
• プロジェクトでこれらの Flutter パッケージを使用している、または使用を検討している場合に限り、Flutter AI Toolkit と GenUIを読んでください。デフォルトで導入しないでください。

境界

• flutter-networking は汎用 HTTP、WebSocket、SSE、認証の更新、トランスポートの信頼性を担当します。このスキルはその上位のモデル固有のセマンティクスを担当します。
• dart-concurrency は一般的なストリームの競合、キャンセルのプリミティブ、アイソレートの動作を担当します。
• flutter-persistence は永続ストレージとオフライン同期を担当します。このスキルは、会話やモデルの状態のうち保持してよいものを定義します。
• flutter-security は広範な脅威レビューを担当します。このスキルは、モデル境界、認証情報の配置、信頼できない出力の処理、最小権限のツールを徹底します。
• flutter-ui-patterns と flutter-accessibility は、一般的なインターフェースの構成とアクセシビリティを担当します。

検証

通常の自動テストには、決定論的な偽モデルまたは記録済みのアダプターを使用します。部分チャンク、キャンセル、タイムアウト、不正な構造化出力、ツールの拒否と失敗、イベントの重複または順序の入れ替わり、クォータエラー、プロバイダーの利用不能を網羅してください。実際のプロバイダーを使用するのは、認証情報、費用、ネットワークアクセス、実行環境が明示的に対象範囲に含まれている場合に限ります。そのようなテストは分離し、破壊的な操作を避けてください。

影響を受けるプラットフォームで、必要に応じて再起動や復元も含め、表示されるストリームと状態遷移を検証します。偽モデルでテストした動作、エンドツーエンドで実行した動作、該当する場合は正確なプロバイダー／モデル設定、未検証の費用、安全性、バックエンドとの境界を報告してください。

参照元

• Flutter AI の概要
• Flutter AI Toolkit
• Flutter GenUI
• Flutter のネットワーキング