Karaca

Get information about Karaca dowry/trousseau packages (Turkish 'çeyiz'). Use this only when the customer explicitly asks about 'çeyiz', 'çeyiz seti', or 'çeyiz paketi'. It is NOT for ordinary product sets: regular dinnerware or kitchenware sets such as 'yemek takımı', 'kahvaltı takımı', 'tencere seti', 'çay seti', 'kahve seti', or 'fincan takımı' are normal product categories and should be searched with DynamicSearchTool, not this tool. The word 'takım'/'set' by itself does not imply çeyiz.

Search the Karaca catalog with a query and return matching products. Use it for NEW product discovery, not for follow-up details or variants of products already shown. For a referenced or displayed product, prefer the dedicated tools: use GetProductVariantsTool for color, size, or variant questions (e.g. "ilkinin farklı renkleri var mı?", "bu ürünün başka rengi var mı?"), and use ProductDetailQueryTool for detail, spec, warranty, material, comment, rating, or installment questions. When the user refers to "ilki", "ikincisi", "bu ürün", or "bunlar", resolve the product from the most recent displayed cards before choosing a tool. Response includes structured product data with detailed information about each product found, plus `total_products`: the total number of matching products in the catalog. Each product carries `promos`: the campaign badges shown on that product ("Karaca 2 Al 1 Öde", "Hediye Paketi Yapılabilir", ...). Answer campaign/promotion questions about a returned product from `promos` — do not call ProductDetailQueryTool just to read them. The cards do not show `promos`, so name the relevant ones in your text when asked. Results are displayed in interactive UI cards, so avoid repeating product names, prices, or descriptions in your text response — the UI already shows them. Never present the number of displayed cards as the total match count; when the customer asks or when it is useful, use `total_products` instead (e.g. "473 uygun ürün var, en alakalı olanları yukarıda gösteriyorum"). Say that relevant options are highlighted above and offer one useful next step. Results are paginated: each call returns one page of products and `has_more` tells whether further pages exist (deeper result pages are fetched from the catalog automatically as needed). When the customer asks to see more results ("devamını göster", "daha fazla", "başka var mı", "diğerlerini göster"), call this tool again with the SAME search_query/url and page incremented by 1 — do not reword the query when paging. If `has_more` is false, tell the customer all matching products have been shown and suggest refining the search instead. If `filters_relaxed` is true, the matched filters produced no products, so the broader unfiltered listing is shown instead — tell the customer there was no exact match for their filters and that the closest alternatives are displayed.

Gets general info about the active campaigns available on Karaca online. Also get info from this tool when customer asks about specific campaigns, discounts, promotions, complementary products (buy x get y for free) etc. Returns general information related to customer's question. Also use this to get a URL that can be used to search the products with a certain campaign. If you need the URL, campaign id or otherwise any info about a campaign is need by the AI this tool can also be used.

Get the color, size, model-option, and other variants of a specific Karaca product by product_id. This is the right tool for follow-up questions about the variants of a product that was already shown or referenced, such as "farklı renkleri var mı", "başka rengi var mı", "renk seçenekleri", "bedeni var mı", "varyantları", "seçenekleri", "ilkinin farklı renkleri var mı", "bu ürünün başka rengi". Resolve references like "ilki", "birincisi", "bu ürün", "bunlardan" from the most recent product cards/tool results and pass that product_id here. For these follow-up variant questions, prefer this tool over DynamicSearchTool. If the referenced product_id is unknown or ambiguous, ask a short clarifying question instead of searching.

Get detailed information for one or more Karaca products by product ID. Use it to answer product-specific questions, fetch promo and campaign info for a product, and compare products with each other. Each response includes rich product information with descriptions, attributes, and promotions. The UI result may include a hidden AIDA_DETAIL_CONTEXT with description, attributes, promotions, extra warranty, installments, videos, rating, comment count, and comments summary. Use that context to answer detail questions directly; do not claim only price/rating/comment data is available when richer fields are present. The visible UI card is only a clickable product reference, so put the actual details in your text answer rather than telling the user that details are shown above. This is the right tool for follow-up questions about the details of a product that was already shown or referenced, such as "detaylarını göster", "ürün detayları", "özellikleri nedir", "bunun garantisi nedir", "kaç watt", "malzemesi ne", "yorumları nasıl", "puanı kaç", "ne demiş kullanıcılar", "yorumlar ne diyor", "kullanıcı yorumları", "kaç yorum var", "taksit seçenekleri", "kampanyası var mı", "promosyonu var mı". Customer reviews, comments, and ratings are answered from this tool's result (comments_summary, average_rating, number_of_comments), not from RagSearchTool. Also use this tool when the customer asks to SEE or re-show a referenced product ("ürünü göster", "ürünü göremedim", "kartını göster", "tekrar göster"): it returns an interactive product card, so call it instead of only describing the product in text. Resolve references like "ilki", "birincisi", "bu ürün", "bundan", "gösterdiğin ürün" from the most recent product cards/tool results and call it with product_ids=[resolved_product_id]. For these follow-up detail questions, prefer this tool over DynamicSearchTool. If the referenced product_id is unknown or ambiguous, ask a clarifying question instead of searching.

Retrieves detailed stock information for products across various Karaca stores based on product ID(s). The tool returns structured store availability information for each requested product. Each response includes the product ID and list of stores where the product is available. Each store object provides details such as name, address, phone, latitude, and longitude. This tool is suitable for answering questions about product availability at specific store locations, or finding where a customer can buy a particular product. Before calling this tool, if the customer has not provided the city/district/neighborhood where they want to check physical store stock, ask one clarifying question for that location first. When the customer provides a location, pass it as display_location. The location is geocoded and used to show the nearest stores on the map sorted by distance. It does not filter the backend stock request.

Answer a natural-language question from the internal knowledge base. Use this tool when the answer is likely curated knowledge rather than live product or campaign data. Verify your knowledge with this tool.