AIエージェント × モバイルアプリ設計 — 「全部AIにやらせない」関心の分離アーキテクチャ

// React Native / Expo での実装例
 
// 1. AIによる自然言語検索（ネットワーク必要）
async function aiSearch(query: string): Promise<Product[]> {
  // "赤いワンピースで1万円以下のもの" のような自然言語を処理
  const response = await fetch("/api/ai-search", {
    method: "POST",
    body: JSON.stringify({ query })
  });
  return response.json();
}
 
// 2. ローカルフィルター（オフライン対応・決定論的）
function localFilter(
  products: Product[],
  filters: { minPrice?: number; maxPrice?: number; category?: string }
): Product[] {
  return products.filter(p => {
    if (filters.minPrice && p.price < filters.minPrice) return false;
    if (filters.maxPrice && p.price > filters.maxPrice) return false;
    if (filters.category && p.category !== filters.category) return false;
    return true;
  });
}
 
// 3. ローカルソート（決定論的・高速）
function localSort(
  products: Product[],
  sortBy: "price_asc" | "price_desc" | "rating" | "newest"
): Product[] {
  const sorted = [...products];
  switch (sortBy) {
    case "price_asc":
      return sorted.sort((a, b) => a.price - b.price);
    case "price_desc":
      return sorted.sort((a, b) => b.price - a.price);
    case "rating":
      return sorted.sort((a, b) => b.rating - a.rating);
    case "newest":
      return sorted.sort((a, b) =>
        new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime()
      );
  }
}
 
// 統合: AIで検索 → ローカルでフィルター&ソート
async function searchProducts(
  query: string,
  filters: FilterOptions,
  sortBy: SortOption
) {
  // AI検索はネットワークが必要な場合のみ
  const results = navigator.onLine
    ? await aiSearch(query)
    : await localFallbackSearch(query); // オフライン時はローカル検索
 
  // フィルターとソートは常にローカルで実行（高速・決定論的）
  const filtered = localFilter(results, filters);
  return localSort(filtered, sortBy);
}

// カート金額の計算は絶対にAIに任せない
// 同じ入力で同じ結果を返すことが必須
 
interface CartItem {
  productId: string;
  name: string;
  price: number;
  quantity: number;
  taxRate: number;
}
 
function calculateCartTotal(items: CartItem[]) {
  const subtotal = items.reduce(
    (sum, item) => sum + item.price * item.quantity, 0
  );
 
  const tax = items.reduce(
    (sum, item) => sum + Math.floor(item.price * item.quantity * item.taxRate),
    0
  );
 
  const total = subtotal + tax;
 
  return { subtotal, tax, total };
}
 
// 使用例
const cart: CartItem[] = [
  { productId: "001", name: "Tシャツ", price: 2980, quantity: 2, taxRate: 0.1 },
  { productId: "002", name: "パンツ", price: 4980, quantity: 1, taxRate: 0.1 }
];
 
const result = calculateCartTotal(cart);
console.log(`小計: ¥${result.subtotal} / 税: ¥${result.tax} / 合計: ¥${result.total}`);
// 出力: 小計: ¥10940 / 税: ¥1094 / 合計: ¥12034