MyProduct: Create AI Mapping Task
start_ai_product_mapping[Store Products]
[What it does] Starts an asynchronous AI Mapping computation between one DSers product and one supplier candidate; it does not apply the resulting mapping.
[When to use] Use after the merchant selects a supplier candidate for that product.
[When not to use] To find or compare candidates, use search_ai_mapping_candidates; this tool cannot apply a computed mapping — that requires the mapping-apply tool associated with get_store_product_mapping.
[How to use] Copy dsers_product_id from list_managed_store_products; copy supplier_platform_id and supplier_product_id from the same search_ai_mapping_candidates candidate. Read task_created and next_step before acting: a newly created task has task_created=true; a false value can point to an existing task, an existing completed result to apply, or an Applied result requiring confirmed remap. Follow the returned status_tool only when present, using its task_type and task_id; do not treat running status as completion.
[Side effects] A response with task_created=true consumes 8 AI Credits and creates a computation task; history-only responses create nothing, consume no Credits, and leave the product mapping unchanged.
[Confirmation] Requires explicit, non-skippable confirmation; show the exact product, candidate, and 8 AI Credits cost first.
[Follow-up] Follow next_step: poll an indicated new or existing task until terminal, apply an indicated completed result only after its separate confirmation, or show the remap preview before calling again with remap=true.
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>",
"supplier_platform_id": "<supplier_platform_id>",
"supplier_product_id": "<supplier_product_id>"
},
"name": "start_ai_product_mapping"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| remap | No | Set true only after the latest Candidate Search shows StatusApply for this exact candidate and the user explicitly confirms the displayed Applied remap preview. It creates a new AI Mapping computation and does not apply a Mapping. | |
| country | No | Destination country for the AI Mapping task. Copy the same country used as ship_to in the prerequisite Candidate Search; defaults to US. | US |
| dsers_product_id | Yes | Copy from items[].dsers_product_id in list_managed_store_products results. Required. | |
| supplier_product_id | Yes | Copy from supplier_product_id in search_ai_mapping_candidates results. Required. | |
| supplier_platform_id | Yes | Copy from supplier_platform_id in search_ai_mapping_candidates results. Required. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | Initial normalized task status | |
| country | Yes | Destination country used by AI Mapping | |
| history | Yes | Latest matched candidate job ID, progress, and application status when present | |
| message | Yes | Human-readable task outcome | |
| task_id | Yes | Product BFF AI Mapping task ID as a decimal string | |
| accepted | Yes | Whether Product BFF accepted the AI Mapping task | |
| next_step | Yes | Machine-readable next action | |
| operation | Yes | Started business operation | |
| task_type | Yes | Task type to pass to status_tool | |
| status_tool | Yes | Tool used to poll this task | |
| task_created | Yes | Whether this call created a new AI Mapping task | |
| history_count | Yes | Number of prior jobs included; currently zero or one latest candidate job | |
| history_found | Yes | Whether the exact matched candidate returned a latest AI Mapping job | |
| dsers_product_id | Yes | Source DSers My Product ID as a decimal string | |
| poll_after_seconds | Yes | Recommended delay before polling | |
| supplier_product_id | Yes | Selected supplier product ID | |
| supplier_platform_id | Yes | Selected supplier platform ID as a decimal string | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. |