Como Construir um GPT Personalizado da OpenAI com uma API de Terceiros

Com o advento de Modelos de Linguagem de Grande Escala (LLM), a interface de usuário conversacional tornou-se muito popular. Você simplesmente pergunta o que está procurando, e o ChatGPT produz uma saída. Além disso, o modelo pode executar ações em resposta às suas instruções ou perguntas e apresentar-vos com o resultado. Isso abriu uma grande oportunidade para construir uma nova interface onde a única entrada é as palavras do usuário — escritas ou faladas.

Isso é fantástico, pois você pode imaginar as possibilidades ilimitadas. O que precisamos é que os LLM tenham acesso a quantas ações complexas, reais e mundiais quanto possível, que então invocem apropriadamente. Aqui é onde as APIs de terceiros entram em cena.

APIs de Plataforma

Escolha qualquer serviço da Internet popular e imagine uma API para ele que pode ser chamada para executar as tarefas usualmente realizadas por esse serviço. Cada serviço normalmente fornece uma interface de usuário gráfico (GUI) — seja como aplicativo web ou移动应用 — e os usuários logam para usá-lo. Mas em vez disso, e se o usuário só tivesse que pedir para uma única entidade — a interface de comando da LLM — através de comandos de texto ou áudio? Não seria necessária nenhuma outra interface.

Isso é interessante, porque agora você pode construir uma versão customizada do GPT que saiba executar certas ações extremamente bem, tornando-se um especialista ao fazer consumo das ações existentes. Ele conecta a intenção do usuário com a ação desejada e compartilha os resultados (saída) da ação realizada.

Especificação YAML OpenAPI

No caso do Custom GPT, isso é alcançado registrando qualquer API de terceiros usando sua especificação OpenAPI. Por exemplo, aqui está a especificação OpenAPI de uma plataforma para projeto de interiores por AI. A API permite criar um novo projeto de interiores usando apenas uma foto da sala. Enquanto a plataforma oferece sua própria aplicação web onde os usuários podem fazer o upload da foto da sala e selecionar estilos de projeto de interiores para gerar um novo projeto, você pode trazer essa funcionalidade para sua própria plataforma deployando-a como um Custom GPT.

Vamos criar um Custom GPT com essa API como exemplo. Você pode abrir qualquer API de terceiros com sua Especificação OpenAPI. Existem também ferramentas disponíveis que o ajudarão a construir uma Especificação OpenAPI para suas próprias APIs de plataforma. Acho que é uma ótima maneira de distribuir sua própria API para plataformas mais amplas.

Obter a API da Plataforma

A maioria das plataformas SaaS oferece sua API para que desenvolvedores possam construir suas aplicações. Eles também publicam uma especificação OpenAPI. Baixe a especificação. É um arquivo YAML que parece:

openapi: 3.1.0
info:
  title: Decor8AI Virtual Staging & Interior Design API
  version: "1.0"
  description: >
    Decor8 AI is a state-of-the-art virtual staging solution designed for realtors and real estate app developers. It provides a suite of customization options to create and visualize appealing interiors from empty spaces. With its focus on enhancing marketability, it's an essential tool for showcasing property potential in a compelling way.
    Please reach out to [Decor8 AI Team](mailto:[email protected]) with questions or suggestions.

    Additional license information can be found [here](https://github.com/immex-tech/decor8ai-sdk/blob/main/API_LICENSE_NOTICE).

    ### Iniciando

    - **Authentication**: Each API request requires two headers:
      - `Content-Type: application/json`
      - `Authorization: Bearer `

    - **API Key**: Get your `` from your account at [prod-app.decor8.ai](https://prod-app.decor8.ai).
  
    ### Entre no [Decor8 AI](https://prod-app.decor8.ai) e clique em APIs no menu Lateral Esquerdo

    ![](https://github.com/immex-tech/decor8ai-sdk/blob/main/media/step_1.jpg?raw=true)

    ### Clique em Gerar Chave de API
    ![](https://github.com/immex-tech/decor8ai-sdk/blob/main/media/step_2.jpg?raw=true)

    ### Testar a Chave de AI 
    Once you have the key, run simple curl command to test the key.

    ```
    curl -X GET "https://api.decor8.ai/speak_friend_and_enter" -H "Authorization: Bearer "
    ``` 

  license:
    name: Decor8AI SDK License
    url: https://github.com/immex-tech/decor8ai-sdk/blob/main/LICENSE
servers:
  - url: https://api.decor8.ai
    description: Base API URL for all endpoints.

Nota: esta não é uma especificação OpenAPI completa, mas apenas algumas linhas do arquivo para te dar uma ideia.

Abrir AI Personalizado GPT

Você precisa de uma assinatura Open AI para criar um Personalizado GPT. Vá até https://chat.openai.com/ e clique na imagem do perfil no canto superior direito da página.

Clique no menu “Minhas GPTs”. Aqui, vamos criar um novo Personalizado GPT (eu já tinha criado um Personalizado GPT e então você vê que já está nesta página).

Clique em “Criar uma GPT”. Você é apresentado com um formulário para definir as propriedades deste Personalizado GPT.

Clique na aba “Configurar”.

Forneça o Logo, Nome, Descrição e instruções iniciais.

Nas instruções, é importante definir regras de base. Por exemplo, você provavelmente quer definir o que a GPT deve fazer quando as pessoas fazem perguntas fora do escopo de expertise da GPT. A GPT pode dizer “Eu não sei” ou informar o usuário o que pode fazer por eles. Isso é muito útil para estabelecer expectativas de usuário corretas.

role para baixo na seção “Ações”.

Uma ação é o modo como a GPT saberá “o que chamar” quando certas condições forem atendidas. Cada uma das chamadas de API poderia tornar-se uma ação. Aqui é onde vamos precisar do arquivo YAML OpenAPI espec que baixamos anteriormente.

• Autenticação: Escolha Chave API

• Escolha o Tipo de Autenticação: Bearer

Obter a Chave API

Normalmente, cada API de Plataforma fornece um método de autenticação que envolve o uso de uma Chave de API. Obtenha a chave fazendo login nessa plataforma. Por exemplo, no caso do Decor8 AI, faça login em https://prod-app.decor8.ai e clique no menu APIs. Aqui você pode criar uma Chave de API. Copie e cole a chave no popup de Autenticação.

Em seguida, copie e cole o conteúdo do arquivo YAML da especificação OpenAPI na caixa de texto “Schema”.

Se a especificação estiver bem formatada, você verá uma lista das chamadas de API descritas na especificação. Agora você pode testá-las individualmente. Se você clicar no botão “Testar”, ele tentará invocar a API com os parâmetros de entrada corretos conforme descrito na especificação. Se precisar obter o valor do parâmetro de entrada, ele solicitará a você.

No caso da API do Decor8 AI, vamos testar a API “checkAuthentication” (que não é necessária para o próprio GPT). Sua invocação bem-sucedida significa que tudo foi configurado corretamente entre o Custom GPT e a plataforma alvo (Decor8 AI, neste caso).

Você pode testar as APIs restantes uma por uma para garantir que o GPT compreendeu as ações corretamente. O que você verificará é se o GPT pede informações adicionais se elas não foram fornecidas quando ele realiza a ação. Esta é a parte mais interessante do Custom GPT: ele “sabe” como chamar a API e construir os parâmetros de entrada conforme a especificação e, se faltar algum dado, ele pergunta ao usuário. É assim que a interface de usuário conversacional se parece:

Aqui, eu pedi-lhes que projetassem um interior de quarto com estilo de interior de casa de fazenda. Isto é para disparar uma das chamadas de API que, dada uma foto de uma sala, o tipo de sala e o estilo de design, pode gerar um novo projeto de interiores e retornar uma imagem.

Aqui está a imagem original de uma sala vazia (da URL mencionada na captura de tela acima):

Se eu clicar no “Ver Projeto de Quarto de Casas de Fazenda”, vemos:

Agora, você pode testar outras APIs para garantir que tudo estiver funcionando como esperado.

Crie e Publique a Personalização GPT

Certifique-se de revisar todas as propriedades para esta personalização GPT. Aqui está um exemplo de várias propriedades de configuração que eu defino para minha personalização GPT e acho que está pronta para ser publicada.

Clique no botão “Criar” ou “Atualizar” no canto superior direito e sua GPT está vivo na internet.

Por exemplo, minha personalização GPT está agora ao vivo. (Você precisa fazer login no OpenAI para acessá-la.)

Encerrando!

Construir personalizações GPT com terceiras partes API, como a Decor8 AI, é bem simples. Você pode construir sua GPT e adicionar as melhores plataformas do mercado a ela. Isso tornará sua GPT mais avançada e sofisticada bote de conversa, que consegue fazer muitas atividades úteis.

Espero que você tenha gostado deste tutorial, se você tem questões ou feedback, deixe-os na seção de comentários.