MyProduct: Apply AI Mapping Result
apply_ai_mapping[Store Products]
[What it does] Applies one already-completed and user-confirmed AI Mapping task result to a product's live supplier variant mapping used for future fulfillment.
[When to use] Use after an AI Mapping task has succeeded and the user has reviewed and confirmed the final product/supplier preview, to commit that result.
[When not to use] To search AI Mapping candidates or create the mapping task, use the corresponding candidate-search or create tools. Never call this on an unconfirmed or still-running task.
[How to use] task_id is required and must belong to the current account with status ProgressSuccess. The tool rechecks task ownership and status immediately before writing; if already applied, it returns without re-writing. The write is sent once — if the outcome is unknown, re-check with get_job_status/get_store_product_mapping rather than retrying.
[Side effects] Changes the product's live supplier mapping used for future order fulfillment.
[Confirmation] Required, never skippable: show the exact product/supplier/task preview and get an explicit second confirmation before calling.
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": {
"task_id": "<task_id>"
},
"name": "apply_ai_mapping"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | Exact completed AI Mapping task ID shown in the final apply preview and approved by the user's latest explicit second confirmation. It must belong to the authenticated account and currently have ProgressSuccess. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| applied | Yes | Whether this call applied the AI Mapping result | |
| message | Yes | Human-readable operation result | |
| task_id | Yes | Exact Product BFF AI Mapping task ID | |
| operation | Yes | Completed business operation | |
| final_status | Yes | Final known AI Mapping application status | |
| already_applied | Yes | Whether the AI Mapping task was already applied before this call | |
| previous_status | Yes | AI Mapping application status checked immediately before the write | |
| previous_progress | Yes | AI Mapping task progress checked immediately before the write | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. |