Tutorial: Utilizzo di Gemini Code Assist per progettare, sviluppare e testare le API in Apigee e Cloud Code

Questa pagina si applica ad Apigee e Apigee hybrid.

Panoramica

Questo tutorial illustra la procedura di utilizzo dell'Assistente codice Gemini in Cloud Code per progettare un'API e creare un proxy API Apigee da una specifica API generata. In questo tutorial, utilizzerai un prompt in linguaggio naturale per progettare e creare un'API che gestisce i post del blog correlati agli sport per un sito web.

Prima di iniziare

Per completare questo tutorial, avrai bisogno di:

  • L'API Gemini for Google Cloud configurata per il tuo progetto Apigee oppure devi essere un amministratore dell'organizzazione Apigee per poterla aggiungere. Per la procedura di configurazione di Gemini Code Assist, consulta Utilizzare Gemini Code Assist.
  • Devi essere un amministratore API Apigee nel tuo progetto Apigee.
  • Per configurare lo sviluppo locale per il tuo progetto Apigee in Cloud Code, se non l'hai già fatto, consulta Configurazione di Apigee API Management in Cloud Code per VS Code.
  • Familiarità con le specifiche OpenAPI, in modo da poter esaminare la specifica generata.
  • (Facoltativo) Hub API configurato per questo progetto. Sebbene non sia strettamente necessario per utilizzare le funzionalità di Gemini Code Assist descritte qui, non potrai eseguire tutti i passaggi senza l'hub API.

Passaggio 1: carica Apigee in Cloud Code

Apri VS Code e fai clic sull'icona Cloud Code. Dovresti vedere il tuo progetto Apigee e le eventuali API.

Menu a sinistra di Cloud Code Gemini Code Assist

Passaggio 2: apri la scheda Crea una specifica API e inserisci un prompt

Fai clic sulla bacchetta magica nella riga Apigee per aprire la scheda di creazione delle specifiche.

Bacchetta magica per la creazione di specifiche di Gemini Code Assist per Cloud Code

La scheda mostra i modelli che puoi utilizzare per avviare il prompt dell'API. Sotto questi campi è disponibile un campo di immissione del prompt di modulo libero. Fai clic su API per i contenuti del blog. Nel campo di immissione del prompt viene inserito un prompt in linguaggio naturale che descrive questa API.

Modulo per la creazione di specifiche di Cloud Code Gemini Code Assist

Passaggio 3: crea e visualizza la specifica

Fai clic su Crea per generare una specifica API da questo prompt. Attendi che venga generata la specifica. Il riquadro Output mostra i passaggi durante la creazione della specifica.

Una volta creata, visualizza la descrizione, gli endpoint e gli schemi della specifica scorrendo verso il basso. Per visualizzare il codice della specifica OpenAPI, fai clic su Visualizza codice.

Endpoint delle specifiche di Gemini Code Assist di Cloud Code

Passaggio 4: modifica il prompt e ricrea la specifica

Torna al prompt e aggiungi il tipo di sport nell'ambito dell'oggetto dati.

Prompt modificato da Gemini Code Assist di Cloud Code

Fai di nuovo clic su Crea per rigenerare la specifica. Vedrai il tipo di sport nella specifica aggiornata.

Tieni presente che puoi anche tornare al prompt precedente facendo clic sulla cronologia dei prompt nella parte superiore della casella di immissione del prompt.

Passaggio 5: modifica la specifica

Puoi modificare la specifica facendo clic su Visualizza codice e digitando gli aggiornamenti direttamente nella specifica. Per questo esempio, modifica la descrizione in "API di gestione dei contenuti dei post del blog sportivo".

Codice modificato da Gemini Code Assist di Cloud Code

Passaggio 6: testa l'API utilizzando un server simulato

Testa l'API utilizzando il server simulato locale, che emula le risposte per l'API. Nel menu a discesa Server, seleziona l'opzione con il nome Server di sviluppo locale. Una volta selezionato, apri il percorso POST e fai clic su Prova.

Modifica i valori "author", "content" e "title" nel corpo della richiesta per utilizzare i tuoi valori:

{
    "author": "My name",
    "categories": [
      "string"
    ],
    "content": "This is my blog post",
    "featuredImageUrl": "string",
    "publishedDate": "string",
    "tags": [
      "string"
    ],
    "title": "Baseball in the age of AI"
  }

Fai clic su Esegui per visualizzare una risposta simulata dell'API nella sezione Risposte.

Passaggio 7: salva l'API nell'hub API

(Facoltativo) Una volta che l'API è stata esaminata e finalizzata, rendila disponibile agli sviluppatori registrandola con l'hub API:

  1. Fai clic su Registrati all'hub API.
  2. Segui le istruzioni per registrare l'API. Consulta la sezione Registrare le API per informazioni sulla registrazione all'hub API e sulle informazioni da fornire.

Fai clic su Salva per salvare la nuova API assegnandole un nome a tua scelta.

Passaggio 8: crea un bundle di proxy API da questa specifica

Per creare un bundle di proxy API Apigee da questa specifica, fai clic su Crea bundle di proxy API nel menu Altro. Dopo la creazione, dovresti vedere il nuovo proxy in apiproxies nel menu a sinistra. Consulta Sviluppo di proxy API per informazioni su come utilizzare i proxy API in Cloud Code.
Cloud Code Gemini Code Assist crea bundle di proxy API

Passaggi successivi