taams-sourcing-desk.netlify.app

pin_to_comparison_board

Pin one card onto the on-screen comparison board, up to three. A card is a product, optionally narrowed to a single sourcing country — so {product_name:"망고", country:"Thailand"} and {product_name:"망고", country:"Brazil"} are two different cards, each showing that country's own price, trend and supplier count. Call this whenever the user weighs two or more named options against each other, even if they never say the word "compare" — "A or B?", "which is better", "should I go with X or Y" all mean compare. Pin each option as its own card BEFORE you give your recommendation, so the user can see what you are weighing. This changes the user's screen and fetches nothing; it reuses data already loaded. Call get_import_price_trend for the product first if it is not on screen yet.

Input schema

{
  "type": "object",
  "properties": {
    "product_name": {
      "type": "string",
      "description": "Exact product name, already loaded on screen this session."
    },
    "country": {
      "type": "string",
      "description": "Optional. Narrow this card to one sourcing country, English or Korean, e.g. \"Thailand\". Omit for a card covering every country."
    }
  },
  "required": [
    "product_name"
  ]
}