Com o advento de Modelos de Linguagem Grande (LLM), a interface de conversação tornou-se muito popular. Você simplesmente pergunta o que está procurando, e o ChatGPT produz uma saída. Além disso, o modelo pode realizar ações em resposta à sua comando ou pergunta e apresentar o resultado. Isto abriu uma grande oportunidade para construir um novo tipo de interface onde a única entrada é as palavras do usuário — escritas ou faladas.
Isso é fantástico, como podem imaginar as possibilidades ilimitadas. O que precisamos é que os LLM tenham acesso a quantas ações complexas, reais quanto possível, que então chamam 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 realizar as tarefas usualmente realizadas por esse serviço. Cada serviço normalmente fornece uma interface de usuário gráfico (GUI) — seja como uma aplicação web ou mobile app — e os usuários logam para usá-la. Mas em vez disso, o que seja se o usuário só tiver que pedir para uma única entidade — a interface de comando do 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 personalizada do GPT que saiba fazer certas ações extremamente bem, tornando-se um especialista ao fazer consciência da existência dessas ações. 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 terceirizada usando sua especificação OpenAPI. Por exemplo, aqui está a especificação OpenAPI de uma plataforma para design de interiores por AI. A API permite que você crie um novo design 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 design de interiores para gerar um novo design de interiores, você pode trazer essa funcionalidade para sua própria plataforma implantando-a como um Custom GPT.
Vamos construir um Custom GPT com essa API como exemplo. Você pode embarcar qualquer API terceirizada 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 de SaaS oferece sua API para que desenvolvedores possam construir seus aplicativos. Elas 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
### Clique em Gerar Chave de API
### Teste 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 um plano de assinatura Open AI para criar um Personalizado GPT. Vá para 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á criei um Personalizado GPT e portanto você vê isso já 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 Logotipo, Nome, Descrição e instruções iniciais.
Nas instruções, é importante definir regras básicas. Por exemplo, você quereria definir o que a GPT deve fazer quando as pessoas perguntam questões fora do domínio de expertise da GPT. A GPT pode dizer “Eu não sei” ou informar à pessoa o que ele pode fazer por ela. Isto é muito útil para definir expectativas de usuário corretas.
Role para baixo na seção “Ações”.
Uma ação é como a GPT vai saber “o que chamar” quando certas condições forem atendidas. Cada uma das chamadas API pode 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 entrando nessa plataforma. Por exemplo, no caso da 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 da 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 o restante das APIs uma por uma para garantir que o GPT entendeu as ações corretamente. O que você verificará é se o GPT pede por informações adicionais caso não sejam fornecidas quando 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 algum dado estiver faltando, ele pergunta ao usuário. É assim que a interface de usuário conversacional se parece:
Aqui, eu pedi para que ela projetasse um interior de quarto com estilo de interior de casa de fazenda. Isto é para chamar uma das chamadas de API, que dado uma foto de uma sala, o tipo de sala e o estilo de design interiores, pode gerar um novo projeto de interior 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 Casa de Fazenda”, vemos:
Agora, você pode testar outras APIs para ter certeza de que tudo está funcionando como esperado.
Criar e Publicar 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 configurei 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 de API, como Decor8 AI, é bem simples. Você pode construir sua GPT e adicionar as melhores plataformas de sua escolha. Isto tornará sua GPT mais avançada e sofisticada, chatbot que poderá fazer muitas atividades úteis.
Espero que você tenha gostado deste tutorial, se tiver questões ou feedback, deixe-os na seção de comentários.
Source:
https://dzone.com/articles/how-to-build-an-openai-custom-gpt-with-3rd-party-api