Criar uma ação
Este guia aborda a definição de uma ação na interface do usuário do LLM Apps. Para obter informações sobre quais ações são executadas e como elas funcionam, consulte Conceitos principais.
Abra a página Ações
Navegue até Ações na barra lateral esquerda ou clique em Ir para Ações na página Detalhes do Aplicativo. Se nenhuma ação ainda não existir, a página mostrará um estado vazio.
Clique em + Criar Ação para abrir a caixa de diálogo de tela cheia.
Cartões de ação
Cada ação é exibida como um cartão que mostra:
- O nome e a descrição da ação
- Uma imagem de visualização do widget — gerada automaticamente a partir do widget, mostrando como a saída da ação se parece dentro da plataforma LLM
- Medalhas: tipo de widget (EDS), status da implantação (Não implantada, Implantada no preparo, Implantada na produção), Alterações não implantadas quando a ação foi modificada desde a última implantação e contagem de parâmetros
- Uma opção de Visibilidade — habilita ou desabilita a ação no ponto de extremidade ativo sem reimplantar
- Um link Revisão no canto superior direito para abrir o editor de ações
Quando uma ou mais ações foram modificadas desde a última implantação, um banner Implantação necessária é exibido na parte superior da página Ações. Reimplante o aplicativo para aplicar as alterações.
Guia Ação
A caixa de diálogo tem duas guias: Ação e Metadados do widget.
Informações básicas
-
Nome da ação (obrigatório) — o identificador da sua ação (por exemplo, Pesquisar Produtos).
-
Descrição (obrigatório) — uma explicação clara do que a ação faz. A plataforma LLM usa isso para decidir quando invocar sua ação. Por exemplo: Pesquise o catálogo de produtos por palavra-chave. Retorna produtos correspondentes com nome, categoria, imagem e preço.
-
Anotações — dicas opcionais que descrevem o comportamento da ação:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Anotação Descrição Dica destrutiva A ação modifica ou exclui dados Idempotente Chamar a ação várias vezes com os mesmos argumentos produz o mesmo resultado Abrir dica do mundo A ação interage com sistemas externos Dica somente leitura A ação lê apenas dados, nunca grava Consulte Referência: Campos de Metadados para obter detalhes.
Metadados do OpenAI
- Texto de status de chamada — a mensagem mostrada na plataforma LLM enquanto a ação é executada (máximo de 64 caracteres). Exemplo: Carregando produtos…
- Texto de status chamado — a mensagem mostrada após a ação ser concluída (máximo de 64 caracteres). Exemplo: Produtos carregados.
Visibilidade e parâmetros de entrada
Visibilidade controla onde a ação está disponível:
- Expor ao modelo de IA — a ação pode ser invocada pelo modelo de IA.
- Mostrar como widget na superfície do aplicativo — a ação renderiza um widget visual.
Parâmetros de entrada são os valores que a plataforma LLM envia para o seu manipulador. O modelo os extrai automaticamente da mensagem do usuário. Para Pesquisar Produtos, definimos:
- categoria (Cadeia de caracteres, opcional) — filtro de categoria para restringir resultados (por exemplo, um tipo de produto ou departamento).
- consulta (Cadeia de caracteres, opcional) — termo de pesquisa de texto livre.
Cada parâmetro tem uma caixa de seleção Nome, Tipo (Cadeia de caracteres, Número, Inteiro, Booleano), Descrição e Obrigatório. Clique em + Adicionar para adicionar mais parâmetros.
Para obter mais detalhes, consulte Referência: Parâmetros de ação.
Analytics
- Tentativa de usuário — quando habilitada, ChatGPT é solicitado a resumir a conversa que levou a chamar esta ação. Esse resumo é coletado e exibido na análise, fornecendo insight sobre o que os usuários estavam tentando realizar quando a ação foi acionada.
Guia Metadados do widget
Esta guia configura como a resposta visual da ação é renderizada na plataforma LLM. Para obter uma explicação completa de como os widgets funcionam, consulte Guia: Configurar o Widget (EDS).
Informações do widget
- Tipo — a tecnologia de widget (atualmente EDS).
- Domínio do widget (origem da sandbox) — a origem em que o widget está hospedado. Necessário para o envio do aplicativo para OpenAI; deve ser exclusivo por aplicativo.
- Borda preferencial — renderiza o widget dentro de um cartão com bordas.
URLs de modelo
- URL do Script — o ponto de entrada que inicializa o widget, compartilhado em todas as ações:
https://main--<repo>--<owner>.aem.live/scripts/aem-embed.js - URL de inserção do dispositivo — a página EDS para esta ação específica:
https://main--<repo>--<owner>.aem.live/eds-widgets/<action-name>
Permissões
APIs de hardware e navegador que o dispositivo pode acessar:
Configuração da CSP
Controla quais domínios externos o iframe do widget pode contatar. Cada domínio externo deve ser explicitamente classificado.
fetch, XHR ou WebSocketopenExternal links de redirecionamento (ChatGPT-específico)base-uri (somente SDK de aplicativos MCP, sem suporte de ChatGPT)Clique em Criar nova ação para salvar.
Depois de criar uma ação
Sua ação aparece como um cartão na página Ações:
Cada cartão mostra o nome da ação, a descrição, o símbolo de tipo (EDS), o status da implantação (Não implantada) e a contagem de parâmetros. Você pode clicar em … para editar ou excluir, ou em Revisar para inspecionar a configuração.
Os metadados da ação são salvos, mas nenhum código foi implantado ainda. Para tornar a ação funcional, é necessário:
- Configurar o widget EDS — consulte o Guia: Configurar o Widget (EDS).
- Gravar o manipulador — consulte o Guia: Gravar o Manipulador de Ação.
- Implantar — consulte o Guia: Implantar Seu Aplicativo.