Tutorial: utilizza Gemini Code Assist per progettare, sviluppare e testare le API in Apigee

Questa pagina si applica ad Apigee e Apigee hybrid.

Panoramica

Questo tutorial ti guida nella procedura di utilizzo dello strumento @Apigee in Gemini Code Assist per creare e modificare una specifica API. Utilizzerai un prompt in linguaggio naturale per progettare e creare un'API per gestire gli appuntamenti presso uno studio dentistico. Una volta pronta, puoi anche testare la specifica e creare un proxy API Apigee.

Per saperne di più sulla creazione e la modifica delle specifiche API utilizzando Gemini Code Assist, vedi Progettare e modificare le API.

Prima di iniziare

Per completare questo tutorial, avrai bisogno di:

Passaggio 1: apri la chat di Gemini Code Assist

Apri VS Code e fai clic sull'icona della chat di Gemini Code Assist. Dovresti visualizzare la finestra della chat.

Chat di Gemini Code Assist in Cloud Code

Passaggio 2: inserisci l'handle Apigee per utilizzare lo strumento Apigee

Digita @Apigee nella finestra della chat. Viene visualizzato un elenco di prompt Apigee. Seleziona Crea una specifica API.

Finestra di chat di Gemini Code Assist di Cloud Code con lo strumento Apigee

Passaggio 3: inserisci il prompt

Nel campo di immissione, inserisci e invia questa descrizione per completare il prompt:

@Apigee Create an API specification for patients to schedule their own appointments with a dental office. Include multiple dentists and a dental appointment type, which can be regular checkup or other.

Finestra di chat di Gemini Code Assist di Cloud Code con prompt di creazione

Passaggio 4: visualizza la specifica

Attendi che Gemini Code Assist generi la specifica. Una volta disponibile, la finestra della chat mostra informazioni sulla specifica generata, incluso un riepilogo del contesto aziendale sfruttato dall'hub API e dagli endpoint API. Altre schede in Cloud Code mostrano il codice delle specifiche e l'interfaccia Swagger con gli endpoint, lo schema e altre informazioni sulle nuove specifiche API.

Chat di Gemini Code Assist di Cloud Code che mostra gli endpoint delle specifiche

Passaggio 5: modifica la specifica

Modifica la specifica per includere più sedi di studi dentistici. Innanzitutto, assicurati che il file YAML contenente la specifica si trovi nella scheda attualmente attiva dell'editor. Poi, nella finestra della chat, inserisci di nuovo l'handle Apigee e seleziona lo strumento Apigee: @Apigee. Inserisci questo prompt:

@Apigee Update the API specification for the dental scheduling API. Add multiple dental office locations.

Le modifiche alla specifica vengono visualizzate, con le differenze evidenziate, nella scheda di modifica. Puoi anche modificare la specifica digitando gli aggiornamenti direttamente nella scheda di modifica e salvando il file.

Codice modificato di Cloud Code Gemini Code Assist

Passaggio 6: pubblica l'API nell'hub API

Una volta esaminata e finalizzata l'API, rendila disponibile agli sviluppatori registrandola con l'hub API:

  1. Fai clic su Pubblica nell'hub API.
  2. Segui le istruzioni per pubblicare/registrare l'API. Consulta la sezione Registrare un'API per informazioni sulla registrazione all'hub API e sulle informazioni che devi fornire.

Passaggio 7: testa l'API utilizzando un server di simulazione locale

Testa l'API utilizzando il server di simulazione locale, che emula le risposte per l'API. Il server di simulazione locale non richiede la pubblicazione su API Hub.

Il server di simulazione locale dovrebbe essere già selezionato nel menu a discesa Server.
Server di simulazione locale di Cloud Code Gemini Code Assist nel menu a discesa

Una volta selezionato il server di simulazione locale, apri il percorso POST e fai clic su Prova.

Fornisci i valori "city", "country" e "postalCode" nel corpo della richiesta per l'entità addresses:

{
    "city": "string",
    "country": "string",
    "postalCode": "string",
    "state": "string",
    "streetAddress": "string"
  }

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

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

(Facoltativo) Per creare un bundle di proxy API Apigee da questa specifica, fai clic sul pulsante Crea bundle di proxy API e inserisci un nome per il proxy. Dopo la creazione, dovresti visualizzare il nuovo proxy in apiproxies nel tuo workspace Apigee. Consulta Sviluppo di proxy API per informazioni sull'utilizzo dei proxy API in Cloud Code.

Passaggi successivi