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 os dois ao mesmo tempo.

Cada ação é definida por dois componentes principais: como o GPT se autentica na 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 de GPT não poderão ser executadas, pois nenhum domínio de ação consegue passar nas verificações da allowlist. Isso não significa necessariamente que toda a visibilidade ou o acesso aos GPTs esteja bloqueado.

Ações não estão disponíveis no modo Pro; criar um GPT com ações personalizadas fará com que apenas os modelos Instant e Thinking fiquem disponíveis para seleção nele.

Criar uma ação

No editor de GPT, navegue até a seção Ações e selecione Criar nova ação.

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

Depois de configurar uma ação, teste-a em Prévia para confirmar que ela se comporta como 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 autenticação por chave de API para acesso servidor a servidor. Ela pode ser configurada como:

• Basic

• Bearer

• Cabeçalho personalizado

OAuth

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

• ID do cliente e Segredo do cliente

• URL de autorização e URL do token

• Escopo e método de troca de token

O editor fornece uma URL de callback 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 formas:

• Colar diretamente no editor

• Importar a partir de uma URL

• Começar a partir de um exemplo integrado:

  • Clima (JSON)

  • Pet Store (YAML)

  • Modelo em branco

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

Restrições do 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 estão restritas pelas configurações do seu workspace.

• 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 de ações e restrições de domínio no nível do workspace, veja: Gerenciando o acesso a GPTs em workspaces Enterprise e Edu.

Privacidade e controles do usuário

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

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

• Os usuários podem ser solicitados a aprovar ações antes de serem executadas.

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

Ajuda adicional

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