MyProduct: Find AI Mapping Candidates
search_ai_mapping_candidates[Store Products]
[What it does] Finds visually similar supplier item for one DSers product via image search, with price, stock, freight, rating, and similarity evidence; creates or applies no mapping.
[When to use] Use when the merchant wants to compare suppliers before mapping a managed product.
[When not to use] For a general supplier-catalog search, use search_supplier_products; to start the selected mapping computation, use start_ai_product_mapping.
[How to use] Copy dsers_product_id from list_managed_store_products; ship_to sets destination context for availability and freight. Zero matches is a valid result and may include a reason; missing price, rating, or similarity remain unknown.
[Side effects] Read-only; neither creates nor applies a mapping.
[Confirmation] No confirmation required.
[Follow-up] If the merchant selects a suitable candidate, start its computation with start_ai_product_mapping; if none fits, report the result and stop.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"dsers_product_id": "<dsers_product_id>"
},
"name": "search_ai_mapping_candidates"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| refresh | No | When true, ask Product BFF to refresh picture-search candidates instead of using its cache. | |
| ship_to | No | Destination country code used for supplier availability and freight; defaults to US. | US |
| dsers_product_id | Yes | Copy from items[].dsers_product_id in list_managed_store_products results. Required. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ship_to | Yes | Destination country used for supplier and freight lookup | |
| refreshed | Yes | Whether Product BFF was asked to bypass its picture-search cache | |
| candidates | Yes | AI Mapping supplier candidates in upstream recommendation order | |
| next_actions | Yes | Optional follow-up tools; no mapping is created by this search | |
| matched_count | Yes | Number of candidates returned | |
| dsers_product_id | Yes | Source DSers My Product ID as a decimal string | |
| no_result_reason | No | Explanation when no candidates are available | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. |