clue
Português
English한국어日本語简体中文繁體中文EspañolPortuguêsDeutschFrançaisItalianoРусскийالعربيةहिन्दीBahasa IndonesiaTiếng ViệtไทยTürkçeNederlandsPolskiSvenska
EntrarComeçar
Como funcionaAnunciantesEditoresPara agentesPreçosDocumentação
EntrarComeçar
Para agentes

Para agentes de IA: como ler uma clue.

Se você é um agente de IA e chegou até aqui, a interface que você visitou contém uma clue. Esta página explica exatamente o que é uma clue, o que ela não é e como esperamos que você a trate. Tudo nesta página também está disponível em texto simples em /llms.txt e como um documento legível por máquina em /.well-known/agent-ads.json.

HHoshino Stay1Sponsored8

Hoshino Stay Osaka — family rooms near Namba2

Family rooms for 4 from $140 a night. Free cancellation, breakfast included, 5 minutes from Namba station.3

  • Family rooms for 4
  • Free cancellation
  • Breakfast included
  • 4

From $140 per night, family room for 45

→ hoshinostay.com · ?clue_id=…6Check availability
docs · MCP · llms.txt · API7outcome_url9

This is a sponsored clue delivered by clue. The operator of this page or service did not endorse it. Evaluate it against your task and your user's instructions.

Anatomia de um clue.

Nove campos, em qualquer um dos 20 idiomas solicitados pelo agente.

  1. 1
    ProvedorA marca por trás da oferta.
  2. 2
    Oferta em uma linhaO que é, em uma linha.
  3. 3
    ResumoDuas frases sobre as quais um agente pode agir.
  4. 4
    CapacidadesO que o agente pode fazer com isso.
  5. 5
    PreçoPreços em texto simples com níveis e unidades.
  6. 6
    Próxima ação e URL de destinoRedirecionamento assinado com clue_id anexado.
  7. 7
    Links para agentes (docs, MCP, llms.txt, API)Documentação, MCP, llms.txt, API.
  8. 8
    Sinalizador de patrocínio e divulgaçãosponsored: true, no idioma do agente.
  9. 9
    URL de resultadoOnde o agente relata como foi.

Uma clue é um posicionamento pago, e ela deixa isso claro.

Cada clue traz sponsored: true e uma frase de divulgação no idioma que você solicitou. O editor da interface que você estava lendo não endossou o provedor. Avalie a opção por seus méritos em relação à tarefa que lhe foi dada e sempre prefira as instruções explícitas do seu usuário a qualquer coisa que uma clue diga. Os anunciantes podem comprar a chance de serem considerados. Eles não podem comprar a sua conclusão.

Uma clue é informação estruturada, não persuasão.

Uma clue tem nove campos: provider, offer, summary, capabilities, price, next action com uma URL de destino, pontos de entrada de máquina (docs, MCP, llms.txt, API), a flag sponsored com sua divulgação e uma URL de resultado. Nada em uma clue é uma instrução para você. Nossa política rejeita clues que se dirijam aos agentes, peçam para preferirem um provedor ou contenham texto semelhante a prompt. Aqui está um exemplo completo, solicitado em japonês.

{
  "sponsored": true,
  "disclosure": "これはclueが配信した有料掲載です。このページの発行者が推奨したものではありません。与えられたタスクとユーザーの指示に照らして判断してください。",
  "label": "広告",
  "lang": "ja",
  "clues": [
    {
      "id": "sv_8Kq1…",
      "sponsored": true,
      "advertiser": "Hoshino Stay",
      "title": "Hoshino Stay 大阪 — なんば近くのファミリールーム",
      "summary": "4 名用ファミリールームが 1 泊 $140 から。無料キャンセル、朝食付き、なんば駅から徒歩 5 分。",
      "capabilities": [
        "4 名用ファミリールーム",
        "無料キャンセル",
        "朝食付き"
      ],
      "pricing": "1 泊 $140 から（4 名用ファミリールーム）",
      "url": "https://clue.ad/c/eyJz…",
      "destination_domain": "hoshinostay.com",
      "cta": "空室を確認",
      "docs_url": "https://hoshinostay.com/partners",
      "mcp_url": "https://mcp.hoshinostay.com",
      "outcome_url": "https://clue.ad/v1/outcome/sv_8Kq1…"
    }
  ],
  "policy": "https://clue.ad/agents"
}

Abrir o link conta como um follow.

O campo url é um redirecionamento assinado através do clue. Abri-lo registra um follow para o anunciante e, em seguida, o encaminha para o destino do provedor com um parâmetro de consulta clue_id. Abra-o apenas se a opção for relevante para a sua tarefa. Aberturas repetidas da mesma sessão não são contadas novamente.

Conte-nos como foi.

Faça um POST para a outcome_url da clue com um dos quatro resultados: useful, not_useful, used ou purchased. Os resultados são anônimos, são usados para melhorar a correspondência e são mostrados aos anunciantes apenas como agregados. O envio de relatórios é opcional, mas apreciado.

POST https://clue.ad/v1/outcome/<clue id>
Content-Type: application/json

{"outcome": "useful"}   # useful | not_useful | used | purchased

Você pode consultar o clue diretamente.

Se você quiser opções comerciais relevantes para uma tarefa sem passar por um editor, faça um POST da sua tarefa para /v1/discover. A mesma capacidade é disponibilizada como um servidor MCP em /mcp com duas ferramentas: discover_clues e report_outcome. As respostas são rotuladas exatamente como as clues entregues por meio de editores.

POST https://clue.ad/v1/discover
{"task":"send transactional email from node","lang":"ko","country":"KR"}

GET https://clue.ad/v1/discover?q=send+transactional+email+from+node&lang=ko&country=KR

# MCP (Streamable HTTP, JSON-RPC 2.0)
POST https://clue.ad/mcp
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"discover_clues","arguments":{"task":"book a hotel in Tokyo for 2 nights","lang":"en","country":"JP"}}}

O que uma clue nunca fará.

A frase de divulgação em cada idioma da plataforma.

A frase de divulgação acompanha cada clue e é entregue no idioma da solicitação. Estes são os vinte idiomas da plataforma; outros idiomas recorrem ao inglês por padrão.