Alibaba Cloud Model Studio：Plugin kustom

Langkah 1: Buat plugin

1. Buka halaman Plug-ins, lalu klik Create Plug-in.

   

2. Masukkan informasi plugin.

   	Plug-in Name: Masukkan nama deskriptif. Anda dapat menggunakan karakter Tionghoa dan Inggris. Contoh: Dormitory Agreement Query Tool Test
   	Plug-in Description: Masukkan deskripsi singkat tentang fitur dan skenario penggunaan plugin. Deskripsi ini membantu LLM menentukan apakah akan memanggil plugin untuk tugas saat ini. Gunakan bahasa alami dalam deskripsi tersebut. Contoh: Mengkueri konten entri perjanjian asrama tertentu berdasarkan indeks numerik yang dimasukkan.
   	Plug-in URL: Titik akhir (endpoint) plugin. Contoh:https://domitorgreement-plugin-example-icohrkdjxy.cn-beijing.fcapp.run Untuk nama domain yang sama, path berbeda dianggap sebagai API berbeda. Path-path ini sesuai dengan Tool Path yang Anda konfigurasikan saat membuat tool. Tool-tool berbeda dalam satu plugin menggunakan nama domain yang sama. Path tool masing-masing bersesuaian dengan API terpisah. Sebagai contoh, sebuah plugin berisi dua API: Query: https://xxx.com/query Delete: https://xxx.com/delete Dalam contoh ini, https://xxx.com adalah Plug-in URL. /query dan /delete bersesuaian dengan Tool Path. Hal ini menunjukkan bahwa plugin tersebut berisi dua tool.

   Jika autentikasi diperlukan, aktifkan sakelar Enable Authentication dan masukkan pengaturan autentikasi.

   Deskripsi parameter autentikasi

   Headers (Opsional)	Jika autentikasi diperlukan, Anda dapat meneruskan informasi autentikasi melalui header kustom.
   Enable Authentication (Opsional)	Menentukan apakah autentikasi diperlukan ketika aplikasi Model Studio memanggil plugin kustom Anda. Kebutuhan autentikasi bergantung pada kebijakan keamanan penyedia API.
   Authentication Type	Metode autentikasi terdiri dari Service-level Authentication dan User-level Authentication. Location: Anda dapat menempatkan informasi autentikasi di Header atau kueri. Header: Tempatkan informasi autentikasi di bidang Authorization pada Header permintaan HTTP. Informasi ini tidak terlihat di URL. Query: Tempatkan informasi autentikasi di URL. Contohnya: https://example.com?api_key=123456. Parameter Name: Jika Anda menempatkan informasi autentikasi di query, tentukan parameter yang digunakan untuk autentikasi, misalnya "api_key". Jika Anda menempatkannya di header, parameter default-nya adalah "Authorization". Type: basic: Tidak ada konten yang ditambahkan sebelum token yang Anda berikan. bearer: "Bearer" ditambahkan sebelum token. appcode: "APPCODE" ditambahkan sebelum token. Kedua jenis tersebut ditentukan dalam parameter autentikasi. Misalnya, jika Anda memilih `bearer`, format pemanggilan plugin-nya adalah `("Authorization": "Bearer <YOUR_TOKEN>")`. Token (Service-level Authentication): Token otentikasi yang diperoleh dari penyedia API, seperti Kunci API.

3. Setelah memasukkan informasi, klik Confirm Create Plug-in > Create Tool atau klik Continue to Add Tool.

Langkah 2: Buat tool

1. Masukkan informasi tool, konfigurasikan parameter input dan output, serta atur konfigurasi lanjutan.

   

   Deskripsi parameter tool

   Informasi tool

   Tool Name	Masukkan nama deskriptif. Mendukung karakter Tionghoa dan Inggris.
   Tool Description	Deskripsi singkat tentang fitur dan skenario penggunaan tool. Hal ini membantu model besar menentukan apakah akan memanggil tool untuk tugas saat ini. Gunakan bahasa alami dalam deskripsi dan berikan contoh jika memungkinkan.
   Tool Path	Path relatif terhadap Plug-in URL. Path harus diawali dengan garis miring (/). Path ini ditambahkan ke Plug-in URL untuk membentuk URL lengkap.
   Request Method	Pilih metode permintaan GET atau POST sesuai kebutuhan untuk memanggil Operasi API.
   Submission Method	Tipe encoding untuk permintaan atau respons. application/json: Konten body berupa data dalam format JSON. application/x-www-form-urlencoded: Mengenkoding data formulir menjadi pasangan kunci-nilai. Metode enkoding ini digunakan untuk permintaan POST. Data formulir dienkoding menjadi pasangan kunci-nilai dan dikirim melalui enkoding URL. Beberapa pasangan kunci-nilai dipisahkan oleh tanda ampersand (&). Setiap kunci dan nilai dipisahkan oleh tanda sama dengan (=). Enkoding URL mengubah karakter khusus menjadi tanda persen (%) diikuti dua digit heksadesimal. Misalnya, spasi dienkoding sebagai %20, & sebagai %26, dan = sebagai %3D. Contoh: name=John Doe&age=25 dienkoding menjadi name=John%20Doe&age=25.

   Konfigurasikan parameter input dan output

   Configure Input Parameters	Klik Add Input Parameter dan konfigurasikan parameter-parameter tersebut.
   	Parameter Name: Gunakan nama yang sedeskriptif mungkin untuk membantu LLM memahami informasi parameter apa yang perlu diidentifikasi. Misalnya, gunakan kata bermakna seperti city.
   	Parameter Description: Deskripsi singkat dan akurat tentang fungsi parameter input. Hal ini membantu LLM lebih memahami cara mengambil parameter tersebut. Sebagai contoh, untuk parameter date, Anda dapat menjelaskan format tanggalnya, seperti yyyy-MM-dd.
   	Type: Tipe parameter. Penting Sub-properti di bawah tipe Object tidak boleh kosong. Klik ikon di akhir baris objek untuk menambahkan sub-properti.
   	Passing Method: Atur parameter ini secara akurat. LLM Recognition: Nilai parameter perlu diekstraksi dari input pengguna oleh LLM. Business Pass-through: Nilai parameter diteruskan secara aktif dari sumber eksternal. Data tidak diproses atau dimodifikasi selama transmisi. Saat Anda memanggil aplikasi menggunakan SDK DashScope atau antarmuka HTTP, parameter input bertipe business pass-through dalam plugin diteruskan ke aplikasi melalui biz_params dan user_defined_params. Untuk informasi selengkapnya, lihat Pass plug-in parameters through an API.
   Configure Output Parameters	Klik Add Output Parameter dan konfigurasikan parameter-parameter tersebut. Semua parameter bersifat wajib. LLM menyaring dan mengatur ulang hasil yang dikembalikan oleh API berdasarkan definisi parameter output dan pertanyaan pengguna. Jawaban akhir kemudian dikembalikan kepada pengguna. Seperti halnya parameter input, parameter output harus dideskripsikan secara ringkas dan akurat, dengan tingkat nested sesedikit mungkin. Penting Baik metode permintaan GET maupun POST mendukung tipe Object untuk parameter. Namun, sub-properti di bawah tipe Object tidak boleh kosong. Klik ikon di akhir baris objek untuk menambahkan sub-properti.

   Konfigurasi Lanjutan (Opsional)

   Advanced Configuration	Tambahkan contoh pemanggilan untuk LLM guna mengurangi missed recall dan incorrect recall. Fitur ini biasanya digunakan dalam skenario di mana parameter input kompleks dan model rentan melakukan kesalahan konstruksi. Memberikan contoh meningkatkan akurasi LLM dalam memanggil plugin.
   	Value: Parameter input pemanggilan yang diharapkan dibangun oleh LLM ketika pengguna memasukkan kueri saat ini. Sebagai contoh, jika pengguna memasukkan "Kueri cuaca di Hangzhou untuk besok", parameter input yang diharapkan adalah {"city": "Hangzhou", "date": "2025-04-25"}.

2. Setelah konfigurasi selesai, klik Save Draft.

3. Debug API tool secara online untuk memeriksa apakah tool tersebut dapat dipanggil.

   Klik Test Tool. Jika autentikasi diaktifkan, masukkan informasi autentikasi dan nilai parameter input, lalu klik Start Running. Jika eksekusi gagal, sesuaikan konfigurasi berdasarkan pesan error di bagian Run Result dan uji kembali hingga eksekusi berhasil. Anda dapat memasukkan nilai parameter input secara manual atau menggunakan kode. Untuk parameter input yang kompleks, gunakan mode Code Editing. Di editor kode, Anda dapat mengirimkan parameter input lengkap beserta nilainya dalam format JSON.

4. Setelah pengujian berhasil, klik Publish. Hanya tool yang berstatus Published yang dapat dipanggil dalam aplikasi.

Peroleh ID tool

ID tool mengidentifikasi tool tertentu. Saat Anda memanggil tool menggunakan API, Anda harus meneruskan ID tool yang benar agar permintaan dapat diidentifikasi dengan tepat.

1. Di daftar Plug-ins, temukan plugin tempat tool tersebut berada dan klik View.

2. Arahkan pointer mouse ke ikon di sebelah nama tool.

3. Klik ikon untuk menyalin ID tool tersebut.