Sellit

Resolve Store

Resolve uma loja Sellit pelo seu handle (identificador na URL) e fixa essa loja como contexto da sessão. Chame ANTES das demais ferramentas de catálogo sempre que o usuário se referir a uma loja específica. Retorna o perfil público da loja (nome, descrição, logo).

Search Shop Catalog

Busca produtos no catálogo público. Se uma loja foi definida com `resolve_store`, busca dentro dela; caso contrário, busca no marketplace. Use quando o usuário quer encontrar/filtrar produtos por texto, categoria ou ordenar por preço/novidade. Retorna apenas produtos publicados.

Get Product Details

Retorna a ficha completa e pública de um produto: descrição, preço, imagens, vídeos, variações (tamanho/cor) e disponibilidade. Use após uma busca, quando o usuário quer detalhes, preço ou disponibilidade de um produto específico (informe o id retornado por `search_shop_catalog`).

Get Product Reviews

Lista as avaliações públicas (nota, comentário, autor) de um produto, paginadas. Use quando o usuário pergunta sobre reputação, opiniões ou estrelas de um produto.

Get Feature Details

Explica em profundidade um recurso da plataforma Sellit: o que é, quando usar, como configurar (passo a passo) e regras/limites. Use quando o usuário pergunta 'como funciona X' ou 'como usar X' (ex.: Kits, produtos digitais, leilão ao vivo, assinaturas, gamificação, domínio próprio). Se não souber a chave exata do recurso, use `search_documentation` primeiro.

List Faqs

Lista perguntas frequentes sobre a plataforma Sellit (planos, domínio, pagamentos, produtos digitais, etc.). Use para dúvidas curtas e diretas. Filtre por tópico quando fizer sentido.

Search Documentation

Busca difusa em toda a base de conhecimento pública da Sellit e retorna os trechos mais relevantes. Use para perguntas amplas ou ambíguas sobre a plataforma quando você não sabe qual recurso específico consultar. Depois, aprofunde com `get_feature_details` no recurso retornado.

Validate Coupon

Valida um código de cupom informado pelo usuário na loja atual e retorna o desconto se ele estiver ativo, válido e público. Chame `resolve_store` antes. Use quando o usuário pergunta se um cupom é válido ou qual desconto ele dá.

Browse Marketplace

Lista/busca produtos no marketplace público da Sellit (todas as lojas), com filtro opcional por texto e ordenação. Use quando o usuário quer descobrir produtos sem estar numa loja específica. Para buscar dentro de uma loja, use search_shop_catalog após resolve_store.

List Featured Stores

Lista lojas em destaque no marketplace da Sellit (nome, handle, se é verificada e quantos produtos tem). Use quando o usuário quer descobrir lojas ou pede recomendações de lojas.

Get Store Reviews

Retorna as avaliações da loja atual (agregadas de todos os produtos) com média, total e distribuição por estrela, além das avaliações recentes. Chame `resolve_store` antes. Use quando o usuário pergunta sobre a reputação geral de uma loja.

List Payment Methods

Lista as formas de pagamento aceitas pela loja atual, o número máximo de parcelas e eventuais descontos no Pix. Chame `resolve_store` antes. Use quando o usuário pergunta como pode pagar, se aceita Pix/cartão ou em quantas vezes pode parcelar.

Get Product Kits

Retorna o kit/combo ativo associado a um produto (nome, preço promocional, variações do kit e produtos incluídos). Use quando o usuário pergunta se um produto tem kit ou combo. Informe o id do produto principal.