Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Ligar o Seu GPT a APIs Externas

Aula 9 de 17 Atualizada a 5 de novembro de 2026 Intermediario
Nesta página
  1. Para Além do GPT Isolado
  2. O Que É uma Ação?
  3. O Esquema OpenAPI
  4. Configurar uma Ação no Editor de GPT
  5. A Sua Vez: Uma API Pública
  6. Pontos-chave

Estado em 5 de novembro de 2026: os GPTs estão nas suas últimas semanas. A OpenAI vai desativar os GPTs personalizados a 11 de dezembro de 2026 (11 de fevereiro de 2027, para certos espaços de trabalho Enterprise com isenção). As contas Pessoal, Gratuita, Go, Plus e Pro já não podem criar ou publicar novos GPTs; nos espaços de trabalho Business, Enterprise e Edu, a criação depende das definições e cessou a 26 de outubro de 2026 nos espaços Enterprise afetados. Os GPTs existentes permanecem utilizáveis e editáveis se o seu plano o permitir até à desativação; as suas conversas com eles permanecerão acessíveis posteriormente. A migração (Migrate to plugin, em My GPTs) converte as instruções numa competência (skill), a base de conhecimento em ficheiros de referência e as aplicações ligadas em aplicações; as ações personalizadas não são transferidas. Esta lição explica como funcionam os GPTs para o ajudar a mantê-los, migrá-los e adaptar os seus princípios a um plugin (Lições 15–17).

Para Além do GPT Isolado

Até agora, o seu GPT operou num silo: as suas instruções definem o seu comportamento e o seu Conhecimento fornece os seus documentos. Isso é poderoso, mas mantém-no isolado do mundo em tempo real. Não consegue verificar o seu CRM em tempo real, criar um evento no calendário ou consultar a sua base de dados — só sabe o que carregou, congelado no momento do carregamento. As Ações removem este limite: permitem que o seu GPT chame APIs externas para ler e escrever dados nas suas ferramentas durante uma conversa.

O Que É uma Ação?

Uma Ação é uma ligação entre o seu GPT e um serviço externo através da sua API. O fluxo é sempre o mesmo: o utilizador faz uma pergunta ou dá uma instrução, o GPT identifica que precisa de dados externos para responder, chama a API do serviço, recebe a resposta e integra-a na sua resposta final. Considere um GPT de vendas ligado a um CRM: quando um utilizador pergunta “Qual é o estado do processo Dupont?”, o GPT consulta a API do CRM, recupera o registo do cliente e responde com os dados de hoje — não com a memória de um ficheiro carregado há três meses. Tudo isto acontece de forma transparente para o utilizador, que tem simplesmente a sensação de estar a falar com um assistente bem informado.

O Esquema OpenAPI

Para que o GPT chame uma API, tem de a descrever. É essa a função do esquema OpenAPI (anteriormente Swagger), um ficheiro JSON ou YAML que serve de manual de instruções da API. Descreve os endpoints — os URLs que o seu GPT pode chamar —, os métodos associados (GET para ler, POST para criar, PUT para atualizar, DELETE para eliminar), os parâmetros esperados por cada endpoint e o formato das respostas devolvidas. Com base neste documento, o GPT decide autonomamente, durante a conversa, qual o endpoint a chamar e com quais parâmetros.

Eis o aspeto de um esquema mínimo para uma API de meteorologia fictícia:

openapi: 3.1.0
info:
  title: Weather API
  version: 1.0.0
servers:
  - url: https://example.com
paths:
  /forecast:
    get:
      operationId: getForecast
      summary: Get weather forecast for a city
      parameters:
        - name: city
          in: query
          required: true
          schema:
            type: string
      responses:
        "200":
          description: Weather forecast

Boas notícias: quase nunca terá de escrever este ficheiro do zero. Muitos serviços publicam o seu esquema OpenAPI diretamente na documentação da API. Se não for o caso, ferramentas como o Swagger Editor — ou o próprio ChatGPT, se lhe descrever a API — podem geri-lo. E se a sua equipa técnica trabalhar com o Postman, as suas coleções exportam para o formato OpenAPI.

Configurar uma Ação no Editor de GPT

A configuração ocorre no seu editor de GPT na web: aceda à secção Actions, clique em Create new action, cole o seu esquema OpenAPI no campo fornecido, configure a autenticação (abordada na próxima lição) e, em seguida, teste a ação a partir do painel de pré-visualização.

A qualidade do seu esquema determina a qualidade das chamadas. Mantenha três hábitos em mente. Primeiro, atribua nomes explícitos aos valores de operationId: o GPT baseia-se neles para decidir qual a ação a chamar, e getForecast orienta-o muito melhor do que op_42. De seguida, escreva descrições claras para cada endpoint e parâmetro — em linguagem natural, como se estivesse a explicar a API a um colega. Por fim, exponha apenas os endpoints de que realmente precisa: se o seu GPT só precisar de duas ou três rotas, não exponha todas as quarenta rotas da API completa. Cada endpoint exposto ocupa espaço no contexto do GPT e aumenta o risco de este escolher o errado.

Uma ação em quatro passos Quatro passos: descreva a API com um esquema OpenAPI em JSON ou YAML; escolha a autenticação, nenhuma, chave ou OAuth; teste na pré-visualização; o GPT chama então a API quando for útil. LIGAR UMA API Uma ação em quatro passos 1 Esquema OpenAPI, JSON ou YAML 2 Acesso Nenhuma, chave ou OAuth 3 Teste Na pré-visualização 4 Utilização O GPT chama a API Sem ações no modo Pro, e as ações não são transferidas para um plugin.
Com base no artigo "Configuring actions in GPTs" do Centro de Ajuda da OpenAI (novembro de 2026).

A Sua Vez: Uma API Pública

A sua primeira ação, ou o seu planeamento. O melhor terreno de treino é uma API pública e gratuita — meteorologia, taxas de câmbio, notícias — que não exija autenticação complexa. Escolha uma, recupere ou crie o seu esquema OpenAPI e adicione-o como uma Ação no seu GPT. Não se esqueça de ligar a Ação às suas instruções, especificando quando a deve usar: “Quando o utilizador pedir a meteorologia, use a ação getForecast.” Depois, teste com várias formulações diferentes para verificar se o GPT aciona a chamada no momento certo.

Algumas armadilhas aguardam as primeiras tentativas. Um esquema mal formatado — uma única vírgula em falta no JSON — bloqueia tudo: valide sempre o seu esquema no Swagger Editor antes de o colar. Descrições em falta deixam o GPT cego: sem elas, não sabe quando uma ação é relevante. Preveja também erros da API, que mais tarde ou mais cedo ocorrerão: especifique o comportamento nas suas instruções, por exemplo, “Se a API não responder, diga ao utilizador para tentar novamente mais tarde” — caso contrário, o GPT improvisará, por vezes inventando dados. E não confie apenas no painel de pré-visualização: teste em condições reais, com dados reais e formulações reais de utilizadores.

Conheça dois limites antes de começar: um GPT utiliza aplicações ligadas ou ações, não ambas, e as ações não funcionam no modo Pro. Mais importante ainda, as ações personalizadas não são transferidas para um plugin durante a migração: verifique primeiro se o diretório de plugins já oferece uma aplicação para o serviço alvo; se não oferecer, terá de reconstruir a integração, por exemplo com um servidor MCP.

Fontes oficiais: Configuring actions in GPTs (Centro de Ajuda da OpenAI: autenticação, esquema OpenAPI, testes, limites) · Custom GPT retirement and migration FAQ (as ações não são transferidas) · OpenAPI Specification (formato do esquema)

Pontos-chave

  • As ações ligam o seu GPT a serviços externos através das suas APIs
  • Tem de fornecer um esquema OpenAPI que descreva os endpoints disponíveis
  • As descrições no esquema são essenciais — o GPT usa-as para decidir qual a ação a chamar
  • Comece com uma API pública gratuita para se familiarizar com o processo
  • Limite os endpoints expostos ao estritamente necessário para o seu caso de uso