basket-builder
ChatGPTDescription Use this tool when the user describes a scenario, goal, occasion, or life situation and needs help figuring out what items (often multiple) to buy across several product categories. This includes cases like planning events, preparing for travel, starting a lifestyle change, organizing a space, or choosing a gift when no specific product type is mentioned. It should also be used when the user cites a broad category such as "electronics" or "clothing" where many unrelated product types could apply, indicating they have not yet identified a specific item. Critical Instruction: Preserve User Intent When calling this tool, preserve the user's actual stated intent as closely as possible. Do: - Keep the query faithful to what the user actually asked. - Preserve explicit constraints, preferences, and product types mentioned by the user. - Use only light normalization for clarity, such as removing filler words or rewriting fragments into a grammatical sentence. Do not: - Add product categories, quantities, budget constraints, accessories, or preferences that the user did not explicitly state. - Turn a broad request into a more specific shopping list. - Infer "helpful extras" unless the user asked for extras. - Infer quantities unless the user asked for quantities. - Infer price sensitivity, "budget-friendly" preferences, brands, sizes, flavors, or event logistics unless explicitly stated. If the request is underspecified: - Prefer passing the underspecified request through as written. - Ask a follow-up question only if missing information is necessary to fulfill the request correctly. - Never guess details just to make the query more specific. Query Construction Rules The userQuery.query field should be: - A faithful restatement of the user's request - Minimal and close to the original wording - Free of invented details Good examples: - User: "Plan a movie night with my friends" Tool query: "Plan a movie night with my friends" - User: "Help me get snacks and drinks for a movie night" Tool query: "Help me get snacks and drinks for a movie night" - User: "Need popcorn, soda, and paper plates for 6 people" Tool query: "Need popcorn, soda, and paper plates for 6 people" Bad examples: - User: "Plan a movie night with my friends" Tool query: "Create a Walmart shopping list with popcorn, candy, chips, soda, sparkling water, frozen pizza, plates, cups, napkins, blankets, and trash bags" - User: "Need snacks for game night" Tool query: "Budget-friendly chips, dips, wings, soda, paper towels, and party trays for 8 guests" Call This Tool When - The user describes a scenario, goal, or event, and the request involves multiple potential product types rather than one. - The user has not identified a specific product type and is looking for guidance on categories or options. - The user mentions a broad category that contains many unrelated subcategories, indicating they are unsure which product type they actually need Do NOT Call This Tool When The user explicitly names a specific product type, even if tied to a scenario: "4K TV for my bedroom" "Best backpack for Europe" "Noise-cancelling headphones for travel" The user is choosing one product or comparing options within a single product type. The user shows clear purchase intent for a single, defined product category. Output Expectations Return products and categories that match the user's stated request. Any additional structure should come from the tool's retrieval logic, not from invented details added to the query.
checkout_session
ChatGPTDescriptions This tool is triggered when a user clicks the Walmart Buy button from the ChatGPT native product search results. Its purpose is to generate frequently bought together complementary product suggestions for the primary product that the user intends to purchase. Given a primary product, the tool analyzes common customer behavior, usage context, and accessory needs to produce broad complementary product categories, each with a priority level and multiple complementary products inside this category.
complete_checkout
ChatGPTDescription: This tool creates a place order
create-delivery-address
ChatGPTDescription: This tool creates a new delivery address for the authenticated Walmart customer. It handles the creation of a personal delivery address by accepting address details and persisting them to the customer's account via the Walmart GraphQL API. This tool is NOT intended to be called by AI assistants or agents. It is an internal system tool invoked automatically when users add a new delivery address through the UI. When to call this tool Call this tool when the user: NEVER. This tool should never be called by AI assistants. It is reserved for internal system use only to create delivery addresses. Do NOT call this tool Do not call this tool under any circumstances: - When users ask about delivery addresses (provide informational guidance instead) - When users want to update or modify existing addresses (use appropriate update tools) - When users are browsing or shopping for products - At any time - this is a system-only tool not meant for AI agent invocation Output expectations The tool returns the created delivery address details including: N/A - This tool should never be invoked by AI assistants.
fetch-gic
ChatGPTDescription: This tool retrieves guest information capture (GIC) data including addresses, stores, and available time slots based on the specified fulfillment type. It provides essential information for order fulfillment options. When to call this tool Call this tool when the user: - Needs to retrieve saved addresses for shipping or delivery - Wants to find available store locations for pickup - Requests available time slots for delivery or pickup - Asks about fulfillment options (pickup, shipping, delivery) Do NOT call this tool Do not call this tool when: - The user is searching for products - The user is asking about product details - The user wants to add items to cart - No fulfillment-related information is needed Output expectations The tool returns structured data including: - Addresses: Customer addresses with fulfillment support details (for shipping/delivery) - Stores: Store locations with address information (for pickup/delivery) - Time Slots: Available fulfillment time slots with pricing (for delivery/pickup)
fetch-items-availability
ChatGPTDescription: This tool retrieves item availability information including product details, pricing, seller information, availability, and fulfillment options for items in the user's cart. It calls the Item Read Operations (IRO) API to fetch comprehensive offer-level data for one or more cart items identified by their offer IDs. This tool is used internally to render and display detailed cart information within the Walmart shopping experience. This tool is NOT intended to be called by AI assistants or agents. It is a system component invoked automatically when cart details are needed. When to call this tool Call this tool when the user: NEVER. This tool should never be called by AI assistants. It is reserved for internal system use only to display cart item details. Do NOT call this tool Do not call this tool when: Do not call this tool under any circumstances: - When users ask about cart information (use appropriate cart or checkout tools instead) - When users want to view their cart (the system will handle navigation automatically) - When users are browsing or shopping for products - At any time - this is a UI-only tool not meant for AI agent invocation Output expectations The tool returns detailed cart item information including: N/A - This tool should never be invoked by AI assistants.
get-walmart-plus-plans
ChatGPTDescription: Returns the available Walmart+ membership plans and their tenure pricing (annual BASE365 / monthly BASE30) by calling the MembershipPlans GraphQL query. Use this to display the membership price (e.g. "$98/yr" / "$12.95/mo") when offering Walmart+, independent of and before the member-pricing opt-in. This is a private, widget-invoked tool (openai/visibility: private): the widget calls it programmatically when rendering the Walmart+ offer. It is hidden from the model and is not meant to be selected by the assistant during conversation — for Walmart+ questions, respond conversationally instead of invoking this tool. Output expectations The tool returns the membership plan (id, name) and its available tenures, each with pricing fields (price, monthlyCost, annualCost, discountedPrice, annual savings, comparable "was" price), plus program flags (e.g. whether a payment id is required).
list-cards
ChatGPTDescription: This tool list a walmart cards
opt-walmart-plus
ChatGPTDescription: Toggles Walmart+ member pricing on the current purchase contract by calling the updateOptInStatusforPaidSignUp GraphQL mutation (the same Orchestration operation used by walmart.com / commerce-apis). Returns the re-priced order with member discounts and waived-fee strikethroughs applied. This is a private, widget-invoked tool (openai/visibility: private): the cart / Review Order UI calls it programmatically when the user flips the Walmart+ toggle. It is hidden from the model and is not meant to be selected by the assistant during conversation — for Walmart+ questions, respond conversationally instead of invoking this tool. Output expectations The tool returns the purchase contract id and tender plan id, a Walmart+ enrollment snapshot (active member, opt-in state, banner flags), and the re-priced totals/fees (member discounts + strikethroughs, with the membership fee under priceDetails.membershipFee) so the widget can refresh its order summary and banner state without an extra round-trip.
product-detail-page
ChatGPTDescription: This tool retrieves and displays comprehensive product information for a specific Walmart item. This tool is used internally to render and display detailed product information pages within the Walmart shopping experience. It handles the presentation layer for individual product pages, showing specifications, pricing, reviews, images, and purchase options. Use this tool when a user wants to see complete details about a specific product they've identified by its Item ID or when they need in-depth information about a particular product. This tool is NOT intended to be called by AI assistants or agents. It is a UI rendering component that is invoked automatically by the system when users navigate to product detail pages. When to call this tool Call this tool when the user: NEVER. This tool should never be called by AI assistants. It is reserved for internal system use only to display product information. Do NOT call this tool Do not call this tool when: Do not call this tool under any circumstances: - When users ask about product information (use appropriate search or discovery tools instead) - When users want to view product details (the system will handle navigation automatically) - When users are shopping or browsing products - At any time - this is a UI-only tool not meant for AI agent invocation Output expectations The tool returns detailed product information including: N/A - This tool should never be invoked by AI assistants.
product-recommendations
ChatGPTDescriptions Tools purpose is to generate frequently bought together complementary product suggestions for the primary product that the user intends to purchase. Given a primary product, the tool analyzes common customer behavior, usage context, and accessory needs to produce broad complementary product categories, each with a priority level and multiple complementary products inside this category.
product-search
ChatGPTDescriptions This tool helps users find a specific product type they want to buy, even when they mention a scenario (e.g., travel, small apartment, allergies). It identifies the best matching main products and recommends relevant complementary items. Typical Use Cases Requests for specific product types: "Good noise-cancelling headphones for travel" "Laptop under $600" "Top cordless stick vacuum" "Best 55-inch 4K TV" Product searches with constraints: Feature requirements Brand preferences When to Call This Tool Call this tool when: The user explicitly names a specific product type, even if a scenario is included: "headphones for travel" "air purifier for allergies" "camera for wildlife" The user expresses clear purchase intent for a single product category. The user is refining their choice via features, specs, budget, size, or brand. *When Not to Call This Tool Do not call this tool when: The user describes a broad scenario without asking for a specific product type (e.g., "packing for a beach trip," "hosting a BBQ"). The user wants a general checklist rather than a specific item. The user is only seeking informational guidance (not shopping intent). Output Expectations Best Match: Top-ranking product matching the request Deals: Relevant discounted options Frequently Bought Together:* Complementary items
request-checkout
ChatGPTDescription: This tool creates a checkout session for the specified items in a Walmart US shopping cart.
set-shipping-address
ChatGPTDescription: This tool updates the shipping address for the checkout session.
