Menggunakan OpenCode CLI

Halaman ini menjelaskan cara menggunakan antarmuka command line (CLI) OpenCode dengan instance Gemini Enterprise Agent Platform Workbench.

Dokumen ini ditujukan untuk analis data, data scientist, dan developer data yang menggunakan Workbench Platform Agen. Dokumen ini mengasumsikan bahwa Anda memiliki pengetahuan tentang cara menulis kode di lingkungan notebook.

Ringkasan

OpenCode adalah agen coding AI open source yang berjalan di terminal. Untuk mengetahui informasi selengkapnya, lihat opencode.ai.

Jika diaktifkan oleh administrator, OpenCode CLI akan tersedia di terminal dalam antarmuka JupyterLab instance Agent Platform Workbench Anda. Anda dapat menggunakannya untuk menangani notebook dan file di instance, serta untuk menjalankan perintah shell dan perintah Cloud de Confiance by S3NS , dengan memberikan petunjuk dalam bahasa alami.

Batasan

Pertimbangkan batasan berikut saat Anda menggunakan OpenCode CLI dengan Agent Platform Workbench:

  • OpenCode hanya tersedia dalam bentuk CLI. Antarmuka chat grafis dan alat lanjutan dalam editor tidak disertakan.

  • Saat Anda meminta OpenCode untuk mengubah notebook, OpenCode akan mengubah file notebook secara langsung di disk instance. Oleh karena itu, Anda tidak dapat mengurungkan pengeditan yang dilakukan oleh OpenCode menggunakan tombol Undo atau Control+Z (Command+Z di macOS) pada editor notebook. Namun, Anda dapat meminta OpenCode untuk mengurungkan perubahan menggunakan perintah bahasa alami, seperti Undo your last change.

  • Karena OpenCode menulis langsung ke disk, alat ini dapat mengubah file yang juga Anda buka di JupyterLab. Jika Anda memiliki perubahan yang belum disimpan di notebook, simpan perubahan tersebut sebelum meminta OpenCode untuk mengubah notebook yang sama.

  • OpenCode berjalan dengan kredensial yang aktif di instance Anda. Secara default, kredensial ini adalah kredensial akun layanan instance Agent Platform Workbench Anda, sehingga OpenCode dapat mengakses resource yang sama dengan yang dapat diakses instance. Jika Anda mengautentikasi identitas yang berbeda pada instance (misalnya, dengan menjalankan gcloud auth login atau gcloud auth application-default login), OpenCode akan menggunakan izin identitas tersebut.

Sebelum memulai

  1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Cloud de Confiance project.

  3. Enable the Compute Engine, Notebooks, and Agent Platform APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

Peran yang diperlukan

Untuk menggunakan OpenCode CLI di Agent Platform Workbench, Anda harus memberikan izin kepada pengguna instance Agent Platform Workbench dan akun layanan instance.

Memberikan izin kepada pengguna instance

Untuk mendapatkan izin yang diperlukan untuk menggunakan OpenCode CLI di instance Agent Platform Workbench, minta administrator untuk memberi Anda peran IAM Agent Platform User (roles/aiplatform.user) di project. Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

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

Memberikan izin ke akun layanan instance Anda

Untuk memastikan bahwa akun layanan instance Agent Platform Workbench Anda memiliki izin yang diperlukan untuk mengaktifkan OpenCode CLI agar dapat berjalan di instance Agent Platform Workbench, minta administrator untuk memberikan peran IAM Agent Platform User (roles/aiplatform.user) ke akun layanan instance Agent Platform Workbench Anda di project.

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran yang telah ditetapkan ini berisi izin aiplatform.endpoints.predict, yang diperlukan untuk memungkinkan OpenCode CLI berjalan di instance Agent Platform Workbench.

Administrator Anda mungkin juga dapat memberi akun layanan instance Agent Platform Workbench izin ini dengan peran khusus atau peran bawaan lainnya.

Mengaktifkan OpenCode CLI

OpenCode CLI hanya tersedia di instance Agent Platform Workbench yang menggunakan image Debian 12 (workbench-instances-2603). Agen ini tidak diinstal pada instance yang menggunakan image Debian 11 (workbench-instances).

OpenCode CLI diaktifkan secara default di instance yang didukung. Untuk menonaktifkannya, tetapkan kunci metadata instance enable-opencode ke false. Untuk mengetahui informasi selengkapnya, lihat Mengelola fitur melalui metadata.

Menggunakan OpenCode CLI

  1. Di konsol Cloud de Confiance , buka halaman Instances.

    Buka Instances

  2. Di samping nama instance Agent Platform Workbench, klik Open JupyterLab.

  3. Di JupyterLab, klik File > New launcher.

  4. Di tab Launcher, di bagian Other, klik tile OpenCode.

    Terminal akan terbuka dan memulai OpenCode CLI.

  5. Masukkan perintah, seperti "Buat notebook baru bernama 'test-notebook'".

  6. Saat OpenCode mengusulkan tindakan, seperti mengedit file atau menjalankan perintah shell, tinjau dan setujui atau tolak tindakan tersebut. Untuk mengetahui informasi selengkapnya, lihat Menyetujui tindakan alat.

Menyetujui tindakan alat

Secara default, OpenCode di Agent Platform Workbench akan meminta persetujuan Anda sebelum melakukan tindakan apa pun, seperti mengedit file, menjalankan perintah shell, atau mengambil URL. Tinjau setiap tindakan yang diusulkan sebelum Anda menyetujuinya.

Setelan default ini melindungi dari injeksi perintah. Notebook, skrip, atau halaman web yang dibaca OpenCode dapat berisi petunjuk tersembunyi yang mencoba membuat agen menjalankan perintah yang tidak Anda inginkan, seperti mengirim data Anda ke alamat eksternal. Karena OpenCode berjalan dengan kredensial instance Anda, persyaratan persetujuan memberi Anda kesempatan untuk melihat dan menghentikan tindakan tersebut sebelum dijalankan.

Menggunakan model pihak ketiga

Secara default, OpenCode di Agent Platform Workbench dikonfigurasi untuk hanya menggunakan model Gemini dan Claude yang disajikan melalui Gemini Enterprise Agent Platform di project Anda. Permintaan ini diautentikasi dengan kredensial instance Anda terhadap Gemini Enterprise Agent Platform project Anda sendiri, sehingga permintaan tersebut tetap berada dalam projectCloud de Confiance by S3NS Anda dan tetap tunduk pada kontrol keamanan yang berlaku untuk project tersebut.

OpenCode juga mendukung penyedia model yang permintaannya dikirim di luar project Anda. Ini termasuk Google AI Studio (Gemini Developer API), yang meskipun menawarkan model Gemini, merupakan layanan terpisah yang melakukan autentikasi dengan kunci API pribadi, bukan kredensial project Anda, serta penyedia non-Google seperti API langsung OpenAI dan Anthropic. Semua opsi ini dinonaktifkan secara default. Anda dapat mengaktifkannya dengan mengedit konfigurasi OpenCode Anda sendiri dan memberikan kunci API penyedia.

Mengontrol akses ke OpenCode CLI

Akses ke OpenCode diatur oleh dua kontrol independen: apakah peluncur OpenCode ditampilkan, dan apakah model yang mendasarinya dapat dipanggil. Keduanya terpisah—menyembunyikan peluncur tidak akan memblokir model, dan membatasi model tidak akan menghapus peluncur—jadi konfigurasikan keduanya agar sesuai dengan kebijakan organisasi Anda.

Mengontrol apakah peluncur OpenCode muncul

Untuk mengontrol apakah OpenCode ditawarkan pada instance, gunakan kunci metadata instance enable-opencode. OpenCode diaktifkan secara default: kotak OpenCode muncul di peluncur JupyterLab kecuali jika administrator menetapkan kunci ke false, yang akan menyembunyikannya.

Setelan ini hanya mengontrol apakah peluncur ditampilkan. Tindakan ini tidak, dengan sendirinya, memblokir akses ke model: pengguna yang dapat menjangkau lingkungan instance (misalnya, melalui terminal) masih dapat memulai OpenCode dan memanggil model apa pun yang diizinkan untuk digunakan oleh kredensial mereka. Untuk membatasi hal yang dapat dilakukan OpenCode, kontrol akses ke model seperti yang dijelaskan di bagian berikutnya.

Mengontrol akses ke model

OpenCode memanggil model melalui Gemini Enterprise Agent Platform menggunakan kredensial instance Anda—autentikasi Gemini Enterprise Agent Platform yang sama dengan yang digunakan Gemini CLI. Pengguna tidak perlu memasukkan kunci API untuk menggunakan model Gemini dan Claude default; permintaan hanya akan berhasil jika identitas instance diizinkan untuk memanggil model dan project memiliki akses ke model tersebut. Kontrol ini menentukan apakah OpenCode dapat menghasilkan respons, dan berlaku bagaimanapun OpenCode dimulai.

Untuk mengelola akses model, gunakan kontrol yang sama yang berlaku untuk klien Gemini Enterprise Agent Platform mana pun:

  • Untuk mengizinkan atau membatasi model tertentu di tingkat organisasi, folder, atau project, siapkan kebijakan organisasi. Lihat Mengontrol akses ke model Model Garden.

  • Untuk memblokir identitas agar tidak menggunakan endpoint model untuk inferensi, jangan berikan izin aiplatform.endpoints.predict.

  • Model dari penyedia di luar project Anda (misalnya, API langsung Anthropic) mengharuskan pengguna memberikan kunci API penyedia tersebut dalam konfigurasi OpenCode mereka sendiri, dan dinonaktifkan secara default. Untuk mengetahui informasi selengkapnya, lihat Menggunakan model pihak ketiga.

Langkah berikutnya