Descrição geral

Este artigo explica como configurar ações num GPT, incluindo como ligar a APIs externas, definir o que o GPT pode fazer e gerir autenticação, schemas e restrições do espaço de trabalho.

Para configurar uma ação, precisará dos detalhes da API do serviço ao qual pretende ligar-se, incluindo informações de autenticação e um schema OpenAPI. Um GPT pode utilizar aplicações ou ações, mas não ambas ao mesmo tempo.

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

Limitações

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

As ações não estão disponíveis no modo Pro. Quando cria ou edita um GPT com ações personalizadas, o seletor de modelos mostra apenas modelos não Pro que suportam ações.

Criar uma ação

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

Em seguida, irá configurar a forma como o seu GPT se liga a uma API externa e a utiliza.

Depois de configurar uma ação, teste-a em Pré-visualização para confirmar que se comporta conforme esperado.

Autenticação

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

Opções disponíveis:

• Nenhuma: não é necessária autenticação

• Chave de API: utiliza uma chave secreta para autorizar pedidos

• OAuth: utiliza o início de sessão do utilizador para acesso baseado na conta

Chave de API

Utilize a autenticação por chave de API para acesso de servidor para servidor. Pode ser configurada como:

• Básica

• Bearer

• Cabeçalho personalizado

OAuth

Utilize OAuth quando as ações exigirem contas de utilizador. O OAuth requer:

• ID do cliente e segredo do cliente

• URL de autorização e URL do token

• Âmbito e método de troca de tokens

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

Schema

O schema define o que a sua API pode fazer. Indica ao ChatGPT:

• Que servidor chamar

• Que endpoints estão disponíveis

• Que parâmetros aceitam

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

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

Adicionar um schema

Pode adicionar um schema de três formas:

• Colá-lo diretamente no editor

• Importá-lo a partir de um URL

• Começar a partir de um exemplo integrado:

  • Meteorologia (JSON)

  • Pet Store (YAML)

  • Modelo em branco

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

Restrições do espaço de trabalho (Enterprise e Edu)

Se vir a mensagem:


“Nenhum domínio é permitido pelas definições do seu espaço de trabalho.”

Isto significa que as ações estão restringidas pelas definições do seu espaço de trabalho.

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

• Se não forem permitidos domínios, não poderá utilizar ações.

Para controlos ao nível do espaço de trabalho sobre ações e restrições de domínios, consulte: Gerir o acesso a GPTs em espaços de trabalho Enterprise e Edu.

Privacidade e controlos do utilizador

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

• Os GPTs públicos (ligação ou GPT Store) com ações têm de incluir um URL de política de privacidade válido.

• Pode ser pedido aos utilizadores que aprovem ações antes de estas serem executadas.

• Para ações OAuth, os utilizadores podem rever e gerir contas ligadas.

Ajuda adicional

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