Getir

Returns alternative products for a single keyword in an EXISTING shopping list (identified by `shoppingListId`). Only valid after `getir_plan_shopping_list` has produced a list — do not tell the user to use an on-screen 'Diğer Ürünler' button or widget when no shopping-list widget has been mounted yet. Products in the `excludedProductIds` list are excluded from the returned results.

getir_get_alternatives

Builds a REVIEWABLE multi-product list: one suggested product per keyword that the user can see and swap (via 'Diğer Ürünler') BEFORE anything is added — adding to the cart happens from inside the widget. Use this for 'plan/list' intents: 'haftalık alışveriş listesi yap', 'menemen malzemelerini listele', 'alışveriş listesi hazırla', 'kahvaltılık bir liste çıkar'. If the user instead wants to directly ADD several named products straight to the cart ('süt ekmek yumurta sepete ekle', 'şunları al'), use `getir_bulk_add_to_cart` with the names instead — not this tool. Issue ONE call with ALL of the products in the `items` array; do NOT make several `getir_search_products` calls. Provide the products as `items` with short Turkish names (e.g. for 'menemen': ['Yumurta','Domates','Yeşil Biber','Soğan','Tereyağı','Beyaz Peynir','Ekmek']; for 'kahvaltılık alayım' the breakfast staples; for 'süt, ekmek, yumurta al': ['Süt','Ekmek','Yumurta']). The tool finds a single suggested product for each keyword and shows the user a selection/alternative-swap screen; adding to the cart happens from within the widget. Issue EXACTLY ONE call per user message: the returned widget already contains the full list, the suggested product per keyword, AND per-item alternatives — so do NOT call this tool a second time in the same turn to add recommendations, refine, or 'update' the list (a second call mounts a duplicate widget). If the user changes the items (add/remove), wait for their message and then make ONE new call with the COMPLETE updated item array. Do NOT pre-announce or describe the list in prose before calling (no "şöyle bir liste hazırlıyorum/hazırlayacağım…" preamble) — just call the tool; the widget itself presents the prepared list. Login + address selection required.

getir_plan_shopping_list

Ends the active Getir session — the session reverts to anonymous mode until the user signs in again with phone+OTP. The address, cart, and session token are cleared. Call it when the user says things like 'çıkış yap', 'logout', 'farklı hesapla giriş yapacağım'.

getir_logout

INTERNAL USE — called only by the `getir_login` widget. The model MUST NOT call this tool DIRECTLY and must not ask the user for the OTP as TEXT. For login, call the `getir_login` tool; the widget opens the OTP UI itself and triggers this tool internally.

getir_verify_login_code

INTERNAL USE — called only by the `getir_login` widget. The model MUST NOT call this tool DIRECTLY and must not ask the user for their phone number as TEXT. For login, call the `getir_login` tool; the widget opens the phone UI itself and triggers this tool internally.

getir_send_login_code

Open when the user wants to sign in to their Getir account (e.g. 'giriş', 'login', 'hesabıma gir'), or when they are about to perform an action that requires identity (cart/address/order) in an anonymous session. A phone + SMS OTP widget is mounted inside the conversation; the user enters their credentials directly into the widget, not into the chat text.

getir_login

READ-ONLY: Reads and displays the user's saved Getir delivery addresses on a map. Never edits, deletes, or adds an address — performs no writes to the Getir account. Returns an error if the user is not logged in — call send_login_code + verify_login_code first. Idempotent: if the user already has a selected address, it returns a compact 'address: X' summary pill instead of the picker; you may call this tool as often as you like and it will NOT re-mount the full map+picker. Call with `force: true` only when the user explicitly wants to pick a different saved address — that opens the full picker.

getir_list_addresses

Adds the products selected from the shopping list widget to the cart in one shot. Usually called by the 'Sepete Ekle' button in the widget; can also be called from the ChatGPT chat. In `items[]`, productId is required per product and amount is optional (defaults to 1). For weighted products sold by the kilogram (isWeighted=true in the product data) the amount value is the weight in grams; the product's initialAmount field carries the correct first-add value (for example 1000 for 1 kg).

getir_commit_shopping_list

Shows personalized product recommendations based on the user's order history and selected address in a horizontally scrolling rail. Call it when the user says things like 'ne alayım', 'ne öneriyorsun', 'bana özel ne var', 'her zamanki gibi'. Login required — if anonymous, call the `getir_login` tool first.

getir_list_recommendations

Adds a SINGLE product to the cart. To add 2+ products at once, use `getir_bulk_add_to_cart`. The user must be logged in with a selected address. The cart is kept per vertical (getir or buyuk) — switching vertical opens a separate cart. If it returns an error, relay the message to the user verbatim; if the same product fails repeatedly the Getir session may have expired → suggest signing in again with `getir_login`. Do NOT call `getir_view_cart` after a failed add — the cart would look empty and mislead the user.

getir_add_to_cart