Catalog Onboarding

Before the Reach Agent can tell you anything about your products, it has to understand them. Catalog Onboarding is that step: it reads your catalog, resolves each product against the graph, and builds the profile every other skill works from.

In Gemini Enterprise this happens when you attach a file. You do not call it directly. See Upload your catalog for the flow you actually use.

What it does with your catalog

Extracts. From an attached CSV, a store URL, or a description of what you sell.

Matches. Each product title is resolved against the product clusters in the graph, which is what connects your vocabulary to buyer vocabulary.

Groups. Your products are organized into groups drawn from their own attributes: material, product type, brand, and the other facets present in your data. These are the groups you see and can tap to scope an answer.

Profiles. The result is a market-position profile: what you carry, where it sits, and the starter questions worth asking about it.

What it returns to you

A grouped view of your catalog, then, once you choose a scope, the analysis itself. The groups arrive first on purpose, because reading a full catalog takes longer than a conversation turn should and seeing your own shelves is a better place to start than a progress bar.

Direct integration

For callers outside Gemini Enterprise, this is a plain JSON endpoint rather than JSON-RPC.

POST /a2a/catalog-onboard-sync

Provide exactly one input:

{"url": "https://mystore.com"}

{"csv_base64": "<base64-encoded CSV with a title column>"}

{"description": "I sell premium kitchen knives and cutting boards"}

The response carries the profile, the number of products extracted, the extraction method used, and the elapsed time.

Field	Meaning
profile	Market-position analysis: groups, top categories, gaps, starter questions
product_count	Products successfully extracted and normalized
extraction_method	How the products were obtained
latency_seconds	Processing time

CSV column requirements are the same as the upload path and are listed in Upload your catalog.