DowrySetsInfoTool
ChatGPTGet 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.
DowrySetsInfoTool
ChatGPTGet 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.
DynamicSearchTool
ChatGPTSearch 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, installment, campaign, or promotion 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. Results are displayed in interactive UI cards, so avoid repeating product names, prices, or descriptions in your text response — the UI already shows them. Avoid saying "15 ürün buldum" / "15 sonuç buldum" or implying that the number of displayed cards is the total number of matching catalog products; the card list is usually the first/relevant subset. Say that relevant options are highlighted above and offer one useful next step.
DynamicSearchTool
ChatGPTSearch 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, installment, campaign, or promotion 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. Results are displayed in interactive UI cards, so avoid repeating product names, prices, or descriptions in your text response — the UI already shows them. Avoid saying "15 ürün buldum" / "15 sonuç buldum" or implying that the number of displayed cards is the total number of matching catalog products; the card list is usually the first/relevant subset. Say that relevant options are highlighted above and offer one useful next step.
GeneralCampaignInfoTool
ChatGPTGets 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.
GeneralCampaignInfoTool
ChatGPTGets 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.
GetProductVariantsTool
ChatGPTGet 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.
GetProductVariantsTool
ChatGPTGet 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.
ProductDetailQueryTool
ChatGPTGet 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.
ProductDetailQueryTool
ChatGPTGet 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.
ProductStoreStockTool
ChatGPTRetrieves 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.
ProductStoreStockTool
ChatGPTRetrieves 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.
RagSearchTool
ChatGPTAnswer 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.
RagSearchTool
ChatGPTAnswer 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.
