Cara Membuat Plugin ChatGPT – Studi Kasus menggunakan PodcastAPI.com dan Halaman Cloudflare Tanpa Server

969 BLOG Cara Membuat Plugin ChatGPT – Studi Kasus menggunakan PodcastAPI.com dan Halaman Cloudflare Tanpa Server

ChatGPT adalah alat pelengkapan otomatis yang sangat cerdas. Dibutuhkan instruksi atau pertanyaan dalam bahasa alami dan memberikan hasil berbasis teks yang cukup baik.

Tapi ada yang menarik – pengetahuan ChatGPT hanya naik hingga September 2021. Jadi, saat menulis posting blog ini (Juni 2023), model itu sendiri tidak mengetahui peristiwa atau data apa pun setelah September 2021.

Di sinilah Plugin ChatGPT datang untuk menyelamatkan. Plugin ini memungkinkan ChatGPT berinteraksi dengan API eksternal untuk mendapatkan akses ke informasi terkini. Mereka juga dapat membantu ChatGPT melakukan tindakan tertentu seperti memicu tugas Zapier atau mengirim email.

Dari perspektif penyedia API (seperti Dengarkan Catatan menyediakan PodcastAPI.com), membuat plugin ChatGPT serupa dengan menyediakan antarmuka ramah pengguna yang didukung AI untuk API Anda. Untuk pengguna ChatGPT yang antusias, membuat plugin khusus dapat memperluas kasus penggunaannya secara signifikan.

Dalam tutorial ini, kita akan memanfaatkan contoh dunia nyata dari Dengarkan Catatan Plugin ChatGPT (sudah tersedia di toko Plugin) sebagai studi kasus untuk menjelaskan proses pembuatan plugin ChatGPT.

Prosesnya lebih sederhana dari yang Anda duga. Di akhir artikel ini, Anda akan memiliki pemahaman yang diperlukan untuk menggunakan API apa pun dan membuat plugin ChatGPT Anda sendiri.

Jangan ragu untuk mencoba Dengarkan Catatan Plugin ChatGPT dan jelajahi kode sumbernya di GitHub.

Bagaimana Cara Kerja Plugin ChatGPT?

Untuk pengguna akhir, proses menggunakan plugin ChatGPT cukup mudah. Anda hanya perlu mengaktifkan plugin di antarmuka pengguna ChatGPT, lalu ketik petunjuknya.

Contoh plugin ChatGPT sedang bekerja

Untuk pengembang, prosesnya membutuhkan lebih banyak pekerjaan. Anda harus menyediakan host ai-plugin.json file menggunakan nama domain Anda sendiri. File ini menyertakan metadata tentang plugin dan spesifikasi OpenAPI yang merinci titik akhir API yang tersedia yang dapat berinteraksi dengan ChatGPT.

Pada dasarnya, plugin ChatGPT adalah pemanggil API yang cerdas. Pengguna menggunakan bahasa alami untuk memanggil API eksternal ini alih-alih menulis kode. Semua titik akhir API, serta ai-plugin.json Dan openapi.jsonharus dihosting dengan nama domain yang sama.

Studi kasus: Cara Membuat Plugin Podcast Discovery ChatGPT menggunakan Halaman PodcastAPI.com dan Cloudflare

Persyaratan

Plugin kami harus dapat mencari podcast atau episode berdasarkan kata kunci, bahasa, negara, dan durasi audio, di antara faktor lainnya.

Kami akan menggunakan Halaman PodcastAPI.com dan Cloudflare untuk membuat plugin ChatGPT ini.

PodcastAPI.com adalah API Podcast yang digunakan secara luas secara global, dan mendukung ribuan aplikasi/situs web podcast. Ini adalah RESTful API yang khas.

Misalnya, untuk menemukan podcast yang terkait dengan “startup” dalam bahasa Inggris, Anda mengirimkan permintaan API seperti DAPATKAN /search?q=startup&type=podcast&language=English. Anda dapat dengan mudah mencoba semua titik akhir Podcast API dengan server tiruan dan melihat seperti apa respons data JSON di halaman dokumen API.

Halaman Cloudflare adalah platform tanpa server dengan kuota gratis yang murah hati. Ini memungkinkan Anda membuat aplikasi web dinamis dalam JavaScript dan mengirimkan permintaan ke API eksternal dengan aman tanpa memaparkan kredensial API. Dan karena tanpa server, Anda tidak perlu khawatir tentang penyediaan server, skalabilitas, atau masalah operasional.

Kami telah memperoleh beberapa pengalaman menggunakan Halaman Cloudflare dari membangun microfeed— alternatif WordPress tanpa server yang ringan, yang dapat Anda gunakan untuk menghosting podcast dan file media secara gratis.

Bagaimana tepatnya plugin bekerja?

Anda dapat menemukan kode sumber untuk plugin Listen Notes ChatGPT di GitHub: github.com/ListenNotes/listennotes-chatgpt-plugin.

Plugin, dibuat dengan JavaScript, diterapkan sebagai aplikasi web di platform tanpa server Cloudflare Pages. Penyebaran ini melayani tiga sumber penting di bawah nama domain khusus ai.listennotes.com:

1. Itu ai-plugin.json file: Ini selalu dapat ditemukan di https://ai.listennotes.com/.well-known/ai-plugin.json . Jalur untuk file ini statis dan tidak boleh diubah. Di Siniadalah kode sumber untuk referensi Anda.
2. Itu openapi.json file: Lokasi ini ditentukan oleh file ai-plugin.json. Dalam kasus kami, ini dihosting di https://ai.listennotes.com/chatgpt-plugin/openapi.json. Anda dapat memeriksa kode sumber Di Sini.
3. Titik akhir API proxy: Misalnya, https://ai.listennotes.com/api/v2/search_episodes. Ini pada dasarnya adalah pembungkus tipis dari titik akhir PodcastAPI.com yang sebenarnya. Kode sumber untuk titik akhir ini dapat ditemukan Di Sini .

Jadi, bagaimana potongan-potongan ini bekerja sama? Mari selami lebih dalam:

Pertama, ChatGPT mengidentifikasi ai-plugin.json file dari jalur tetapnya /.well-known/ai-plugin.json. File ini berisi metadata penting tentang plugin dan memberi tahu ChatGPT tentang lokasi openapi.json mengajukan. Inilah tampilannya:

Kedua, ChatGPT menggunakan openapi.json file untuk memahami titik akhir API yang tersedia dan parameternya. File ini pada dasarnya membantu ChatGPT memahami cara berinteraksi dengan API.

Akhirnya, menggunakan deskripsi dan metadata lain yang ditentukan dalam openapi.json file, ChatGPT dapat menerjemahkan permintaan bahasa alami ke dalam permintaan API tertentu.

Misalnya, prompt pengguna seperti “cari podcast startup dalam bahasa Inggris” diterjemahkan oleh ChatGPT menjadi permintaan GET untuk DAPATKAN /search_podcasts?q=startup&language=Bahasa Inggris.

Mengamankan Kunci Kerajaan

Saat bekerja dengan API eksternal, seperti PodcastAPI.com dalam kasus kami, perhatian penting adalah menjaga kerahasiaan kunci API. Anda dapat melakukannya melalui lapisan tipuan — “Semua masalah dalam ilmu komputer dapat diselesaikan dengan tingkat tipuan lain.” 🙂

Pertama, kunci API asli (DENGARKAN_API_KEY dalam kasus kami) disediakan sebagai variabel lingkungan di Halaman Cloudflare. Ini memastikan bahwa kunci API tidak pernah diekspos dalam kode sumber.

Selanjutnya, kami menggunakan rahasia (CHATGPT_SECRET dalam kasus kami) untuk ChatGPT untuk memanggil titik akhir API proxy kami. Saat mengirimkan plugin ke ChatGPT, Anda akan diminta untuk memberikan rahasia ini.

Setelah memberikan rahasia, ChatGPT akan mengeluarkan token verifikasi (CHATGPT_VERIFICATION_TOKEN dalam kasus kami), yang ditempatkan di file ai-plugin.json. Tidak apa-apa jika token verifikasi ini bersifat publik.

Dalam kasus kami, DENGARKAN_API_KEY, CHATGPT_SECRETDan CHATGPT_VERIFICATION_TOKEN semuanya disimpan sebagai variabel lingkungan terenkripsi di Halaman Cloudflare, secara efektif dijauhkan dari mata publik:

Cara Menavigasi Proses Peninjauan

Sebelum plugin Anda terdaftar di toko Plugin ChatGPT, Anda dapat mengujinya melalui domain khusus Anda (dalam kasus kami, ai.listennotes.com).

Saat Anda siap mengirimkan plugin untuk ditinjau, Anda akan melakukannya melalui tiket Interkom. Anda harus menjawab beberapa pertanyaan dan memberikan beberapa contoh petunjuknya. Dari pengalaman kami, butuh waktu sekitar 2 hari bagi anggota tim ChatGPT untuk meninjau tiket kami.

Awalnya, pengajuan kami ditolak karena uraian kami tidak diakhiri dengan tanda baca. Kami segera menambahkan titik pada deskripsi ai-plugin.json kami, mengirimkannya kembali, dan disetujui dalam waktu 2 jam. Jadi, dari pengajuan hingga persetujuan, kira-kira prosesnya 2 hari.

Cara Menyesuaikan Proses untuk API Lain

Jika Anda ingin beradaptasi repositori plugin listennotes-chatgpt-pluginuntuk bekerja dengan API lain, ada tiga area utama yang perlu Anda ubah:

1. Memperbarui ai-plugin.json (Kode sumber): Anda akan menemukan rincian lebih lanjut tentang ini di openai.com.
2. Memperbarui openapi.json (Kode sumber): Ini sangat penting karena ChatGPT mengandalkan spesifikasi OpenAPI ini untuk mengidentifikasi titik akhir proxy yang tersedia. Untuk wawasan lebih lanjut, lihat openai.com.
3. Perbarui titik akhir API proxy (Kode sumber) agar selaras dengan API lain: Titik akhir proxy yang berjalan di Halaman Cloudflare perlu diperbarui untuk mengirim permintaan API ke API pilihan Anda. Anda mungkin ingin membiasakan diri dengan bagaimana fungsi Halaman Cloudflare bekerja .

Setelah melakukan pembaruan ini, Anda bisa disebarkan ke Halaman Cloudflarekemudian kirimkan plugin Anda ke ChatGPT untuk ditinjau.

Membungkus

Meskipun ikhtisar ini bertujuan untuk memberikan informasi yang bermanfaat, perlu diingat bahwa plugin ChatGPT masih dalam versi beta dan dapat berubah.

Kami berharap untuk terus memperbarui pos ini saat ada perubahan. Dunia AI serba cepat, tetapi dengan pemahaman yang kuat tentang prinsip-prinsip ini, Anda akan diperlengkapi dengan baik untuk menavigasinya.

Anda dapat menemukan artikel ini dan banyak lainnya di listennotes.com.