Ikhtisar templat prompt - Alibaba Cloud Model Studio - Alibaba Cloud Documentation Center

Templat prompt memungkinkan Anda memisahkan struktur tetap suatu prompt dari variabel dinamisnya, sehingga menciptakan templat yang dapat digunakan kembali untuk pengelolaan terpadu, optimalisasi, dan pembuatan prompt yang efisien.

Penting

Topik ini hanya berlaku untuk Edisi Internasional (Wilayah Singapura).

Alur Kerja

Buat templat: Buat dan simpan templat di Konsol Model Studio atau gunakan API untuk mendapatkan ID templat unik.
Ambil templat: Gunakan API dan ID templat untuk mengambil konten templat.
Hasilkan prompt: Isi variabel templat dengan data bisnis Anda untuk menghasilkan prompt akhir.
Gunakan templat: Kirim prompt yang dihasilkan ke model target untuk mendapatkan hasil.

Jenis templat

Templat prompt terbagi menjadi dua kategori: built-in prompt templates dan custom prompt templates.

Dimensi	Built-in	Custom
Sumber	Disediakan oleh Model Studio untuk mencakup berbagai skenario bisnis.	Pengguna membuatnya di Konsol atau menggunakan API.
Efektivitas	Telah dioptimalkan sebelumnya untuk memastikan kinerja yang stabil.	Efektivitas bergantung pada kualitas desain dan pengujian Anda.
Kemudahan penggunaan	Siap digunakan tanpa pengembangan tambahan. Anda dapat langsung memanggilnya dari Konsol atau menggunakan API.	Mungkin memerlukan beberapa iterasi penyempurnaan. Anda harus memahami prinsip desain prompt dan metode optimasi, seperti memberikan instruksi yang jelas, contoh few-shot, dan batasan format. Kemampuan pengembangan dan teknis dasar juga diperlukan.
Skenario umum	Skenario tujuan umum, seperti penulisan kreatif dan bantuan kantor. Pengguna dengan pengalaman terbatas dalam desain prompt.	Skenario bisnis yang kompleks atau spesifik, seperti penilaian risiko keuangan atau konsultasi medis. Skenario dengan persyaratan format output ketat, seperti JSON atau daftar.
Dapat diedit	Tidak.	Ya. Anda dapat memodifikasi templat sesuai kebutuhan.

Built-in prompt templates

1. Lihat templat

Di halaman Prompts, Anda dapat melihat dan menggunakan built-in prompt templates yang disediakan Model Studio untuk berbagai skenario.

Setiap templat prompt ditampilkan dalam bentuk kartu yang menampilkan pratinjau konten dan ID templatnya. Kartu tersebut menyertakan tombol View Details, Copy prompt, dan tindakan lainnya (...).

2. Lihat dan kelola templat

Lihat: Klik View Details pada kartu templat untuk melihat nama, konten, variabel, ID, dan informasi lainnya.

Kelola:

Klik Copy Prompt untuk menyalin konten templat.
Klik Create Application. Konten templat akan secara otomatis diisi di editor prompt untuk Agent Application. Anda dapat menggunakan kontennya apa adanya atau memodifikasinya sesuai skenario bisnis Anda.

Prompt yang diisi berisi variabel kustom ${number} dan ${content} untuk menghasilkan konten bergaya Xiaohongshu.
Klik Copy Template untuk membuat templat prompt kustom di halaman Prompts. Templat baru diberi nama "Built-in Prompt Template Name_Copy_Timestamp".

Kartu templat yang disalin menampilkan pratinjau konten templat dan ID templat (klik ikon di sebelah kanan untuk menyalinnya). Bagian bawah kartu menyediakan tombol Edit, Copy prompt, dan tindakan lainnya.

Custom prompt templates

1. Buat templat

Anda dapat membuat templat prompt kustom di Konsol atau menggunakan API.

Konsol

Modifikasi built-in prompt template

Pada kartu built-in prompt template, klik Copy Template untuk membuat salinan bernama "Built-in Prompt Template Name_Copy_Timestamp".
Buat templat berdasarkan kebutuhan bisnis Anda

Di halaman Prompts, klik Create Prompt. Setelah konfigurasi selesai, klik Save untuk membuat templat. Di halaman pengelolaan templat prompt, Anda dapat menemukan templat yang sudah ada menggunakan filter jenis (Semua, Text Generation, dan Image Generation) atau bilah pencarian. Klik + Create Prompt di pojok kanan atas untuk membuat templat prompt baru. Templat yang dibuat ditampilkan sebagai kartu yang menunjukkan judul templat, pratinjau konten, dan ID templat, dengan opsi Edit dan Copy prompt.

API

Dapatkan ID ruang kerja Anda: Untuk informasi lebih lanjut, lihat Get an app ID and a workspace ID.
Buat templat prompt kustom: Gunakan operasi API CreatePromptTemplate.

2. Lihat dan kelola templat

Lihat: Setelah membuat templat prompt kustom, Anda dapat melihatnya di halaman Prompts.

Kelola:

Klik Modify pada kartu templat untuk mengubah kontennya.
Klik Copy Prompt untuk menyalin konten templat.
Klik Create Application. Konten templat akan secara otomatis diisi di editor prompt untuk Agent Application. Anda dapat menggunakan kontennya apa adanya atau memodifikasinya sesuai skenario bisnis Anda.
Klik Copy Template untuk membuat salinan di halaman saat ini dengan nama "Custom Prompt Template Name_Copy_Timestamp".
Klik Delete untuk menghapus templat.

Gunakan templat prompt

Konsol

Klik Use Prompt > Create Application pada kartu templat prompt bawaan atau kustom. Konten templat akan secara otomatis mengisi bidang prompt Agent Application.

Variabel templat, seperti ${name}, terlihat di kotak input prompt. Penghitung karakter di pojok kanan bawah menunjukkan jumlah karakter saat ini, dengan batas maksimum 6.144 karakter.
Tetapkan model untuk aplikasi dan masukkan pertanyaan untuk menguji prompt.

Di sisi kiri halaman debugging model, pilih model, seperti Qwen-Plus-Latest 128K, dan tulis instruksi sistem di area prompt. Di sisi kanan, masukkan pertanyaan uji di area input pengguna lalu klik Run. Respons model dan statistik token untuk input dan output akan ditampilkan di bawahnya.

API

Buka referensi API GetPromptTemplate dan klik Debug.
Di panel Configure Parameters, masukkan workspaceId dan promptTemplateId Anda.
- workspaceId: ID ruang kerja Anda. Untuk informasi lebih lanjut, lihat Get an app ID and a workspace ID.
- promptTemplateId: ID templat prompt bawaan atau kustom. Anda dapat menemukan ID tersebut di kartu templat.

Klik Initiate Call untuk melakukan debugging operasi API secara online.

{   // Skema Respons
  "variables": [   // Daftar variabel templat
    "platform",   // Variabel templat
    "topic",   // Variabel templat
    "num1",   // Variabel templat
    "num2"   // Variabel templat
  ],
  "promptTemplateId": "cfec40c311f14f3e976403059d8f0116",   // ID templat
  "requestId": "8C616xxx",   // ID permintaan
  "name": "Marketing Copy Generation",   // Nama templat
  "content": "You are a professional marketing copywriter with extensive experience on the ${platform} platform. Now, please write a highly engaging piece of ${platform} marketing content with \"${topic}\" as the core theme. The content must include a captivating and SEO-friendly title, and a detailed and emotionally compelling body. In the body, please insert at least ${num1} different emoji to increase interactivity and visual appeal. Additionally, based on this theme, design and provide up to ${num2} popular recommended tags that highly summarize the theme and attract the target audience.",   // Konten templat
}

SDK

Buka referensi API GetPromptTemplate dan klik Debug.
Di panel Configure Parameters, masukkan workspaceId dan promptTemplateId. Setelah memasukkan parameter, workspaceId dan promptTemplateId akan secara otomatis diisi dalam contoh SDK.
- workspaceId: ID ruang kerja Anda. Untuk informasi lebih lanjut, lihat Get an app ID and a workspace ID.
- promptTemplateId: ID templat prompt bawaan atau kustom. Anda dapat menemukan ID tersebut di kartu templat.
Di halaman debug, klik SDK Example.
Jalankan contoh secara online, atau unduh proyek lengkapnya, atur accessKeyId dan accessKeySecret Anda, lalu jalankan.

Untuk informasi lebih lanjut tentang cara mendapatkan AccessKey, lihat Obtain an AccessKey and AgentKey.

Di sisi kanan halaman OpenAPI Explorer, klik tab SDK Example. Pilih versi SDK V2.0 (Recommended) dan bahasa target Anda, seperti Java, untuk melihat contoh kode SDK yang sesuai.

Kode kesalahan

Jika pemanggilan gagal dan pesan kesalahan dikembalikan, lihat error codes untuk menyelesaikan masalah.

FAQ

T: Apa perbedaan antara memanggil API GetPromptTemplate dan menggabungkan string secara langsung di kode Anda?

J: Menggunakan API GetPromptTemplate untuk mengelola prompt memberikan keuntungan berikut:

Pisahkan logika dari konten: Anda dapat memperbarui dan mengoptimalkan konten prompt di Konsol Model Studio tanpa mengubah atau menerapkan ulang kode aplikasi Anda.
Pengelolaan dan kolaborasi terpusat: Menyimpan semua prompt di lokasi pusat memudahkan tim, seperti insinyur prompt dan pengembang, untuk berkolaborasi, mengelola versi, dan menggunakan kembali templat.
Konsistensi: Memastikan versi dan struktur prompt yang sama digunakan di berbagai bagian aplikasi atau antar layanan berbeda, sehingga menghindari ketidakkonsistenan akibat pemeliharaan manual.