Skip to content
Get packs

Retail Product Search Agent

Builds a semantic product search agent on Google Cloud with BigQuery and Vector Search

Source Download skill
Repository
google/adk-recipes
Stars
10,568
Licence
Apache-2.0
Files
15 files

What it does

Once installed, the agent can walk you through building a shopping or product search assistant on Google Cloud. It loads a product catalog (a bundled 5-product demo CSV or your own file) into BigQuery, sets up a Vector Search collection for meaning-based lookup, scaffolds an ADK agent, and prepares evaluation and Cloud Run deployment. It asks a short set of setup questions first and then runs setup scripts that create cloud resources.

Great for

  • Developers building an e-commerce or catalog search assistant on Google Cloud
  • Teams prototyping a retail RAG agent who want a guided, scripted setup
  • Students learning how semantic search and ADK agents fit together with a demo catalog

Skip it if

  • Generic document search or simple keyword search, which the skill itself says it does not cover
  • Running in an environment where you cannot create GCP projects or incur cloud charges, since setup provisions BigQuery datasets and Vector Search collections
  • Production use with sensitive customer data without reviewing the IAM and network setup first

Try asking

  • “Build a product search agent for my online shoe store using the sample catalog”
  • “Ingest my products.csv from gs://my-bucket into Vector Search and make a shopping assistant”
  • “Set up semantic catalog discovery for my GCP project in full setup mode”
  • “Deploy a retail RAG agent to Cloud Run after evaluating it”
Step-by-step guide: how to use Retail Product Search AgentInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 15 original files, the Apache-2.0 licence and an attribution note.

    product-search.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip product-search.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip product-search.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Use Quick Start with the bundled sample CSV first to confirm your GCP setup works before pointing it at real data
  • Review design-spec.md and the project ID before letting setup run, since it creates cloud resources that may cost money
  • Run cleanup.py with care; it is the teardown script and should be run deliberately after testing

What's inside

  • assets/design-spec.md
  • assets/sample-products.csv
  • EVAL.yaml
  • pyproject.toml
  • README.md
  • references/agent-example.md
  • references/architecture.md
  • references/dependencies.md
  • references/ingestion-scripts.md
  • references/install-paths.md
  • references/troubleshooting.md
  • scripts/__init__.py
  • scripts/_paths.py
  • scripts/_setup_utils.py
  • SKILL.md

Redistributed unmodified from google/adk-recipes under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.