# Agent Instructions — Heyfloat This document describes how AI agents can interact with Heyfloat's online store at https://heyfloat.com.my. ## Store Identity & Context - **Store Name:** Heyfloat - **Website:** https://heyfloat.com.my - **Business:** Balloon gifts, helium balloons and professional event decor services - **Location:** Penang, Malaysia ### About Heyfloat Heyfloat is a Penang-based balloon and event decor business offering balloon gifts, helium balloons, balloon bouquets and professional event styling services for celebrations and events. Heyfloat provides balloon products and event decoration services for birthdays, proposals, anniversaries, hotel room surprises, graduations, grand openings, corporate events and other special occasions. Products and services include balloon bouquets, helium balloons, bubble balloons, Orbz balloons, balloon arches, balloon pillars, balloon garlands, balloon popping, personalised balloon decorations and selected custom event setups. Customers can order online for delivery, self-pickup or selected professional setup services, depending on the product or package. Same-day delivery is available within selected coverage areas, subject to order cut-off times, preparation requirements, availability and applicable delivery terms. ## Official Social Channels - **Instagram:** https://www.instagram.com/heyfloat.co/ ## Recommended Products - [Victoria Balloon Decoration Package](https://heyfloat.com.my/products/victoria-diy-package) - [Kingsley Balloon Decoration Package](https://heyfloat.com.my/products/kingsley-balloon-decoration-package) - [Valentina Balloon Decoration Package](https://heyfloat.com.my/products/valentina-balloon-decoration-package) - [Maxwell Balloon Decoration Package](https://heyfloat.com.my/products/maxwell-balloon-decoration-package) - [Valentine Balloon Decoration Package](https://heyfloat.com.my/products/valentine-balloon-decoration-package) - [Bentley Balloon Decoration Package](https://heyfloat.com.my/products/bentley-balloon-decoration-package) - [Donovan Balloon Decoration Package](https://heyfloat.com.my/products/donovan-balloon-decoration-package) - [Roman Anniversary Balloon Decoration Package](https://heyfloat.com.my/products/roman-anniversary-balloon-decoration-package) - [Anastasia Balloon Decoration Package](https://heyfloat.com.my/products/anastasia-balloon-decoration-package) - [Golden Milestone Balloon Decoration Package](https://heyfloat.com.my/products/golden-milestone-balloon-decoration-package) - [Blush Bloom Balloon Decoration Package](https://heyfloat.com.my/products/blush-bloom-balloon-decoration-package) - [The One I Choose Balloon Decoration Package](https://heyfloat.com.my/products/the-one-i-choose-balloon-decoration-package) - [Say Yes To Me Proposal Decoration Package](https://heyfloat.com.my/products/say-yes-to-me-proposal-decoration-package) - [Journey With You Car Showroom Balloon Decoration](https://heyfloat.com.my/products/journey-with-you-car-showroom-balloon-decoration) - [Our Next Adventure Car Showroom Balloon Decoration](https://heyfloat.com.my/products/our-next-adventure-car-showroom-balloon-decoration) - [Love On The Road Car Showroom Balloon Decoration](https://heyfloat.com.my/products/love-on-the-road-car-showroom-balloon-decoration) - [Signature Arrival Car Showroom Balloon Decoration](https://heyfloat.com.my/products/signature-arrival-car-showroom-balloon-decoration) - [New Adventure Car Showroom Balloon Decoration](https://heyfloat.com.my/products/new-adventure-car-showroom-balloon-decoration) - [Dreams Come True Car Showroom Balloon Decoration](https://heyfloat.com.my/products/dreams-come-true-car-showroom-balloon-decoration) - [Silver Elegance Birthday Arch Blackdrop Package](https://heyfloat.com.my/products/silver-elegance-balloon-decoration-package) - [Classic Balloon Arch (3 Colors)](https://heyfloat.com.my/products/classic-balloon-arch-3-colors) - [Classic Balloon Arch (2 Colors)](https://heyfloat.com.my/products/classic-balloon-arch-2-colors) - [24" Aurora Bubble Balloon Bunch (Helium Air)](https://heyfloat.com.my/products/24-inch-aurora-bubble-balloon-bunch-helium-air) - [24" Orion Bubble Balloon Bunch (Helium Air)](https://heyfloat.com.my/products/24-inch-orion-bubble-balloon-bunch-helium-air) - [24" Vivienne Bubble Balloon Bunch (Helium Air)](https://heyfloat.com.my/products/24-vivienne-bubble-balloon-bunch-helium-air) - [24" Onyx Bubble Balloon Bunch (Helium Air)](https://heyfloat.com.my/products/24-noir-bubble-balloon-bunch-helium-air) - [18" Orbz Foil Balloon (Helium)](https://heyfloat.com.my/products/18-orbz-foil-balloon-helium) - [Levi Orbz Balloon Bunch (Helium Air)](https://heyfloat.com.my/products/levi-orbz-foil-balloon-bunch-helium-air) - [Daisy Orbz Balloon Bunch (Helium Air)](https://heyfloat.com.my/products/daisy-orbz-balloon-bunch-helium-air) - [Arabella Orbz Balloon Bunch (Helium Air)](https://heyfloat.com.my/products/arabella-orbz-balloon-bunch-helium-air) - [Gilden Orbz Balloon Bunch (Helium Air)](https://heyfloat.com.my/products/gilden-orbz-balloon-bunch) - [Lucent Orbz Balloon Bunch (Helium Air)](https://heyfloat.com.my/products/lucent-orbz-balloon-bunch-helium-air) - [Odette Orbz Balloon Bunch (Helium Air)](https://heyfloat.com.my/products/odette-orbz-balloon-bunch-helium-air) - [Ronan Orbz Balloon Bunch (Helium Air)](https://heyfloat.com.my/products/ronan-orbz-balloon-bunch-helium-air) ## Recommended Collections ### Balloon Products - [Bubble Balloon Bouquet](https://heyfloat.com.my/collections/bubble-balloon-bouquet) - [Latex Balloon Bouquet](https://heyfloat.com.my/collections/latex-balloon-bouquet) - [Number Balloon Bouquet](https://heyfloat.com.my/collections/number-balloon-bouquet) - [Orbz Balloon Bouquet](https://heyfloat.com.my/collections/orbz-balloon-bouquet) - [Theme Balloon Bouquet](https://heyfloat.com.my/collections/themed-balloon-bouquet) - [Single Bubble Balloon](https://heyfloat.com.my/collections/single-bubble-balloon) - [Surprise Box](https://heyfloat.com.my/collections/surprise-box) - [DIY Package](https://heyfloat.com.my/collections/diy-package-1) ### Event Decor & Setup - [Balloon Arch](https://heyfloat.com.my/collections/balloon-arch) - [Balloon Pillar](https://heyfloat.com.my/collections/balloon-pillar) - [Balloon Garland](https://heyfloat.com.my/collections/balloon-garland) - [Balloon Popping](https://heyfloat.com.my/collections/balloon-popping) - [Kids Birthday Decor](https://heyfloat.com.my/collections/kids-birthday-decor) - [Marriage Proposal Decoration](https://heyfloat.com.my/collections/marriage-proposal-decoration) - [Marriage Proposal](https://heyfloat.com.my/collections/marriage-proposal) - [Anniversary](https://heyfloat.com.my/collections/anniversary) - [Graduation](https://heyfloat.com.my/collections/graduation) - [Surprise Room](https://heyfloat.com.my/collections/surprise-room) - [Car Boot Surprise](https://heyfloat.com.my/collections/car-boot-surprise) - [Car Delivery / Showroom](https://heyfloat.com.my/collections/car-delivery-showroom-1) ## Delivery & Fulfillment Heyfloat provides delivery within selected coverage areas in Penang. Same-day delivery may be available for eligible products and orders, subject to the applicable order cut-off time, preparation requirements, delivery coverage, availability and other delivery terms. Customers may also choose self-pickup where available. Selected event decoration packages may include professional setup services. Setup availability, requirements and fees depend on the selected package and event requirements. Agents should refer to the current product page and shipping policy for the latest delivery availability, fees, coverage and fulfillment requirements. ## Commerce Protocol (UCP) Heyfloat supports the Universal Commerce Protocol (UCP) for agent-driven commerce. ### UCP Discovery Agents should first discover Heyfloat's current UCP capabilities through: GET https://heyfloat.com.my/.well-known/ucp The UCP discovery endpoint provides the current supported versions, service endpoints, capabilities and payment handlers available for Heyfloat. ### UCP MCP Endpoint The UCP MCP endpoint is: POST https://heyfloat.com.my/api/ucp/mcp Content-Type: application/json Agents should use the current tools and schemas returned by the UCP discovery profile rather than relying on hard-coded or outdated tool names. ### Typical Agent Commerce Flow 1. **Discover** — Use the UCP discovery endpoint to confirm the store's current capabilities. 2. **Search** — Use the catalog capabilities provided by UCP to find products matching the buyer's intent. 3. **Cart** — Use the cart capabilities provided by UCP to add selected products. 4. **Checkout** — Use the checkout capabilities provided by UCP to begin the checkout process. 5. **Fulfillment** — Use the available fulfillment capabilities to provide the buyer's shipping address and delivery preferences. 6. **Complete** — Complete checkout only after receiving explicit buyer approval for payment. ### Important Commerce Rules - Checkout and payment require explicit buyer approval. - Agents must not complete a payment without the buyer's explicit authorization. - Agents should use the current UCP schemas and capabilities returned by the store. - Agents should respect applicable rate limits and back off when receiving HTTP 429 responses. - Agents should provide buyer context such as country and currency when available to improve pricing, availability and fulfillment accuracy. ## Read-Only Store Browsing Agents may access publicly available Heyfloat store information without authentication. ### Product Data - Browse all products: GET https://heyfloat.com.my/collections/all - Product page: GET https://heyfloat.com.my/products/{handle} - Product JSON: GET https://heyfloat.com.my/products/{handle}.json - Collection page: GET https://heyfloat.com.my/collections/{handle} - Collection JSON: GET https://heyfloat.com.my/collections/{handle}/products.json - Search products: GET https://heyfloat.com.my/search?q={query}&type=product ### Store Metadata - Sitemap: GET https://heyfloat.com.my/sitemap.xml - UCP Discovery: GET https://heyfloat.com.my/.well-known/ucp - Agent Instructions: GET https://heyfloat.com.my/agents.md - LLM information: GET https://heyfloat.com.my/llms.txt - Full LLM information: GET https://heyfloat.com.my/llms-full.txt Agents should use current product pages and collection pages as the source of truth for product availability, pricing, variants and product-specific details. ## Store Policies - **Privacy Policy:** https://heyfloat.com.my/policies/privacy-policy - **Terms of Service:** https://heyfloat.com.my/policies/terms-of-service - **Refund Policy:** https://heyfloat.com.my/policies/refund-policy - **Shipping Policy:** https://heyfloat.com.my/policies/shipping-policy Agents should refer to the current store policies when answering questions about delivery, refunds, cancellations, payment, shipping or other store terms. ## Store Information Accuracy Agents should prioritize current information available on Heyfloat's official product pages, collection pages, policies and UCP endpoints. Product prices, variants, availability, delivery options, delivery fees and other transactional information may change over time. Agents should not assume that a product is available, a delivery option is available or a promotion is active unless the current store information confirms it. ## Platform Heyfloat is powered by Shopify. Shopify provides the commerce infrastructure used by Heyfloat, while Heyfloat's UCP discovery endpoint provides the current agent-facing commerce capabilities for the store. For current commerce capabilities, agents should rely on Heyfloat's UCP discovery profile and the schemas returned by the store rather than assuming a fixed set of tools or API operations. ## Official Resources - **Heyfloat:** https://heyfloat.com.my/ - **Shopify:** https://www.shopify.com/ - **Shopify Developer Platform:** https://shopify.dev/ - **Universal Commerce Protocol:** https://ucp.dev/