Integre com o seu agente

O seu agente integra, você revisa o diff. Com a chave e esta documentação, ele verifica a chave, escreve o snippet e testa uma recomendação e um sinal. Passá-la é seguro: a chave de storefront é pública e limitada. Por quê, em Chaves e segurança.

O que o seu agente precisa

O quê	Para quê	De onde
A chave `spk_…` e o `connection_id`	Pedir recomendações e mandar sinais de teste	O admin, em Configurações → Chaves para o seu storefront
Esta documentação	Saber como se integra	`llms.txt`: todo o site em um arquivo, ou cada página como Markdown
A skill de integrador	Seguir o percurso desta doc, com suas verificações	A skill

O prompt

Copie isto no seu agente, com a sua chave e a sua conexão:

Integre a CrossUp na página de produto desta loja.

Chave de storefront: spk_…
connection_id: cn_…
Documentação: https://docs.crossup.ai/llms.txt

1. Verifique a chave com um GET /v1/catalog/items de um item qualquer.
2. Instale @crossup/storefront e crie uma instância uma única vez.
3. Peça uma decisão com surface "pdp", placementKey "pdp-related" e o
   item_id do produto da página. Mostre results[].product com os componentes
   da loja; se não há resultados, não mostre nada.
4. Reporte track.impression quando a recomendação entrar na tela e track.click ao abrir um resultado.
5. Mostre para mim o decision_id de uma decisão de teste e o signal_id aceito.

Não invente valores que a API não devolve. Um campo ausente é desconhecido, não zero.

O que um agente pode fazer hoje, e o que não

Com a chave de storefront
Ler o catálogo canônico	Sim
Pedir recomendações para qualquer momento	Sim
Mandar sinais	Sim, pela API
Ativar ou configurar momentos	Não: é do admin
Ler análises	Não: é do admin
Cadastrar um conector	Não: pede uma chave de conector

A chave tem três permissões e uma cota de 60 requisições por minuto: um agente não pode fazer nada que a chave não permita.

O que você vai ver

Um diff com a instância, a requisição e os dois sinais. Na resposta do agente, um decision_id (o id da recomendação) e um signal_id com accepted: a mesma evidência que você pediria a uma pessoa.

Se você não vê

O que acontece	O que fazer
O agente inventa um endpoint ou um campo	Dê a ele `llms.txt`
Mostra `0` onde não há preço	Cole a regra do modelo canônico: um campo ausente não é um zero
Tenta de novo em loop diante de um `429`	Cole Cota e cache
Pede `store_id`	Não existe: a loja sai da chave

llms.txt

Toda a documentação em um arquivo para o seu agente.

A skill

O percurso de integração, como arquivo para o seu agente.

SalesPilot no Claude

Agentes

Integre com o seu agente

O que o seu agente precisa

O prompt

O que um agente pode fazer hoje, e o que não

O que você vai ver

Se você não vê

llms.txt

A skill

​O que o seu agente precisa

​O prompt

​O que um agente pode fazer hoje, e o que não

​O que você vai ver

​Se você não vê

llms.txt

A skill

O que o seu agente precisa

O prompt

O que um agente pode fazer hoje, e o que não

O que você vai ver

Se você não vê