pcbox.com

{
  "name": "search_products",
  "kind": "answer",
  "impl": "imperative",
  "description": "Busca productos en el catálogo de la tienda por texto libre. Devuelve nombre, precio, disponibilidad, SKU y URL de cada resultado. NO navega ni añade nada al carrito: usa navigate_to para llevar al usuario a los resultados y add_to_cart para comprar.",
  "inputSchema": {
    "type": "object",
    "required": [
      "query"
    ],
    "properties": {
      "query": {
        "type": "string",
        "description": "Texto a buscar, ej. \"iphone 15\", \"portátil gaming\", \"cartucho HP 302\""
      },
      "limit": {
        "type": "integer",
        "description": "Número máximo de resultados (1-50). Por defecto 10.",
        "minimum": 1,
        "maximum": 50
      }
    }
  }
}

{
  "name": "get_product",
  "kind": "answer",
  "impl": "imperative",
  "description": "Obtiene el detalle completo de un producto a partir de su ID o SKU (el campo «id» que devuelve search_products). Úsalo antes de add_to_cart para confirmar precio y stock.",
  "inputSchema": {
    "type": "object",
    "required": [
      "product_id"
    ],
    "properties": {
      "product_id": {
        "type": "string",
        "description": "ID o SKU del producto en VTEX"
      }
    }
  }
}

{
  "name": "browse_categories",
  "kind": "answer",
  "impl": "imperative",
  "description": "Devuelve el árbol de categorías de la tienda con sus URLs. Úsalo cuando el usuario quiera explorar el catálogo por secciones en lugar de buscar un producto concreto.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  }
}

{
  "name": "get_cart",
  "kind": "answer",
  "impl": "imperative",
  "description": "Devuelve el contenido actual del carrito: líneas con nombre, SKU, cantidad, precio unitario y totales. Funciona desde cualquier página.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  }
}

{
  "name": "add_to_cart",
  "kind": "act",
  "impl": "imperative",
  "description": "Añade un producto al carrito por su SKU. Obtén el SKU con search_products o get_product; nunca lo inventes. La cantidad es incremental: llamar dos veces con quantity=1 deja 2 unidades.",
  "inputSchema": {
    "type": "object",
    "required": [
      "sku_id"
    ],
    "properties": {
      "sku_id": {
        "type": "string",
        "description": "SKU del producto (campo «id» de search_products)"
      },
      "quantity": {
        "type": "integer",
        "description": "Unidades a añadir. Por defecto 1.",
        "minimum": 1
      },
      "seller": {
        "type": "string",
        "description": "ID del vendedor en VTEX. Por defecto \"1\"."
      }
    }
  }
}

{
  "name": "update_cart_item",
  "kind": "act",
  "impl": "imperative",
  "description": "Cambia la cantidad de una línea del carrito o la elimina. La cantidad es absoluta, no un incremento: quantity=0 elimina la línea. Identifica la línea con el SKU que devuelve get_cart.",
  "inputSchema": {
    "type": "object",
    "required": [
      "sku_id",
      "quantity"
    ],
    "properties": {
      "sku_id": {
        "type": "string",
        "description": "SKU de la línea a modificar"
      },
      "quantity": {
        "type": "integer",
        "description": "Cantidad final. 0 elimina la línea.",
        "minimum": 0
      }
    }
  }
}

{
  "name": "navigate_to",
  "kind": "act",
  "impl": "imperative",
  "description": "Lleva el navegador del usuario a una página de la tienda: resultados de búsqueda, ficha de producto, categoría o carrito. Usa las rutas que devuelven las demás tools; no construyas URLs a mano. Tras esta llamada el usuario YA está en la página: no le pidas que haga clic en ningún enlace ni vuelvas a navegar.",
  "inputSchema": {
    "type": "object",
    "required": [
      "path"
    ],
    "properties": {
      "path": {
        "type": "string",
        "description": "Ruta interna que empieza por \"/\", ej. \"/search?q=iphone\", \"/product/mi-producto\", \"/cart\""
      }
    }
  }
}

{
  "name": "go_to_checkout",
  "kind": "transact",
  "impl": "imperative",
  "description": "Lleva al usuario al checkout para finalizar la compra. Requiere el carrito con al menos un artículo. Tras esta llamada el usuario ya está en el checkout: no navegues de nuevo.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  }
}