Documentation / Tài liệu
AI search / Tìm kiếm AI
Plans and limits / Gói và hạn mức
Free: $0, 0 LLM calls/month. Starter: $9.90/month or $99/year, 0. Growth: $19.90/month or $199/year, 300. Pro: $49.90/month or $499/year, 1,500. Scale: $99.90/month or $999/year, 6,000. Allowances reset each calendar month in UTC. Calls include background jobs and Help answers generated with a model. Provider failures can consume a reserved call.
Growth includes AI synonym suggestions and the Help assistant. Pro and Scale add product attribute extraction, semantic search, natural language filters and the concept map. Ordinary search continues when an allowance or provider budget is reached.
Free: $0, 0 lượt LLM/tháng. Starter: $9.90/tháng hoặc $99/năm, 0. Growth: $19.90/tháng hoặc $199/năm, 300. Pro: $49.90/tháng hoặc $499/năm, 1.500. Scale: $99.90/tháng hoặc $999/năm, 6.000. Hạn mức đặt lại đầu tháng theo UTC, dùng chung cho tác vụ nền và trả lời Help bằng mô hình. Lỗi nhà cung cấp có thể vẫn tiêu thụ một lượt đã giữ trước.
Start a trial / Bắt đầu thử nghiệm
Open AI features in the admin. Select the features and start a control/ai experiment. Storefront changes only apply to the AI arm. Wait at least 14 days. Promotion requires 1,000 searches per arm and statistically positive revenue per search. A trial never automatically enables AI for everyone.
Mở Tính năng AI trong admin, chọn các tính năng rồi bắt đầu thử nghiệm control/ai. Thay đổi trên cửa hàng chỉ áp dụng cho nhóm AI. Chờ ít nhất 14 ngày. Cần 1.000 lượt tìm mỗi nhóm và doanh thu trên lượt tìm tăng có ý nghĩa thống kê để bật mặc định. Thử nghiệm không tự động bật AI cho tất cả khách.
Suggestions and attributes / Gợi ý và thuộc tính
Review each synonym suggestion before accepting it. Accepted AI synonyms stay separate from manually entered synonyms. Attribute coverage shows how many currently visible products have a field, and lists the extracted values and confidence. Create a filter from a populated field; it is visible to the AI arm during the trial. Extraction only uses supported product text; review the results.
Xem từng gợi ý từ đồng nghĩa trước khi chấp nhận. Từ đồng nghĩa AI được lưu riêng với từ nhập thủ công. Mức phủ thuộc tính cho biết số sản phẩm đang hiển thị có trường đó, các giá trị và độ tin cậy. Tạo bộ lọc từ trường đã có dữ liệu; bộ lọc chỉ hiển thị cho nhóm AI trong thử nghiệm. Hãy kiểm tra các kết quả trích xuất.
Semantic and natural language / Ngữ nghĩa và câu tự nhiên
A multilingual embedding model adds product candidates when ordinary text search finds too few matches. Merchant rules, publication status, Market, language and selected filters still constrain final results. Vector cache entries include the model version; a canary checks for embedding drift. If embedding is unavailable, text search answers the request.
Mô hình embedding đa ngôn ngữ bổ sung ứng viên khi tìm kiếm văn bản có ít kết quả. Quy tắc của shop, trạng thái xuất bản, Market, ngôn ngữ và bộ lọc đã chọn vẫn giới hạn kết quả cuối. Bộ nhớ vector gắn với phiên bản mô hình; canary kiểm tra sai lệch. Nếu embedding lỗi, hệ thống trả kết quả tìm kiếm văn bản.
Natural language filters appear as removable chips. Removing a chip repeats the original query without automatically inferred filters; manually selected filters remain in place.
Bộ lọc suy ra từ câu tìm kiếm xuất hiện dưới dạng chip có thể xóa. Xóa chip chạy lại truy vấn ban đầu, bỏ suy luận tự động và giữ các bộ lọc khách đã tự chọn.
Help / Trợ giúp
Help searches the IntentSea knowledge base and cites its sources. Without an AI trial or available model allowance it returns a relevant knowledge base passage. For questions outside the documentation, contact [email protected]. Do not include customer information, passwords or API keys.
Help tìm trong tài liệu IntentSea và dẫn nguồn. Khi chưa thử nghiệm AI hoặc không có hạn mức mô hình, Help trả đoạn tài liệu liên quan. Ngoài phạm vi tài liệu, liên hệ [email protected]. Không nhập thông tin khách hàng, mật khẩu hoặc khóa API.
## Q: How do I turn on storefront search?
Enable the IntentSea Search & Filters app embed in the Shopify theme editor and save. The reviewer guide says to open it from Home → Set up → Open theme editor, then return to the app and confirm. Search autocomplete and the results page are served through the theme integration.
Admin: Home
## Hỏi: Làm cách nào để bật tìm kiếm trên cửa hàng?
Bật app embed IntentSea Search & Filters trong trình chỉnh sửa theme Shopify rồi lưu. Hướng dẫn reviewer cho biết có thể mở từ Trang chủ → Set up → Open theme editor, sau đó quay lại ứng dụng và xác nhận. Tìm kiếm gợi ý và trang kết quả được cung cấp qua tích hợp theme.
Admin: Home
## Q: Why might search results not appear yet?
The catalogue sync starts from the Home setup checklist. Search works as soon as the first batch is indexed; the checklist shows “Last synced” when the sync is done. Check that the product is active and published, and that the app embed is enabled in the theme.
Admin: Home
## Hỏi: Vì sao kết quả tìm kiếm có thể chưa xuất hiện?
Đồng bộ danh mục bắt đầu từ danh sách thiết lập ở Home. Tìm kiếm hoạt động ngay khi lô đầu tiên được lập chỉ mục; danh sách hiển thị “Last synced” khi hoàn tất. Hãy kiểm tra sản phẩm đang hoạt động, đã xuất bản và app embed đã được bật trong theme.
Admin: Home
## Q: How do synonyms and stop words work?
Synonym groups treat two or more words or phrases as equivalent. Stop words are individual words ignored during search. The reviewer guide shows adding a synonym group from Synonyms; the listing says synonyms and stop words support CSV import and export.
Admin: Synonyms
## Hỏi: Từ đồng nghĩa và từ dừng hoạt động như thế nào?
Nhóm từ đồng nghĩa coi hai từ hoặc cụm từ trở lên là tương đương. Từ dừng là những từ riêng lẻ bị bỏ qua khi tìm kiếm. Hướng dẫn reviewer minh họa cách thêm nhóm trong Synonyms; listing cho biết có thể nhập và xuất CSV cho từ đồng nghĩa và từ dừng.
Admin: Synonyms
## Q: What can merchandising rules do?
Rules can pin, boost, hide or redirect results for a search, and can be scheduled. The reviewer guide demonstrates creating a rule in Merchandising; the listing also describes pushing products to the bottom and applying a filter on Growth.
Admin: Merchandising
## Hỏi: Quy tắc sắp xếp kết quả có thể làm gì?
Quy tắc có thể ghim, tăng thứ hạng, ẩn hoặc chuyển hướng kết quả cho một lượt tìm kiếm và có thể đặt lịch. Hướng dẫn reviewer minh họa tạo quy tắc trong Merchandising; listing cũng mô tả đẩy sản phẩm xuống cuối và áp dụng bộ lọc ở gói Growth.
Admin: Merchandising
## Q: Which filters are available, including metafields?
The listing names price, brand, type, tags, options and metafields as filter fields. The reviewer guide shows setting a price range or choosing Brand or Product type, then managing filters in the Filters admin page. Collection-page filters are available from Starter.
Admin: Filters
## Hỏi: Có những bộ lọc nào, bao gồm metafield?
Listing nêu các trường lọc gồm giá, thương hiệu, loại, thẻ, tùy chọn và metafield. Hướng dẫn reviewer minh họa đặt khoảng giá hoặc chọn Brand hay Product type, sau đó quản lý bộ lọc trong trang quản trị Filters. Bộ lọc trang bộ sưu tập có từ gói Starter.
Admin: Filters
## Q: How can I find searches that returned no products?
Analytics reports top searches, click-through rate and searches with no results. The reviewer guide notes that data may take a few minutes to appear after the test searches.
Admin: Analytics
## Hỏi: Làm sao tìm các lượt tìm kiếm không có sản phẩm?
Analytics báo cáo các lượt tìm phổ biến, tỷ lệ nhấp và lượt tìm không có kết quả. Hướng dẫn reviewer lưu ý dữ liệu có thể mất vài phút mới xuất hiện sau khi thử tìm kiếm.
Admin: Analytics
## Q: Can I import settings from my previous search app?
Import can preview synonym groups, search redirects and stop words from CSV or JSON. Filters, merchandising pins and other app-specific settings cannot be imported. Preview additions, duplicates and invalid entries before confirming; export formats can change.
Admin: Import
## Hỏi: Tôi có thể nhập thiết lập từ ứng dụng tìm kiếm trước đây không?
Import có thể xem trước nhóm từ đồng nghĩa, chuyển hướng tìm kiếm và từ dừng từ CSV hoặc JSON. Không thể nhập bộ lọc, ghim sản phẩm và thiết lập riêng của ứng dụng khác. Hãy xem trước mục thêm, trùng lặp và không hợp lệ trước khi xác nhận; định dạng xuất có thể thay đổi.
Admin: Import
## Q: What do the plans and trial include?
The plans are Free ($0; 100 products and 2,000 searches/month), Starter ($9.90/month or $99/year; 500 products and 8,000 searches/month), Growth ($19.90/month or $199/year; 2,000 products and 25,000 searches/month), Pro ($49.90/month or $499/year; 20,000 products and 150,000 searches/month) and Scale ($99.90/month or $999/year; 100,000 products and 750,000 searches/month). Free remains free. Starter, Growth, Pro and Scale include a 14-day free trial. Free includes search, filters, autocomplete, synonyms, stop words and basic pin/hide rules. Starter adds banners, text labels, quick add and collection-page filters. Growth adds merchandising rules, swatches, custom CSS, behaviour and strategy ranking, and AI synonym suggestions. Pro adds margin ranking, semantic search, A/B tests, personalisation, recommendations, AI product attributes and natural-language filters. Scale has the same features as Pro with larger limits, priority support and a higher AI allowance. Limits are soft: search continues if a shop goes over, and the admin shows an upgrade banner. Downgrading keeps saved settings; paid features are read-only and stop being served until the shop upgrades again.
Admin: Billing
## Hỏi: Các gói và thời gian dùng thử gồm những gì?
Các gói gồm Free (0 $; 100 sản phẩm và 2.000 lượt tìm/tháng), Starter (9,90 $/tháng hoặc 99 $/năm; 500 sản phẩm và 8.000 lượt tìm/tháng), Growth (19,90 $/tháng hoặc 199 $/năm; 2.000 sản phẩm và 25.000 lượt tìm/tháng), Pro (49,90 $/tháng hoặc 499 $/năm; 20.000 sản phẩm và 150.000 lượt tìm/tháng) và Scale (99,90 $/tháng hoặc 999 $/năm; 100.000 sản phẩm và 750.000 lượt tìm/tháng). Free luôn miễn phí. Starter, Growth, Pro và Scale có 14 ngày dùng thử miễn phí. Free gồm tìm kiếm, bộ lọc, gợi ý khi gõ, từ đồng nghĩa, từ dừng và quy tắc ghim/ẩn cơ bản. Starter bổ sung banner, nhãn văn bản, thêm nhanh và bộ lọc trang bộ sưu tập. Growth bổ sung quy tắc sắp xếp, ô màu, CSS tùy chỉnh, xếp hạng theo hành vi và chiến lược, cùng gợi ý từ đồng nghĩa bằng AI. Pro bổ sung xếp hạng theo biên lợi nhuận, tìm kiếm ngữ nghĩa, A/B test, cá nhân hóa, gợi ý sản phẩm, thuộc tính sản phẩm bằng AI và bộ lọc bằng ngôn ngữ tự nhiên. Scale có cùng tính năng với Pro, giới hạn cao hơn, hỗ trợ ưu tiên và hạn mức AI cao hơn. Giới hạn là mềm: tìm kiếm vẫn hoạt động khi cửa hàng vượt hạn mức và trang quản trị hiển thị banner nâng cấp. Hạ gói vẫn giữ thiết lập đã lưu; tính năng trả phí chuyển sang chỉ đọc và ngừng được phục vụ cho đến khi nâng cấp lại.
Admin: Billing
## Q: What data does IntentSea process?
The listing says products are indexed for search and the app does not modify products, orders or customers. Its analytics pixel reports add-to-cart and completed-purchase events after a search. It does not collect customer personal data; the anonymous session identifier is stored only with analytics consent, and event data is retained for 180 days.
## Hỏi: IntentSea xử lý dữ liệu nào?
Listing cho biết sản phẩm được lập chỉ mục để tìm kiếm và ứng dụng không chỉnh sửa sản phẩm, đơn hàng hay khách hàng. Pixel phân tích ghi nhận sự kiện thêm vào giỏ và hoàn tất mua hàng sau tìm kiếm. Ứng dụng không thu thập dữ liệu cá nhân của khách; mã phiên ẩn danh chỉ được lưu khi có sự đồng ý phân tích và dữ liệu sự kiện được giữ trong 180 ngày.
## Q: Which languages are supported?
The app admin and storefront widget list English and Vietnamese. The app can index translated product titles and descriptions so shoppers can search in the storefront language.
## Hỏi: Ứng dụng hỗ trợ những ngôn ngữ nào?
Trang quản trị và tiện ích trên cửa hàng hỗ trợ tiếng Anh và tiếng Việt. Ứng dụng có thể lập chỉ mục tiêu đề và mô tả sản phẩm đã dịch để khách tìm kiếm bằng ngôn ngữ cửa hàng.
## Q: What affects search ranking?
Ranking combines text relevance with merchant signals. Documented signals include inventory, newness, discount, sales velocity and trend, plus measured click-through, add-to-cart and conversion lifts. Merchandising rules take priority over ordinary ranking; raw cost, margin and order records remain private inputs.
## Hỏi: Những yếu tố nào ảnh hưởng đến thứ hạng tìm kiếm?
Xếp hạng kết hợp mức độ liên quan của văn bản với tín hiệu do chủ shop chọn. Các tín hiệu được mô tả gồm tồn kho, độ mới, giảm giá, tốc độ và xu hướng bán hàng, cùng mức tăng đo được của lượt nhấp, thêm vào giỏ và chuyển đổi. Quy tắc sắp xếp ưu tiên hơn xếp hạng thông thường; dữ liệu giá vốn, biên lợi nhuận và đơn hàng thô là đầu vào riêng tư.
## Q: Which themes and storefront components are supported?
The listing names Online Store 2.0 themes. The reviewer guide demonstrates the app embed and optional Search Bar, Search Results, Collection Filters, Popular Searches and Breadcrumbs app blocks.
## Hỏi: Theme và thành phần cửa hàng nào được hỗ trợ?
Listing nêu các theme Online Store 2.0. Hướng dẫn reviewer minh họa app embed và các app block tùy chọn: Search Bar, Search Results, Collection Filters, Popular Searches và Breadcrumbs.
## Q: How does search attribution handle customer consent?
The app pixel is declared analytics-only and checks Shopify's Customer Privacy API before sending events. It does not run without analytics consent where consent is required. The listing says anonymous session identifiers are used and event data is deleted after 180 days.
## Hỏi: Việc ghi nhận tìm kiếm xử lý sự đồng ý của khách như thế nào?
Pixel của ứng dụng chỉ được khai báo cho mục đích phân tích và kiểm tra Customer Privacy API của Shopify trước khi gửi sự kiện. Pixel không chạy khi chưa có sự đồng ý phân tích ở nơi cần sự đồng ý. Listing cho biết mã phiên ẩn danh được sử dụng và dữ liệu sự kiện bị xóa sau 180 ngày.
## Q: Where can I contact support?
The listing provides the support email [email protected].
## Hỏi: Tôi có thể liên hệ hỗ trợ ở đâu?
Listing cung cấp email hỗ trợ [email protected].
## Q: How do I try AI search features?
Open AI features in the app. Growth supports AI synonym suggestions and AI Help; Pro and Scale add semantic search, product attributes, natural-language filters and the concept map. Start a control/ai trial for at least 14 continuous days. AI is not enabled by default. Promotion requires 1,000 searches per arm and positive revenue evidence. Monthly model call caps are Free 0, Starter 0, Growth 300, Pro 1,500 and Scale 6,000. Background jobs and AI Help share this allowance. Help still returns relevant knowledge-base passages when AI is not enabled.
Admin: AI features / Help
## Hỏi: Làm sao thử các tính năng tìm kiếm AI?
Mở Tính năng AI trong ứng dụng. Growth có gợi ý từ đồng nghĩa và Help bằng AI; Pro và Scale bổ sung tìm kiếm ngữ nghĩa, thuộc tính sản phẩm, bộ lọc từ câu tự nhiên và bản đồ khái niệm. Bắt đầu thử nghiệm control/ai ít nhất 14 ngày liên tục. AI không tự bật mặc định. Cần 1.000 lượt tìm mỗi nhóm và doanh thu tăng có ý nghĩa để áp dụng. Hạn mức gọi mô hình mỗi tháng: Free 0, Starter 0, Growth 300, Pro 1.500, Scale 6.000; dùng chung cho tác vụ nền và Help bằng AI. Khi chưa bật AI, Help vẫn trả đoạn tài liệu liên quan.
Admin: Tính năng AI / Trợ giúp
Scoring model
Full search combines text relevance with merchant ranking signals. The query builder uses an OpenSearch function_score with additive score functions, then multiplies that result by the business and behavior factor. Function score modes preserve the text match while allowing enabled signals to lift matching products.
The default blended behavior mode applies the blended popularity curve. Merchants can use custom behavior weights to tune click through rate, add to cart rate, and conversion independently. Each behavior signal uses its measured lift (ctr_lift, atc_lift, or cvr_lift) through a bounded lift function: neutral lift contributes no bonus, positive lift increases the score, and the curve limits the effect of extreme observations.
Business signals include inventory, newness, discount, sales velocity, and sales trend. Their functions use mapped product fields, bounded weights, caps, and decay where relevant. Discount uses compare-at price relative to current price; newness uses publication time; inventory uses available quantity. The configured weights are in the tenant's settings.ranking_signals object and range from 0 to 1.
Per-query product boosts and query groups can add query-specific relevance. Merchandising rules have priority over ordinary ranking and can pin, boost, or bury products according to the rule outcome.
Data sources
| Signal | Indexed field | Source |
| --- | --- | --- |
| Popularity | popularity | Aggregated product engagement metrics |
| Sales velocity and trend | sales_velocity, sales_trend | Metrics refresh job |
| Behavior lifts | ctr_lift, atc_lift, cvr_lift | Aggregated analytics ingest and metrics refresh |
| Inventory | inventory_quantity, available | Product catalog ingest |
| Discount | price, compare_at_price | Product catalog ingest |
| Newness | published_at | Product catalog ingest |
| Tenant ranking weights | settings.ranking_signals | Tenant configuration |
Raw cost, margin, and order records are private ranking inputs: they must never appear in search responses. Public hits expose only product data and derived ranking results allowed by the response schema.
Presets and impact check
The integration check indexes synthetic products and verifies that each configured preset puts its intended group in at least four of the top five results. It requires a disposable OpenSearch instance, never a production endpoint:
``sh``
INTENTSEA_TEST_OPENSEARCH_URL=http://localhost:9200 \
python -m pytest -q -s tests/test_ranking_impact.py
Without INTENTSEA_TEST_OPENSEARCH_URL, the module is skipped. The test records OpenSearch took values in milliseconds; collect five runs per preset and use their median for the table below. The Profit preset is included only when the ranking model supports margin.
| Preset | Median took_ms |
| --- | --- |
| Baseline | TBD (coordinator) |
| Balanced | TBD (coordinator) |
| Bestsellers | TBD (coordinator) |
| Clearance | TBD (coordinator) |
| New arrivals | TBD (coordinator) |
| Profit | TBD (coordinator) |