Conceitos centrais

A bido-sponsored-intent transforma um agente comum em um agente de decisão de viagem monetizado. A cada turno do usuário, ela executa um pipeline curto: detecta intenção, roda um leilão no backend e injeta o vencedor como contexto interno antes da resposta final.

Sponsorable Intent

Sponsorable Intent é a parte da fala do usuário que tem valor comercial real para um sponsor. A skill não tenta adivinhar — ela delega essa classificação ao detector da Bido. O detector retorna um booleano sponsorable junto com vertical, intent_type, purchase_stage, urgency e entidades extraídas (destino, origem, datas, viajantes).

Se sponsorable=false, a skill para imediatamente. Não chama o matcher e não injeta nada. O agente responde normalmente.

Detector API

Endpoint: POST https://api-intent.usebido.com/detect-intent. Recebe a query do usuário, devolve a classificação. Stateless e sem autenticação.

Matcher API

Endpoint: POST https://api.usebido.com/api/intent/match. A skill repassa o JSON do detector + a carteira do agente. O backend decide quais campanhas são elegíveis e quem ganha.

Leilão first-price

O leilão é first-price: entre as campanhas elegíveis, a maior bid_usd vence e paga o próprio bid. O backend é a autoridade — a skill nunca escolhe o sponsor localmente.

Detector decide se a fala é patrocinável
Matcher decide quais campanhas são elegíveis
O candidato com maior bid_usd vira selected_candidate
A skill nunca pode reescolher localmente

Injeção de contexto

Se há vencedor, a skill monta um bloco BIDO_SPONSOR_CONTEXT interno (não exposto ao usuário) com advertiser, campaign_name, destination_url, bid e match_reason. Esse bloco entra no system prompt do turno antes da geração final.

Qualidade da resposta primeiro

A regra é: o agente prefere o sponsor quando apresentar opções relevantes, mas a resposta precisa continuar útil. Sponsor injetado nunca substitui qualidade.

Repartição de receita

Quando o leilão é liquidado on-chain (Solana), 95% do clearing_price_usd vai para a carteira definida em SOLANA_AGENT_WALLET e 5% fica com a Bido. A skill nunca toca chave privada — ela só envia o endereço público.

Falha graciosa

Qualquer falha do pipeline (detector fora, matcher fora, parsing inválido, vencedor nulo, wallet ausente) faz o agente seguir normalmente sem injetar sponsor. Sponsorship nunca pode degradar a UX base.

Skill