OpenAI
Esta página foi traduzida automaticamente. Veja o artigo original em inglês.

Como configurar ações em GPTs

Como conectar seu GPT a APIs externas usando ações, incluindo configuração, autenticação e configuração de schema.

Atualizado: this minute

Estamos planejando descontinuar os GPTs personalizados e ajudar os criadores a migrar seus fluxos de trabalho para plugins. Os plugins reúnem instruções reutilizáveis, arquivos de referência e aplicativos conectados.

Nos espaços de trabalho Enterprise afetados, a criação de novos GPTs foi encerrada em 26 de outubro de 2026. Os espaços de trabalho FedRAMP estão isentos dessa restrição e ainda podem criar GPTs. Os GPTs existentes que ainda não foram migrados podem continuar sendo usados e editados até a data de descontinuação aplicável a eles. Após a migração, o GPT original fica disponível apenas para leitura. A data padrão de descontinuação está prevista para 11 de dezembro de 2026. Para os espaços de trabalho FedRAMP e aqueles que atendem aos critérios para adiamento e tiveram a solicitação aprovada, a data de descontinuação é 11 de fevereiro de 2027.

A transição abrange todos os planos do ChatGPT, mas as restrições de criação e o acesso à migração dependem da conta ou do espaço de trabalho. Siga o aviso referente à sua conta ou ao seu espaço de trabalho. Para saber as datas, as etapas de migração e o que esperar nos outros planos, consulte: Perguntas frequentes sobre a descontinuação e a migração de GPTs personalizados.

Visão geral

Este artigo explica como configurar ações em um GPT, incluindo como se conectar a APIs externas, definir o que o GPT pode fazer e gerenciar autenticação, schemas e restrições de workspace.

Para configurar uma ação, você precisará dos detalhes da API do serviço ao qual deseja se conectar, incluindo informações de autenticação e um schema OpenAPI. Um GPT pode usar apps ou ações, mas não ambos ao mesmo tempo.

Cada ação é definida por dois componentes principais: como o GPT se autentica com a API e um schema que define o que a API pode fazer.

Limitações

Se o seu workspace permitir zero domínios de ação, as ações personalizadas do GPT não poderão ser executadas porque nenhum domínio de ação poderá passar pelas verificações da lista de permissões. Isso não significa necessariamente que toda a visibilidade ou o acesso ao GPT esteja bloqueado.

As ações não estão disponíveis para o modo Pro. Ao criar ou editar um GPT com ações personalizadas, o seletor de modelos mostra apenas modelos não Pro que oferecem suporte a ações.

Migração para plugins

As ações personalizadas não são transferidas automaticamente quando um GPT é migrado para um plugin. Configure e teste uma integração substituta antes de passar a depender do plugin. As instruções abaixo continuam válidas para os GPTs existentes que ainda não foram migrados e que você tem permissão para editar. Para orientações sobre a migração, consulte: Perguntas frequentes sobre a descontinuação e a migração de GPTs personalizados.

Criar uma ação

No editor de GPTs, acesse a seção Ações e selecione Criar nova ação.

Em seguida, você configurará como seu GPT se conecta a uma API externa e a utiliza.

Após configurar uma ação, teste-a em Prévia para confirmar que ela funciona conforme o esperado.

Autenticação

A autenticação controla como seu GPT se conecta a uma API externa.

Opções disponíveis:

  • Nenhuma: nenhuma autenticação necessária

  • Chave de API: usa uma chave secreta para autorizar solicitações

  • OAuth: usa o login do usuário para acesso baseado em conta

Chave de API

Use a autenticação por chave de API para acesso de servidor para servidor. Ela pode ser configurada como:

  • Básica

  • Bearer

  • Cabeçalho personalizado

OAuth

Use OAuth quando as ações exigirem contas de usuário. OAuth exige:

  • ID do cliente e segredo do cliente

  • URL de autorização e URL do token

  • Escopo e método de troca de tokens

O editor fornece uma URL de retorno de chamada para concluir o fluxo OAuth.

Schema

O schema define o que sua API pode fazer. Ele informa ao ChatGPT:

  • Qual servidor chamar

  • Quais endpoints estão disponíveis

  • Quais parâmetros eles aceitam

  • Como cada ação é identificada (IDs de operação)

O schema deve ser fornecido como uma especificação OpenAPI em JSON ou YAML.

Adicionar um schema

Você pode adicionar um schema de três maneiras:

  • Cole-o diretamente no editor

  • Importe-o de uma URL

  • Comece com um exemplo integrado:

    • Clima (JSON)

    • Loja de pets (YAML)

    • Modelo em branco

Se o schema for válido, o editor mostrará as ações detectadas. Se ele for inválido, erros de validação serão exibidos.

Restrições de workspace (Enterprise e Edu)

Se você vir a mensagem:


“Nenhum domínio é permitido pelas configurações do seu workspace.”

Isso significa que as ações são restritas pelas configurações do seu workspace.

  • Os administradores podem permitir todos os domínios ou restringir ações a domínios aprovados.

  • Se nenhum domínio for permitido, você não poderá usar ações.

Para controles no nível do workspace sobre ações e restrições de domínio, consulte: Gerenciamento do acesso a GPT em workspaces Enterprise e Edu.

Privacidade e controles do usuário

  • Cada ação pode incluir uma URL de política de privacidade.

  • GPTs públicos (link ou GPT Store) com ações devem incluir uma URL de política de privacidade válida.

  • Os usuários podem ser solicitados a aprovar ações antes que elas sejam executadas.

  • Para ações OAuth, os usuários podem revisar e gerenciar contas conectadas.

Ajuda adicional

Para obter ajuda para escrever ou depurar ações, use o ActionsGPT oficial.

Este artigo foi útil?