Gerar código de gatilho com IA

Copiar página

Ligue a sua chave API da Anthropic (Claude) ou da OpenAI e descreva um gatilho personalizado em inglês simples - o editor cria a transformação por si.

Descreva o que pretende em linguagem simples e deixe que a IA escreva o código. Esta funcionalidade utiliza a sua própria chave do fornecedor de IA e baseia-se no contrato de tempo de execução desta aplicação, na API de administração do Shopify e - assim que tiver capturado um - na carga útil real do evento que o seu gatilho recebe.

Ligar um prestador

Em «Desenvolvedor» → «Ligações», adicione a sua chave API para o fornecedor da sua preferência: Anthropic (Claude), OpenAI, Google Gemini ou OpenRouter.

A sua chave é encriptada quando está em repouso e é utilizada apenas para a geração. Nunca é executada no seu código de gatilho e nunca mais é apresentada depois de a guardar.
Cada cartão contém uma ligação para um pequeno guia: Como obter uma chave API da Anthropic (Claude), Como obter uma chave da API da OpenAI, Como obter uma chave da API do Google Gemini ou Como obter uma chave API do OpenRouter.
Quando efetua a sua solicitação, o código atual e o evento de amostra capturado são enviados para esse prestador de serviços, associado à sua conta.

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

O separador «Conexões» da página «Desenvolvedor», com cartões relativos à Anthropic, OpenAI, Google Gemini e OpenRouter, sendo que a Anthropic apresenta a conexão «Key» — Desenvolvedor, Ligações: um cartão por prestador de serviços. Uma chave ligada nunca é apresentada novamente, sendo apenas substituída ou desligada.

Criar um gatilho personalizado

Abra um gatilho personalizado. Com um fornecedor ligado, surge uma caixa «Gerar com IA» 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:

Apenas execute a ação quando o total do pedido for superior a 500 e o pedido tiver a tag «vip». Envie o número do pedido, o total e a moeda para o Shopify Flow.
Escolha um fornecedor (caso tenha ligado mais do que um) e um modelo e, em seguida, selecione «Gerar».
O código é carregado no editor como uma alteração não guardada. Reveja-o, teste-o e, em seguida, guarde-o. Se já existir código, este será editado em vez de se começar do zero, pelo que a opção «agora faça também X» se baseia no que já tem.

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

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

Gerar um fragmento de código para a loja virtual

Um Gatilhos personalizados da loja virtual funciona de forma diferente: não tem qualquer transformação para escrever. O que tem de criar é o código JavaScript que publica o evento a partir do seu tema, e é nessa parte que as pessoas têm dificuldades - cada tema atribui nomes diferentes aos seus elementos.

Abra o gatilho da loja virtual e utilize a opção «Gerar o snippet com IA». Descreva a ação que deve acioná-lo («quando a gaveta do carrinho se abrir no Dawn, enviar a contagem de artigos e o total do carrinho») e obterá um snippet pronto a utilizar com o nome do evento que registou, além de instruções sobre onde o colar.

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

O cartão «Gerar o trecho com IA» de um gatilho da loja virtual, com um trecho gerado para a gaveta do carrinho Dawn e uma nota indicando onde o colar — No caso de um gatilho de loja virtual, recebe o fragmento de código do tema com o nome do seu evento e uma indicação sobre onde o deve inserir.

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 de fornecedor, e não no seu plano Workflow Trigger Extensions - uma única geração custa normalmente alguns cêntimos ou menos. Os modelos e os preços variam ao longo do tempo; os mais recentes encontram-se no site de cada fornecedor, cujos links constam por baixo 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 (predefiniçã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 (predefinição)	2 $ / 12 $
GPT-5.6 Sol	Trabalho pioneiro e complexo	4 $ / 20 $
GPT-5.6 Luna	Sensível aos custos	0,20 $ / 1,20 $

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

O Google Gemini e o OpenRouter apresentam os seus modelos com a mesma estimativa por geração no seletor de modelos. O OpenRouter disponibiliza-lhe modelos de várias empresas através de uma única chave.

O que sabe

O gerador recebe o contrato de tempo de execução desta aplicação, pelo que utiliza as formas corretas:

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

Não sabe quais as autorizações que concedeu. Se o código gerado consultar um recurso ao qual não concedeu acesso, a chamada falha em tempo de execução - consulte Autorizações e acesso aos dados.