AI Device Recommendation Workflow

naftiko: 1.0.0-alpha2
info:
  label: AI Device Recommendation Workflow
  description: >-
    Workflow that uses MobileAPI's natural-language query endpoint to
    translate plain-English questions ("phones with 8GB+ RAM under 200g",
    "best camera phones from 2024") into structured device results, then
    enriches the top match with full specifications and images for a
    conversational recommender experience. Requires a paid plan.
  tags:
    - AI
    - Natural Language Query
    - Recommendation
    - MobileAPI
    - Workflow
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  imports:
    - shared/mobileapi-capability.yaml
  workflow:
    name: ai-device-recommendation
    steps:
      - name: ai-query
        description: Translate the user's natural-language question into structured device results.
        consume:
          namespace: mobileapi
          operation: devices-ai-query
          inputs:
            query: '{{ user_question }}'
      - name: get-top-match
        description: Retrieve the full device record for the top recommendation.
        consume:
          namespace: mobileapi
          operation: devices-read
          inputs:
            id: '{{ top_device_id }}'
      - name: get-images
        description: Fetch product images for the recommended device.
        consume:
          namespace: mobileapi
          operation: devices-images
          inputs:
            id: '{{ top_device_id }}'
      - name: get-camera
        description: Pull the main camera sub-resource for the recommended device.
        consume:
          namespace: mobileapi
          operation: devices-main-camera
          inputs:
            id: '{{ top_device_id }}'