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.

Criar uma ação

No editor de GPT, navegue até 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 usa.

Depois de configurar uma ação, teste-a em Prévia para confirmar que ela se comporta conforme 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.