VoiceBit

Add a menu item line to an existing cart. Identify the item by its display name from get_menu. Variant and modifiers are matched by name within the resolved item.

add_to_cart

Empty the cart entirely. Drops every line and invalidates the cart_id; a fresh create_cart is required if the user wants to start over.

clear_cart

Create a new empty cart bound to a restaurant slug. Returns a cart_id you must carry across all subsequent add_to_cart, remove_from_cart, and view_cart calls in this conversation.

create_cart

Fetch a restaurant's menu as structured data for agent reasoning and filtering. By default this returns categories, items, and variants only; set include_modifiers=true only when the user explicitly asks about customization choices. For filtered ChatGPT UI requests such as vegetarian pizzas, use this to identify matching items, answer with the matching text summary, then call render_restaurant_detail with slug plus item_names or item_ids for only those matches.

get_menu

Fetch a single restaurant's profile (hours, service methods, ordering status) as structured data. For broad ChatGPT UI display flows, prefer render_restaurant_detail with the slug. For filtered menu flows, pair the slug with get_menu and pass only selected item_names/item_ids to render_restaurant_detail.

get_restaurant

Remove (or decrement) a previously-added line. Without `qty`, removes the most recent matching line entirely; with `qty`, decrements that quantity. Removing the last line keeps the cart_id valid — add more items, call view_cart to check out, or clear_cart to reset.

remove_from_cart

User-facing ChatGPT UI renderer for restaurant search results. Use this after search_restaurants whenever restaurants should be displayed to the user. This is the final display step for show, list, browse, or view restaurant requests.

render_restaurant_carousel

User-facing ChatGPT UI renderer for selected restaurant menu items. For filtered requests like vegetarian pizzas, first use get_menu to find matching items, answer with a concise text summary, then call this with slug plus item_names or item_ids for only those matching items. The server hydrates the selected items with variants/modifiers for the iframe. Do not call this with only a slug for filtered requests; slug-only calls render the broad menu and should be used only when the user explicitly asks for the whole restaurant menu. This surface is read-only for discovery; use add_to_cart/view_cart renderers for cart state and ordering.

render_restaurant_detail

Fetch VoiceBit-marketplace restaurants as structured data. This is an agent-only intermediate method for ChatGPT UI flows. Optional case-insensitive substring filter on name and cuisine. When the user asks to show, list, browse, or view restaurants, you must immediately call render_restaurant_carousel with the returned restaurants before replying to the user.

search_restaurants

WIDGET-ONLY — do NOT call this tool yourself. It is invoked automatically by the cart widget's Place order button once the user has entered their name and phone inside the rendered cart. To let a user check out, call view_cart instead; the widget collects the customer details and submits the order. Calling this directly from the model places a real order with PII in the arguments and will be blocked. Forwards the cart to the VoiceBit ordering backend and returns an order_id plus a redirect_url to the payment page.

submit_order