Ligar o Seu GPT a APIs Externas
Nesta página
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.
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