Lihat konektor yang didukung untuk Integration Aplikasi.

Membuat integrasi dengan Gemini Code Assist

Gemini Code Assist adalah kolaborator yang didukung AI di Google Cloud yang memberikan bantuan kepada pengguna dari semua tingkat keterampilan kapan pun mereka memerlukannya. Di Application Integration, Gemini Code Assist dapat membantu Anda melakukan hal berikut:

• Membuat integrasi
• Mengonfigurasi tugas konektor dalam integrasi
• Mengonfigurasi tugas Call REST API dalam integrasi
• Menambahkan kondisi edge dan menambahkan tugas tambahan ke integrasi
• Mengonfigurasi tugas JavaScript
• Membuat deskripsi integrasi

Untuk mengetahui informasi mendetail tentang Gemini untuk Google Cloud, lihat ringkasan Gemini untuk Google Cloud.

Sebelum memulai

1. Di konsol Google Cloud, buka halaman Integrasi Aplikasi.
   

   Buka Application Integration

   Gambar berikut menampilkan halaman Integrasi Aplikasi:

   

   1. Di bagian Dapatkan AI untuk membuat integrasi Anda, klik Jelajahi.
   2. Di panel Gemini in Application Integration yang muncul, klik Enable Service untuk mengaktifkan Gemini for Google Cloud API.

      Untuk informasi tentang cara mengaktifkan Gemini Code Assist di project Google Cloud, lihat Menyiapkan Gemini Code Assist untuk project.

2. Siapkan Integrasi Aplikasi di project Google Cloud Anda. Untuk informasi selengkapnya, lihat Menyiapkan Integrasi Aplikasi.
3. Jika Anda berencana membuat integrasi menggunakan konektor, pastikan untuk mengonfigurasi koneksi yang diinginkan di project Google Cloud Anda.
4. Jika Anda berencana membuat integrasi menggunakan API Apigee API Hub yang ada di project host, pastikan Anda telah menyediakan API Hub di project dan akun layanan Integrasi Aplikasi memiliki peran yang diperlukan untuk mengakses API di project lain.

Catatan: Gemini memberikan rekomendasi atau saran berbasis konektor dan API Hub untuk integrasi Anda menggunakan koneksi yang dikonfigurasi di Konektor Integrasi dan API di Apigee API Hub. Jika Anda tidak memiliki koneksi atau API yang dikonfigurasi di project, Gemini mungkin tidak memberikan rekomendasi atau saran berbasis konektor dan API.

Peran yang diperlukan

• Untuk mendapatkan izin yang diperlukan guna menggunakan Gemini, minta administrator untuk memberi Anda peran IAM Gemini for Google Cloud User (roles/cloudaicompanion.user) di project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

  Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

• Jika Anda berencana membuat integrasi dengan Apigee API Hub, pastikan Anda memiliki peran Viewer hub Cloud API (roles/apigeeregistry.viewer) di project yang berisi API.
• Jika Anda berencana membuat integrasi dengan Integration Connectors, pastikan Anda memiliki peran Connectors Viewer (roles/connectors.viewer) di project.

Tugas dan pemicu yang didukung

Gemini dapat membantu Anda menambahkan tugas dan pemicu berikut:

Triggers	Tasks
Pemicu API Pemicu Cloud Pub/Sub Pemicu Salesforce Jira Cloud ServiceNow Zendesk Pemicu Cloud Scheduler	Tugas pemetaan data Tugas persetujuan Menangguhkan tugas Tugas JavaScript Cloud Run Functions Tugas timer Tugas return Tugas kirim email Tugas konektor Tugas Call REST endpoint Doc AI - Tugas proses Gemini juga membantu Anda membuat tugas alur kontrol berikut, tetapi tidak dapat membuat sub-integrasi: Tugas For Each Loop Tugas For Each Parallel Tugas While Loop Tugas Integrasi Panggilan

Membuat integrasi

Gemini membantu Anda membuat dan mem-build integrasi menggunakan pernyataan natural language (atau perintah) sebagai input. Hal ini memungkinkan Anda membuat dan mem-build integrasi yang sederhana hingga kompleks dengan cepat dan dengan konfigurasi manual minimal.

Berikan perintah atau deskripsi singkat tentang alur integrasi yang ingin Anda buat kepada Gemini, dan Gemini akan menyarankan satu atau beberapa alur integrasi untuk membantu Anda memulai.

Untuk mem-build integrasi menggunakan Gemini, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Integrasi Aplikasi.

   Buka Application Integration

2. Klik spark Bantu saya membuat. Panel Buat Integrasi dengan Gemini akan muncul.

   Atau, di halaman Create Integration, buat integrasi baru, lalu di integration editor, klik pen_spark Create integration flows with Gemini untuk menggunakan Gemini.



1. Jika Anda ingin memilih template perintah, pilih salah satu dari Contoh template perintah. Atau, masukkan perintah untuk Gemini agar dapat membuat integrasi. Untuk mempelajari cara menulis perintah yang lebih baik, lihat Menulis perintah yang lebih baik.

   Misalnya, Anda menambahkan perintah berikut: Buat integrasi yang mengambil masalah jira, lalu buat tiket zendesk.

2. Klik Generate.
   Catatan: Gemini menyarankan satu atau beberapa alur integrasi yang memenuhi syarat perintah Anda:

   • Jika Anda telah mengaktifkan API Hub dan Integration Connectors serta memenuhi semua prasyarat, rekomendasi akan berisi tugas Call REST Endpoint dan Connectors.
   • Jika Anda memiliki persyaratan pemetaan data dalam integrasi, Gemini juga dapat menyarankan tugas pemetaan data. Saat Anda mengonfirmasi perintah, tugas pemetaan data akan diganti dengan tugas JavaScript.

   Diagram berikut menunjukkan panel Buat integrasi dengan Gemini dengan saran yang diberikan oleh Gemini:

   

   Gunakan tombol Previous dan Next untuk melihat saran yang diberikan.

3. Jika ingin mengubah nama integrasi yang disarankan, Anda dapat memperbarui kolom Nama integrasi.
   Catatan: Nama integrasi harus unik di project Google Cloud.
4. Pilih region untuk integrasi. Jika project Anda memiliki satu region yang disediakan, kolom Region akan ditetapkan ke region tersebut.
   Catatan: Daftar Region menampilkan region yang disediakan di project Google Cloud Anda. Untuk menyediakan wilayah baru, klik Aktifkan Wilayah. Lihat Mengaktifkan region baru untuk informasi selengkapnya.
5. Jika Anda ingin mengedit perintah, klik Edit Perintah.
6. Untuk menyetujui saran alur integrasi, klik Konfirmasi. Application Integration menampilkan progres langkah-langkah untuk membuat integrasi. Integrasi yang dibuat menggunakan Gemini akan menggantikan elemen dan variabel integrasi yang ada.

   

Rekomendasi kontekstual

Anda dapat menggunakan Gemini untuk memberikan rekomendasi kontekstual untuk integrasi yang ada. Gemini dapat membantu Anda memberikan rekomendasi konfigurasi konektor yang sesuai secara kontekstual berdasarkan alur logis integrasi yang ada. Jika koneksi dalam integrasi Anda memiliki lebih dari 1.000 entitas, konektor tersebut tidak akan disertakan dalam rekomendasi oleh Gemini. Untuk mengetahui batasan lainnya, lihat Batasan.

Mengonfigurasi tugas konektor

Gemini dapat membantu Anda memberikan rekomendasi konfigurasi konektor yang sesuai secara kontekstual berdasarkan alur logis integrasi yang ada. Jika koneksi dalam integrasi Anda memiliki lebih dari 1.000 entitas, konektor tersebut tidak akan disertakan dalam rekomendasi oleh Gemini. Untuk mengetahui batasan lainnya, lihat Batasan.

Anda dapat mengonfigurasi konfigurasi konektor dengan penggantian yang direkomendasikan Gemini, atau Anda dapat berinteraksi dengan Gemini (menggunakan perintah) dan meminta saran konfigurasi yang diinginkan.

Untuk mengonfigurasi tugas konektor dalam integrasi Anda menggunakan Gemini, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Integrasi Aplikasi.

   Buka Application Integration

2. Di menu navigasi, klik Integrations.

   Halaman Integrasi akan muncul yang mencantumkan semua integrasi yang tersedia di project Google Cloud.

3. Pilih integrasi yang ada untuk membukanya di editor integrasi.
4. Di menu navigasi, klik tombol Tampilan kanvas baru (Pratinjau) ke posisi aktif. Kemudian, gunakan kanvas untuk membuat alur kerja integrasi Anda.
5. Untuk tugas konektor, klik Tindakan lainnya, lalu klik Konfigurasi tugas.

   Menu pop-up, yang mirip dengan gambar berikut, akan muncul dan menampilkan serangkaian rekomendasi Gemini.

   Catatan: Gemini dapat merekomendasikan tugas konektor untuk tugas endpoint Call REST dan sebaliknya.

   

6. Gemini otomatis merekomendasikan satu atau beberapa penggantian atau alternatif yang relevan dengan alur logis integrasi Anda. Anda dapat menggunakan input perintah untuk berinteraksi dengan Gemini dan menyesuaikan atau membuat ulang rekomendasi yang disarankan jika diinginkan.

7. Pilih salah satu penggantian atau modifikasi yang direkomendasikan untuk diterima. Gemini mengonfigurasi tugas konektor yang dipilih.

Mengonfigurasi tugas Call REST API

Jika Anda mengaktifkan API Hub di project, Gemini di Integrasi Aplikasi dapat membantu Anda memberikan tugas Panggil Endpoint REST dan rekomendasi konfigurasi tugas yang sesuai secara kontekstual berdasarkan alur logis integrasi yang ada. Anda dapat memanfaatkan rekomendasi ini untuk langsung mengganti tugas yang ada atau mengubahnya tanpa perlu melalui proses konfigurasi manual.

Anda dapat langsung mengganti tugas atau konfigurasi tugas yang ada dengan penggantian yang direkomendasikan Gemini, atau Anda dapat berinteraksi dengan Gemini (menggunakan perintah) dan meminta saran tugas yang diinginkan.

Setelah Anda memenuhi semua prasyarat, untuk mengganti atau mengubah tugas yang ada dalam integrasi menggunakan Gemini, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Integrasi Aplikasi.

   Buka Application Integration

2. Di menu navigasi, klik Integrations.

   Halaman Integrasi akan muncul yang mencantumkan semua integrasi yang tersedia di project Google Cloud.

3. Pilih integrasi yang ada untuk membukanya di editor integrasi.
4. Di menu navigasi, klik tombol Tampilan kanvas baru (Pratinjau) ke posisi aktif. Kemudian, gunakan kanvas untuk membuat alur kerja integrasi Anda.
5. Di kanvas editor integrasi, pilih tugas yang ingin Anda ganti atau ubah.
6. Klik More actions, lalu klik Configure task.

   Menu pop-up, yang mirip dengan gambar berikut, akan muncul dan menampilkan serangkaian rekomendasi Gemini.

   Catatan: Gemini dapat merekomendasikan tugas konektor untuk tugas endpoint Call REST dan sebaliknya.

   

7. Gemini otomatis merekomendasikan satu atau beberapa penggantian atau alternatif yang relevan dengan alur logis integrasi Anda. Anda dapat menggunakan input perintah untuk berinteraksi dengan Gemini dan menyesuaikan atau membuat ulang rekomendasi yang disarankan jika diinginkan.

8. Cukup pilih salah satu penggantian atau modifikasi yang direkomendasikan untuk diterima.

   Gemini langsung mengganti tugas yang Anda pilih atau mengubahnya tanpa konfigurasi tambahan.

Menambahkan kondisi tepi dan menambahkan tugas tambahan

Anda dapat menggunakan Gemini untuk menambahkan tugas baru dan menambahkan kondisi tepi ke alur integrasi yang ada.

Untuk menambahkan kondisi edge atau menambahkan tugas baru ke integrasi Anda menggunakan Gemini, lakukan langkah-langkah berikut:

1. Di Google Cloud, buka halaman Application Integration.

   Buka Application Integration

2. Di menu navigasi, klik Integrations.

   Halaman Integrasi akan muncul yang mencantumkan semua integrasi yang tersedia di project Google Cloud.

3. Pilih integrasi yang ada untuk membukanya di editor integrasi.
4. Di menu navigasi, klik tombol Tampilan kanvas baru (Pratinjau) ke posisi aktif. Kemudian, gunakan kanvas untuk membuat alur kerja integrasi Anda.
5. Di editor integrasi, pilih edge yang ingin Anda tambahkan kondisi edge-nya atau tempat Anda ingin menambahkan tugas baru.
6. Klik More actions, lalu klik Create branch.

   Menu pop-up, yang mirip dengan gambar berikut, akan muncul dan meminta Anda untuk memberikan input.

   

7. Masukkan perintah yang menentukan kondisi tepi yang ingin ditambahkan atau tugas tambahan yang ingin ditambahkan.

   Berikut adalah contoh perintah yang dapat Anda gunakan:

         If order qty>100, send an email

   Untuk mempelajari cara menulis perintah yang lebih baik, lihat Menulis perintah yang lebih baik.

8. Klik pen_spark Buat.

Gemini secara otomatis menyisipkan kondisi edge yang memenuhi syarat dan mengonfigurasi tugas tambahan dari edge yang dipilih dalam integrasi yang ada.

9. Klik Konfirmasi untuk menyetujui penyisipan dan penambahan yang disarankan.

   Jika Anda tidak menyukai penyisipan atau penambahan yang disarankan, klik Batal .

Mengonfigurasi tugas JavaScript

Anda dapat menggunakan Gemini untuk mengonfigurasi tugas JavaScript dalam integrasi. Gemini dapat membantu Anda memberikan rekomendasi konfigurasi tugas JavaScript yang sesuai secara kontekstual berdasarkan alur logis integrasi yang ada. Anda dapat memanfaatkan rekomendasi ini untuk langsung mengganti tugas yang ada atau mengubahnya tanpa perlu melalui proses konfigurasi manual.

Menambahkan tugas JavaScript

Tugas JavaScript memungkinkan Anda menulis cuplikan kode JavaScript kustom untuk integrasi Anda. Untuk menambahkan cuplikan kode menggunakan Gemini, ikuti langkah-langkah berikut:

1. Di Google Cloud, buka halaman Application Integration.

   Buka Application Integration

2. Di menu navigasi, klik Integrations.

   Halaman Integrasi akan muncul yang mencantumkan semua integrasi yang tersedia di project Google Cloud.

3. Buat integrasi atau pilih integrasi yang ada untuk membukanya di editor integrasi.
4. Klik dan tempatkan elemen JavaScript di editor integrasi.
5. Klik elemen JavaScript di kanvas untuk melihat panel konfigurasi tugas JavaScript.
6. Klik spark Script with Gemini. Panel Skrip dengan Gemini akan terbuka. Kemudian, lakukan hal berikut:
   1. Jika Anda ingin memilih template perintah, pilih salah satu dari Contoh template perintah. Atau, masukkan perintah agar Gemini membuat kode JavaScript. Untuk mempelajari cara menulis perintah yang lebih baik, lihat Menulis perintah yang lebih baik.

      Misalnya, Anda ingin memproses pesanan pelanggan. Integrasi Anda berisi variabel customer dan item. Untuk membuat pesanan, Anda dapat memasukkan perintah yang mirip dengan perintah berikut:

      Create order using customer and items.
      

      

   2. Klik Generate.

      Gemini menyarankan satu atau beberapa cuplikan kode yang memenuhi syarat perintah Anda. Gunakan tombol Previous dan Next untuk melihat saran yang diberikan.

   3. Untuk menambahkan cuplikan kode yang disarankan ke tugas JavaScript, klik Konfirmasi. Cuplikan kode akan muncul di kolom JavaScript editor.

Mengedit tugas JavaScript

Tugas JavaScript memungkinkan Anda menulis cuplikan kode JavaScript kustom untuk integrasi Anda. Untuk menambahkan cuplikan kode menggunakan Gemini, ikuti langkah-langkah berikut:

1. Di Google Cloud, buka halaman Application Integration.

   Buka Application Integration

2. Di menu navigasi, klik Integrations.

   Halaman Integrasi akan muncul yang mencantumkan semua integrasi yang tersedia di project Google Cloud.

3. Pilih integrasi yang berisi tugas JavaScript.
4. Klik dan tempatkan elemen JavaScript di editor integrasi.
5. Klik elemen JavaScript di kanvas untuk melihat panel konfigurasi tugas JavaScript.
6. Klik Buka Editor Skrip. Halaman JavaScript Task Editor akan muncul.
7. Klik spark Gunakan Gemini untuk mengedit dan memahami skrip > Edit skrip. Panel Edit script with Gemini akan muncul. Kemudian, lakukan hal berikut:
   1. Jika Anda ingin memilih template perintah, pilih salah satu dari Contoh template perintah. Atau, masukkan perintah agar Gemini membuat kode JavaScript. Untuk mempelajari cara menulis perintah yang lebih baik, lihat Menulis perintah yang lebih baik.

      Misalkan Anda ingin mencatat pesanan ke dalam log jika biaya pesanan lebih besar dari 100. Kemudian, Anda dapat memasukkan perintah yang mirip dengan berikut ini:

            Log in the order when the cost is greater than 100.
            

      

   2. Klik Generate.

      Gemini menyarankan satu atau beberapa cuplikan kode yang memenuhi syarat perintah Anda. Gunakan tombol Previous dan Next untuk melihat saran yang diberikan.

   3. Untuk menambahkan pembaruan yang disarankan ke cuplikan kode ke tugas JavaScript, klik Konfirmasi. Cuplikan kode yang diperbarui akan muncul di kolom JavaScript editor.

Memahami tugas JavaScript

Gemini dapat membantu Anda memahami cuplikan kode dalam tugas JavaScript. Untuk melakukannya, ikuti langkah-langkah berikut:

1. Dalam integrasi, klik elemen JavaScript di kanvas untuk melihat panel konfigurasi tugas JavaScript.
2. Di panel konfigurasi tugas, klik Buka editor skrip. Panel Editor skrip akan muncul. Kemudian, lakukan hal berikut:
   1. Klik spark > info_spark Bantu saya memahami.

      Jika ingin memahami bagian kode, Anda dapat memilih bagian cuplikan yang ingin dipahami, lalu mengklik spark > info_spark Bantu saya memahami.

      Panel Gemini akan muncul:

      

   2. Di panel Gemini, masukkan perintah agar Gemini memahami cuplikan kode. Untuk mempelajari cara menulis perintah yang lebih baik, lihat Menulis perintah yang lebih baik.

Membuat deskripsi integrasi

Fitur deskripsi integrasi yang tersedia di Gemini di Integrasi Aplikasi memberikan ringkasan deskripsi integrasi yang telah Anda buat di editor integrasi. Ringkasan deskripsi integrasi dibuat dalam bahasa sederhana dan dapat membantu Anda memahami kasus penggunaan integrasi secara keseluruhan, orkestrasi yang mendasarinya, dan konteks bisnis yang mungkin sulit dinilai karena struktur atau kompleksitas integrasi.

Untuk membuat ringkasan deskripsi integrasi menggunakan Gemini, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Integrasi Aplikasi.

   Buka Application Integration

2. Di menu navigasi, klik Integrations.

   Halaman Integrasi akan muncul yang mencantumkan semua integrasi yang tersedia di project Google Cloud.

3. Pilih integrasi yang ada untuk membukanya di editor integrasi.
4. Di toolbar editor integrasi, klik (Ringkasan integrasi). Halaman detail integrasi akan muncul.
5. Di halaman detail integrasi, klik Bantu saya dengan deskripsi.

   Gemini mengurai integrasi di editor integrasi dan membuat deskripsi ringkasan mendetail yang mirip dengan gambar berikut.

   

6. Klik Selesai untuk menyetujui deskripsi integrasi yang dibuat.

   Verifikasi dan validasi integrasi (termasuk variabel) sebelum menjalankannya.

Kuota dan batas

Untuk mengetahui informasi tentang kuota dan batas, lihat Kuota dan batas.

Batasan

Gemini di Application Integration tunduk pada batasan berikut:

• Jika koneksi dalam integrasi Anda memiliki lebih dari 1.000 entitas, konektor tersebut tidak akan disertakan dalam rekomendasi oleh Gemini.
• Integrasi Aplikasi mendukung residensi data. Integrasi yang dibuat menggunakan Gemini mendukung retensi data. Kami tidak menyimpan data apa pun seperti perintah dan respons Gemini. Hanya data yang digunakan dan dalam pengiriman untuk pembuatan menggunakan Gemini yang tidak mendukung residensi data.

Memberikan masukan

Anda bisa mendapatkan dukungan atau memberikan masukan kontekstual saat menggunakan Gemini untuk membuat integrasi. Informasi ini membantu kami meningkatkan kualitas Gemini.

Langkah selanjutnya

• Pelajari cara menulis perintah yang lebih baik.
• Pelajari cara menguji dan memublikasikan integrasi.
• Pelajari cara Gemini untuk Google Cloud menggunakan data Anda.
• Pelajari ringkasan Gemini untuk Google Cloud.