Gerar código de gatilho com IA

Copiar página

Conecte sua chave de API do Anthropic (Claude) ou da OpenAI e descreva um gatilho personalizado em inglês simples - o editor cria a transformação para você.

Descreva o que deseja em linguagem simples e deixe que a IA escreva o código. O sistema utiliza sua própria chave do provedor de IA e baseia-se no contrato de tempo de execução deste aplicativo, na API de administração do Shopify e - assim que você tiver capturado um - na carga útil real do evento que seu gatilho recebe.

Conectar um provedor

Em “Desenvolvedor” → “Conexões”, adicione sua chave de API para o provedor de sua preferência: Anthropic (Claude), OpenAI, Google Gemini ou OpenRouter.

Sua chave é criptografada quando está em repouso e é utilizada apenas para geração. Ela nunca é executada dentro do seu código de gatilho e nunca mais é exibida após você salvá-la.
Cada cartão contém um link para um guia breve: Como obter uma chave de API do Anthropic (Claude), Como obter uma chave de API da OpenAI, Como obter uma chave de API do Google Gemini ou Como obter uma chave de API do OpenRouter.
Quando o(a) senhor(a) gera sua solicitação, o código atual e o evento de amostra capturado são enviados a esse provedor, vinculado à sua conta.

Conecte um ou vários provedores e selecione por geração. A desconexão remove a chave novamente.

A guia “Conexões” da página “Desenvolvedor”, com cartões para a Anthropic, a OpenAI, o Google Gemini e o OpenRouter; a Anthropic exibe a conexão “Key” — Desenvolvedor, Conexões: uma carta por provedor. Uma chave conectada nunca é mostrada novamente; ela é apenas substituída ou desconectada.

Gerar um gatilho personalizado

Abra um gatilho personalizado. Com um provedor conectado, uma caixa “Gerar com IA” aparece no cartão “Transformar”, acima do código.
Descreva o que deve acontecer - seja específico quanto ao momento em que deve ser acionado e ao que o fluxo de trabalho requer, por exemplo:

Só execute a ação quando o valor total do pedido for superior a 500 e o pedido tiver a tag “vip”. Envie o número do pedido, o valor total e a moeda para o Shopify Flow.
Escolha um provedor (caso tenha conectado mais de um) e um modelo; em seguida, selecione “Gerar”.
O código é carregado no editor como uma alteração não salva. Revise-o, teste-o e, em seguida, salve. Se já houver código, ele será editado em vez de começar do zero; portanto, a opção “agora faça também X” se baseia no que você já tem.

A caixa “Gerar com IA” no cartão “Transformar” de um gatilho personalizado, com um seletor de modelos, seu custo por geração e um prompt — Escolha um modelo - o custo por geração está indicado ao lado dele - e descreva quando o gatilho deve ser acionado e o que o Shopify Flow precisa.

O editor de código, após a geração: uma transformação que ignora pedidos de 500 ou menos e pedidos sem a tag “vip”, e retorna o número do pedido, o total e a moeda — O resultado aparece no editor como uma alteração não salva: dois filtros e os três valores solicitados pelo prompt.

Gerar um trecho de código para a loja virtual

Um {% doc "custom-storefront-triggers" %} funciona de maneira diferente: ele não possui nenhuma transformação a ser gravada. O que você precisa criar é o código JavaScript que publica o evento a partir do seu tema, e é nessa parte que as pessoas têm dificuldade - cada tema nomeia seus elementos de maneira diferente.

Abra o gatilho da loja virtual e utilize a opção “Gerar o trecho de código com IA”. Descreva a ação que deve acioná-lo (“quando a gaveta do carrinho for aberta no Dawn, envie a contagem de itens e o total do carrinho”) e você receberá um trecho de código pronto, utilizando o nome do evento registrado, além de instruções sobre onde colá-lo.

Leia-o antes de colar, ajuste qualquer seletor que tenha sido adivinhado para o seu tema e nunca inclua o nome, e-mail, telefone ou endereço de um cliente na payload.

O cartão “Gerar o trecho com IA” de um gatilho de loja virtual, contendo um trecho gerado para a gaveta de carrinho do Dawn e uma observação sobre onde colá-lo — No caso de um gatilho de loja virtual, você recebe o trecho de código do tema com o nome do seu evento e uma orientação sobre onde inseri-lo.

Escolha do modelo e custo

Cada opção apresenta um custo estimado por geração, e a caixa indica o preço por milhão de tokens para o modelo selecionado. O custo é cobrado na sua própria conta do provedor, e não no seu plano do Workflow Trigger Extensions - uma única geração custa normalmente alguns centavos ou menos. Os modelos e preços sofrem alterações ao longo do tempo; as informações mais recentes estão disponíveis no site de cada provedor, cujos links constam abaixo de cada tabela.

Anthropic (Claude)

Modelo	Ideal para	Preço (entrada/saída por M tokens)
Claude Soneto 5	Equilíbrio entre velocidade e inteligência (padrão)	$2 / $10
Claude Opus 5	Trabalho complexo e proativo	$5 / $25
Claude Fable 5	Agentes de longa duração de última geração	$10 / $50
Claude Haiku 4.5	O mais rápido e o mais barato	$1 / $5

Modelos e preços mais recentes da Anthropic: platform.claude.com/documentação/en/models/overview

OpenAI

Modelo	Ideal para	Preço (entrada/saída por M tokens)
GPT-5.6 Terra	Equilibrado (padrão)	$2 / $12
GPT-5.6 Sol	Trabalho pioneiro e complexo	$4 / $20
GPT-5.6 Luna	Sensível ao custo	$0,20 / $1,20

Modelos mais recentes da OpenAI e preços: developers.openai.com/api/docs/models

O Google Gemini e o OpenRouter listam seus modelos com a mesma estimativa por geração no seletor de modelos. O OpenRouter oferece modelos de diversas empresas por meio de uma única chave.

O que ele sabe

O gerador recebe o contrato de tempo de execução deste aplicativo, portanto, utiliza as formas corretas:

export async function transform(payload, topic, shop, ctx), retornando um objeto para acionar o gatilho, ou null para ignorar o evento.
ctx.log(...) para o painel de logs e ctx.shopify(query, variables) para a API GraphQL de administração - que gera uma exceção em caso de erro e está limitada a 10 chamadas por execução.
O tópico ao qual seu gatilho está atento e o payload da amostra capturada para ele.

Ele não sabe quais permissões o senhor concedeu. Se o código gerado consultar um recurso ao qual o senhor não concedeu acesso, a chamada falhará em tempo de execução - consulte Permissões e acesso aos dados.