Tutorial: Menggunakan Gemini Code Assist untuk mendesain, mengembangkan, dan menguji API di Apigee dan Cloud Code

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Ringkasan

Tutorial ini memandu Anda melalui proses penggunaan Gemini Code Assist di Cloud Code untuk mendesain API dan membuat proxy Apigee API dari spesifikasi API yang dihasilkan. Dalam tutorial ini, Anda akan menggunakan perintah bahasa alami untuk mendesain dan membuat API yang mengelola postingan blog terkait olahraga untuk situs.

Sebelum memulai

Untuk menyelesaikan tutorial ini, Anda memerlukan:

  • Gemini for Google Cloud API yang disiapkan untuk project Apigee Anda, atau menjadi Admin Org Apigee agar Anda dapat menambahkannya. Untuk langkah-langkah penyiapan Gemini Code Assist, lihat Menggunakan Gemini Code Assist.
  • Menjadi Admin Apigee API di project Apigee Anda.
  • Untuk menyiapkan pengembangan lokal untuk project Apigee di Cloud Code, jika Anda belum melakukannya. Lihat Menyiapkan Pengelolaan API Apigee di Cloud Code untuk VS Code.
  • Memahami spesifikasi OpenAPI, sehingga Anda dapat meninjau spesifikasi yang dihasilkan.
  • (Opsional) API Hub yang disiapkan untuk project ini. Meskipun tidak sepenuhnya diperlukan untuk menggunakan fitur Gemini Code Assist yang dijelaskan di sini, Anda tidak akan dapat melakukan semua langkah tanpa API hub.

Langkah 1: Muat Apigee di Cloud Code

Buka VS Code dan klik ikon Cloud Code. Anda akan melihat project Apigee dan API apa pun.

Menu kiri Cloud Code Gemini Code Assist

Langkah 2: Buka tab Create an API spec dan masukkan perintah

Klik tongkat sihir di baris Apigee untuk membuka tab pembuatan spesifikasi.

Cloud Code Gemini Code Assist membuat tongkat sihir spesifikasi

Tab ini menampilkan template yang dapat Anda gunakan untuk memulai perintah API. Kolom input perintah bentuk bebas tersedia di bawahnya. Klik API untuk konten blog. Perintah natural language yang menjelaskan API ini akan diisi ke kolom input perintah.

Formulir pembuatan spesifikasi Cloud Code Gemini Code Assist

Langkah 3: Buat dan lihat spesifikasi

Klik Create untuk membuat spesifikasi API dari perintah ini. Tunggu selagi spesifikasi dibuat; panel Output akan menampilkan langkah-langkah saat spesifikasi dibuat.

Setelah dibuat, lihat deskripsi spesifikasi, endpoint, dan skema dengan men-scroll ke bawah. Untuk melihat kode spesifikasi OpenAPI, klik Lihat kode.

Endpoint spesifikasi Gemini Code Assist Cloud Code

Langkah 4: Ubah perintah dan buat ulang spesifikasi

Kembali ke perintah dan tambahkan jenis olahraga sebagai bagian dari objek data.

Perintah yang diedit oleh Gemini Code Assist Cloud Code

Klik Buat lagi untuk membuat ulang spesifikasi. Anda akan melihat jenis olahraga dalam spesifikasi yang diperbarui.

Perhatikan bahwa Anda juga dapat kembali ke perintah sebelumnya dengan mengklik histori perintah di bagian atas kotak input perintah.

Langkah 5: Edit spesifikasi

Anda dapat mengubah spesifikasi dengan mengklik Lihat Kode dan mengetik pembaruan langsung di spesifikasi. Untuk contoh ini, ubah deskripsi menjadi "Sports Blog Post Content Management API".

Kode yang diedit oleh Gemini Code Assist Cloud Code

Langkah 6: Uji API menggunakan server tiruan

Uji API menggunakan server tiruan lokal, yang mengemulasikan respons untuk API. Di dropdown Servers, pilih opsi dengan nama Local development server. Setelah dipilih, buka jalur POST dan klik Coba.

Ubah nilai "author", "content", dan "title" dalam isi permintaan untuk menggunakan nilai Anda sendiri:

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

Klik Execute untuk melihat respons tiruan dari API di bagian Responses.

Langkah 7: Simpan API Anda ke API hub

(Opsional) Setelah API Anda ditinjau dan selesai, sediakan API tersebut untuk developer dengan mendaftarkannya ke API Hub:

  1. Klik Register to API hub.
  2. Ikuti petunjuk untuk mendaftarkan API. Lihat Mendaftarkan API untuk informasi tentang cara mendaftar ke API hub dan informasi yang perlu Anda berikan.

Klik Simpan untuk menyimpan API baru dengan nama pilihan Anda.

Langkah 8: Buat paket proxy API dari spesifikasi ini

Untuk membuat paket proxy API Apigee dari spesifikasi ini, klik Create API proxy bundle dari menu More. Setelah pembuatan, Anda akan melihat proxy baru di bagian apiproxies di menu kiri. Lihat Mengembangkan proxy API untuk mengetahui informasi tentang cara menggunakan proxy API di Cloud Code.
Cloud Code Gemini Code Assist membuat paket proxy API

Langkah berikutnya