analyze_interior_photo
ChatGPTUse this when the user explicitly asks to analyze an attached room or interior photo for suitable artwork. Measures the photo's palette and returns room-specific art direction. Processes the image without storing it or creating a job. The user must select the photo; no additional confirmation is required.
create_print_checkout
ChatGPTUse this when the user explicitly asks to continue with an exact print or basket selection. Creates a Create Prints checkout session and link but does not charge the user; payment and delivery details are entered on the external checkout page. Requires confirmation of every print, quantity, and required frame colour.
get_artwork_status
ChatGPTUse this when the user explicitly asks for the status of a Create Prints artwork job, and to wait for one that is generating: while it reports processing, call it again about every 30 seconds until it reports complete or failed, instead of ending your turn promising to check back. Read-only; it does not change the job. No confirmation is required.
get_checkout_status
ChatGPTUse this when the user explicitly asks to track a Create Prints checkout or order. Returns customer-facing payment, order, and shipment status. Read-only; it does not change the order. No confirmation is required.
get_room_art_brief
ChatGPTUse this when the user wants artwork or wall art ideas for a specific room or wall and has not provided a room photo. Returns room-specific mood, palette, and prompt guidance. Read-only; it does not change account data. No confirmation is required.
import_artwork
ChatGPTUse this when the user wants an image attached or visible in the chat, including a ChatGPT-generated result, printed, framed, or on their wall. Pass it directly; do not ask the user to upload, reselect, save, download, or resend it. Not for digital-only edits. Uploads it to Create Prints and stores it only if accepted; it does not order, charge, create checkout, or start production.
list_artworks
ChatGPTUse this when the user explicitly asks to see recent Create Prints artworks or find one ready to order. Returns artwork titles, readiness, and references. Read-only; it does not change artwork or create checkout. No confirmation is required.
list_frame_options
ChatGPTUse this when the user explicitly asks to choose a frame colour for a selected framed print. Returns the compatible frame choices and selected print details. Read-only; it does not create checkout or place an order. No confirmation is required to view the choices.
list_orders
ChatGPTUse this when the user explicitly asks to see recent Create Prints orders or find one to track. Returns customer-facing order summaries and references. Read-only; it does not change orders. No confirmation is required.
list_print_options
ChatGPTUse this when the user wants to buy a physical print, poster, or framed wall art, or asks about print sizes, formats, frames, or prices for artwork. Returns compatible variants, prices, postage, and frame requirements, and may render a picker. Read-only; it does not create an order or checkout. Printing a warned image as-is requires explicit confirmation.
open_print_studio
ChatGPTUse this when the user explicitly asks to preview or customise a physical print. With no arguments, resumes the user's saved print selection when available or opens their artwork library. A jobId previews that artwork. Optional productVariantId and frameOptionId change the preview using the returned catalogue. Read-only; never creates checkout.
save_print_studio_selection
ChatGPTUse this when the user changes a print selection in Print studio. Saves artwork, product and frame IDs privately so the user can resume later; does not create checkout or an order. Called by the app UI.
score_artwork_for_room
ChatGPTUse this when the user wants to know how well an artwork suits a room or to compare room fit. Returns a fit score, rationale, and adjustment suggestions from an image, artwork job, or supplied colours. Read-only; images are analyzed without being imported or stored. No confirmation is required.
