OpenAI
Halaman ini diterjemahkan oleh mesin. Lihat artikel asli dalam bahasa Inggris.

Mengonfigurasi aksi di GPT

Cara menghubungkan GPT Anda ke API eksternal menggunakan aksi, termasuk penyiapan, autentikasi, dan konfigurasi skema.

Diperbarui: 18 days ago

Ringkasan

Artikel ini menjelaskan cara mengonfigurasi aksi di GPT, termasuk cara terhubung ke API eksternal, menentukan apa yang bisa dilakukan GPT, serta mengelola autentikasi, skema, dan pembatasan workspace.

Untuk mengonfigurasi sebuah aksi, Anda memerlukan detail API untuk layanan yang ingin Anda hubungkan, termasuk informasi autentikasi dan skema OpenAPI. GPT dapat menggunakan app atau aksi, tetapi tidak keduanya pada saat yang sama.

Setiap aksi didefinisikan oleh dua komponen utama: bagaimana GPT melakukan autentikasi dengan API, dan skema yang menentukan apa yang bisa dilakukan API.

Batasan

Jika workspace Anda mengizinkan nol domain action, aksi kustom GPT tidak dapat dijalankan karena tidak ada domain action yang dapat lolos pemeriksaan allowlist. Ini tidak selalu berarti seluruh visibilitas atau akses GPT diblokir.

Aksi tidak tersedia untuk mode Pro; membuat GPT dengan aksi kustom akan membuat hanya model Instant dan Thinking yang tersedia untuk dipilih di dalamnya.

Membuat aksi

Di editor GPT, buka bagian Actions dan pilih Create new action.

Setelah itu, Anda akan mengonfigurasi cara GPT Anda terhubung ke dan menggunakan API eksternal.

Setelah mengonfigurasi sebuah aksi, uji di Preview untuk memastikan perilakunya sesuai harapan.

Autentikasi

Autentikasi mengatur cara GPT Anda terhubung ke API eksternal.

Opsi yang tersedia:

  • None: Tidak memerlukan autentikasi

  • API key: Menggunakan kunci rahasia untuk mengotorisasi permintaan

  • Oauth: Menggunakan login pengguna untuk akses berbasis akun

API key

Gunakan autentikasi API key untuk akses server-ke-server. Ini dapat dikonfigurasi sebagai:

  • Basic

  • Bearer

  • Custom header

Oauth

Gunakan Oauth saat aksi memerlukan akun pengguna. Oauth memerlukan:

  • Client ID dan Client Secret

  • Authorization URL dan Token URL

  • Scope dan metode pertukaran token

Editor menyediakan URL callback untuk menyelesaikan alur Oauth.

Skema

Skema menentukan apa yang bisa dilakukan API Anda. Skema memberi tahu ChatGPT:

  • Server mana yang harus dipanggil

  • endpoint apa saja yang tersedia

  • Parameter apa yang diterima

  • Bagaimana setiap aksi diidentifikasi (operation ID)

Skema harus disediakan sebagai spesifikasi OpenAPI dalam JSON atau YAML.

Menambahkan skema

Anda dapat menambahkan skema dengan tiga cara:

  • Menempelkannya langsung ke editor

  • Mengimpornya dari URL

  • Mulai dari contoh bawaan:

    • Weather (JSON)

    • Pet Store (YAML)

    • Blank template

Jika skema valid, editor menampilkan aksi yang terdeteksi. Jika tidak valid, error validasi akan ditampilkan.

Pembatasan workspace (Enterprise dan Edu)

Jika Anda melihat pesan:

“Tidak ada domain yang diizinkan oleh pengaturan workspace Anda.”

Ini berarti aksi dibatasi oleh pengaturan workspace Anda.

  • Admin dapat mengizinkan semua domain atau membatasi aksi ke domain yang disetujui.

  • Jika tidak ada domain yang diizinkan, Anda tidak dapat menggunakan aksi.

Untuk kontrol tingkat-workspace atas aksi dan pembatasan domain, lihat: Mengelola akses GPT di workspace Enterprise dan Edu.

Privasi dan kontrol pengguna

  • Setiap aksi dapat menyertakan URL kebijakan privasi.

  • GPT publik (tautan atau GPT Store) dengan aksi harus menyertakan URL kebijakan privasi yang valid.

  • Pengguna mungkin diminta untuk menyetujui aksi sebelum dijalankan.

  • Untuk aksi Oauth, pengguna dapat meninjau dan mengelola akun yang terhubung.

Bantuan tambahan

Untuk bantuan menulis atau men-debug aksi, gunakan ActionsGPT resmi.

Apakah artikel ini membantu?