Crie uma função de API com ChatGPT

Gere o payload JSON de uma função com a integração ChatGPT no editor de Azion Console e leia a resposta com Preview deployment.

Última atualização

Ver como Markdown Configurar agente

Você cria uma função que responde a uma requisição GET com HTML e a uma requisição POST com JSON. A integração com ChatGPT do editor de código de Azion Console escreve o payload JSON a partir de um comentário.

Duas páginas vizinhas cobrem as partes que esta deixa de fora:

Pré-requisitos

Declare as credenciais da OpenAI

A integração usa as credenciais da sua própria conta OpenAI. Ela lê essas credenciais de um comentário no código-fonte da função, então elas vêm primeiro.

Para colocar as credenciais no código-fonte de uma nova função:

Abra a página Functions

Acesse Azion Console > Products Menu > Libraries > Functions.

Selecione + Function
Nomeie a função

Insira um nome para a função. Por exemplo: chatgpt-api.

Substitua o código predefinido na tab Code

Na tab Code, substitua o código predefinido pelos dois valores da sua conta OpenAI:

JavaScript
01/*
02ChatGPTKey=[TOKEN VALUE]
03ChatGPTOrg=<your-organization-id>
04*/

Os comandos da integração no editor agora autenticam com sua conta OpenAI.

nota — Azion Console não renderiza nenhum preview enquanto o código-fonte não tiver uma função PreviewProvider. O preview mostra um aviso que nomeia a função ausente. Uma seção adiante adiciona essa função.

Gere os dados de resposta com ChatGPT

A geração de código transforma um comentário em JavaScript. O comando ChatGPT: Generate lê o comentário selecionado como prompt e escreve o código que retorna.

Para gerar o objeto que a API retorna:

Insira o prompt como um comentário

Abaixo das credenciais, insira o comentário que descreve o objeto:

// generate an object with 5 properties being 2 of them array of objects
Selecione o comentário
Abra o menu de contexto do editor e selecione ChatGPT: Generate

A requisição leva alguns segundos.

Leia o código gerado

A integração escreve o objeto no editor. A saída é semelhante a:

JavaScript
01let myObject = {
02 property_1: 'value_1',
03 property_2: 10,
04 property_3: true,
05 property_4: [{object_1: 'value_1'}, {object_2: 'value_2'}],
06 property_5: [{object_3: 'value_3'}, {object_4: 'value_4'}]
07};

O código-fonte agora carrega o objeto que a API retorna para uma requisição POST.

Monte o handler

O objeto gerado é dado. O handler decide o que a função retorna para cada método de requisição. Um handler fetch ramifica por request.method: o markup para um GET, o objeto para um POST.

Complete o código-fonte com a constante HTML, o handler e a exportação padrão:

JavaScript
01const html = `<!DOCTYPE html>
02<body>
03 <h1>Hello World</h1>
04 <p>This markup was generated by Azion Functions.</p>
05</body>`;
06
07let myObject = {
08 property_1: 'value_1',
09 property_2: 10,
10 property_3: true,
11 property_4: [{object_1: 'value_1'}, {object_2: 'value_2'}],
12 property_5: [{object_3: 'value_3'}, {object_4: 'value_4'}]
13};
14
15async function handleRequest(request) {
16 switch (request.method) {
17 case 'GET':
18 return new Response(html, {
19 headers: {
20 'content-type': 'text/html;charset=UTF-8',
21 },
22 });
23 case 'POST':
24 return new Response(JSON.stringify(myObject), {
25 headers: {
26 'content-type': 'application/json',
27 },
28 });
29 }
30}
31
32export default {
33 async fetch(request, env, ctx) {
34 return handleRequest(request);
35 },
36};

Cada ramificação declara no cabeçalho content-type o formato que retorna:

  • O caso GET retorna a constante html como text/html;charset=UTF-8.
  • O caso POST retorna o objeto gerado como application/json.

O switch cobre GET e POST. Adicione um caso para cada outro método que a API responde.

A exportação padrão é o padrão ES Modules, a forma recomendada de estruturar uma função. Para mover código existente do padrão legado Service Worker, consulte Migre padrões de handler em Functions.

O código-fonte agora carrega o handler completo da API.

Visualize a resposta

Preview deployment executa a função em Azion Console e mostra a resposta que o código retorna. Ele chama PreviewProvider, uma função auxiliar no código-fonte que monta uma requisição simulada para o handler.

Para ler as duas respostas antes que a função atenda tráfego:

Adicione uma função PreviewProvider ao código-fonte

PreviewProvider monta a requisição que o preview envia e retorna a resposta que o preview renderiza. Adicione a função abaixo da exportação padrão, com GET como método:

JavaScript
01function PreviewProvider(args) {
02 var request = new Request("https://www.azion.com/example", {
03 method: "GET",
04 headers: {
05 "Content-Type": "application/json",
06 },
07 redirect: "follow",
08 });
09 return handleRequest(request);
10}

Para cada valor que a requisição simulada carrega, consulte Função PreviewProvider.

Abra o menu de contexto do editor e selecione Format Document
Leia a saída no editor de código

O preview renderiza a resposta text/html como a página. Selecione Open para ler a mesma saída em uma aba separada do navegador.

Altere o método dentro de PreviewProvider para POST
Leia a saída novamente

O preview renderiza a resposta application/json como o corpo JSON do objeto gerado.

As duas respostas da função aparecem em Azion Console, sem nenhum deployment.

Salve a função

O código-fonte completo carrega as credenciais, o objeto gerado, o handler e a função de preview:

JavaScript
01/*
02ChatGPTKey=[TOKEN VALUE]
03ChatGPTOrg=<your-organization-id>
04*/
05
06const html = `<!DOCTYPE html>
07<body>
08 <h1>Hello World</h1>
09 <p>This markup was generated by Azion Functions.</p>
10</body>`;
11
12let myObject = {
13 property_1: 'value_1',
14 property_2: 10,
15 property_3: true,
16 property_4: [{object_1: 'value_1'}, {object_2: 'value_2'}],
17 property_5: [{object_3: 'value_3'}, {object_4: 'value_4'}]
18};
19
20async function handleRequest(request) {
21 switch (request.method) {
22 case 'GET':
23 return new Response(html, {
24 headers: {
25 'content-type': 'text/html;charset=UTF-8',
26 },
27 });
28 case 'POST':
29 return new Response(JSON.stringify(myObject), {
30 headers: {
31 'content-type': 'application/json',
32 },
33 });
34 }
35}
36
37export default {
38 async fetch(request, env, ctx) {
39 return handleRequest(request);
40 },
41};
42
43function PreviewProvider(args) {
44 var request = new Request("https://www.azion.com/example", {
45 method: "GET",
46 headers: {
47 "Content-Type": "application/json",
48 },
49 redirect: "follow",
50 });
51 return handleRequest(request);
52}

Para armazenar o código, selecione Save.

Azion Console armazena a função e a disponibiliza para ser instanciada em uma aplicação. A função não atende tráfego até que uma instância a vincule e uma regra do Rules Engine selecione essa instância.

Próximos passos

Execute uma função em uma aplicaçãoAdicione a regra do Rules Engine que executa a instância, em Azion Console ou na Azion API.Integração com ChatGPTAs credenciais, os comandos do editor e a refatoração de código.Preview deploymentTodos os valores que a requisição simulada carrega e como o preview renderiza cada formato.Escreva e teste uma funçãoOs padrões de handler de uma função e onde ler a saída de log dela.Instâncias de funçãoPasse Args para uma instância em JSON.Crie uma API RESTful com Functions e SQLUma API apoiada por um banco de dados, com operações de criação, leitura, atualização e exclusão.