API Asisten menyederhanakan pembuatan asisten, yaitu jenis aplikasi Large Language Model (LLM). Topik ini menjelaskan metode yang disediakan oleh API Asisten untuk mengelola asisten, termasuk membuat, menampilkan daftar, mengambil, memperbarui, dan menghapusnya.
Fitur: Untuk informasi lebih lanjut tentang fitur dan penggunaan dasar API Asisten, lihat Ikhtisar API Asisten.
Persistensi: Semua instans asisten disimpan di server Alibaba Cloud Model Studio dan tidak memiliki tanggal kedaluwarsa. Anda dapat mengambil asisten menggunakan assistant.id-nya.
- Aplikasi agen: Anda hanya dapat membuat, melihat, memperbarui, dan menghapus aplikasi agen di Konsol. Anda dapat memanggilnya menggunakan API pemanggilan aplikasi.
- Asisten: Anda hanya dapat membuat, melihat, memperbarui, menghapus, dan memanggil asisten menggunakan API Asisten.
Buat agen
Membuat asisten baru.
- HTTP
- SDK
| Nama parameter | Deskripsi | Tipe | Wajib |
|---|---|---|---|
| model | Model yang digunakan oleh agen. | str | Ya |
| name | Nama agen. | str | Tidak |
| description | Deskripsi agen. | str | Tidak |
| instructions | Prompt sistem untuk LLM dalam agen. | str | Tidak |
| tools | Daftar tool yang dapat dipanggil oleh agen.Menyampaikan informasi otentikasi untuk plugin kustom. | Optional[List[Dict]] | Tidak (default: []) |
| metadata | Parameter lain yang terkait dengan agen. Parameter ini digunakan untuk menyimpan parameter terkait lainnya. | Dict | Tidak |
| temperature | Mengontrol tingkat keacakan dan keragaman. | float | Tidak |
| top_p | Ambang batas probabilitas untuk metode pengambilan sampel inti selama generasi. | float | Tidak |
| top_k | Ukuran set kandidat untuk pengambilan sampel selama generasi. | integer | Tidak |
Daftar agen
Menampilkan daftar asisten.
- HTTP
- SDK
Nama Parameter Masukan | Deskripsi parameter masukan | Tipe | Wajib |
|---|---|---|---|
limit | Jumlah agen | int | Tidak |
order | Urutan pengurutan berdasarkan waktu pembuatan. | str | Tidak (default: |
Agen Pengambilan
- HTTP
- SDK
Nama parameter masukan | Deskripsi parameter masukan | Tipe | Wajib |
|---|---|---|---|
assistant_id | ID agen yang akan diambil. | str | Ya |
Perbarui agen
- HTTP
- SDK
Nama Parameter Masukan | Deskripsi parameter masukan | Tipe | Wajib |
assistant_id | ID agen yang akan diambil | str | Ya |
* | Parameter masukan opsional lainnya. | str | Tidak |
model | ID model yang digunakan oleh agen. | str | Ya |
name | Nama agen. | str | Tidak |
description | Deskripsi agen. | str | Tidak |
instructions | Prompt sistem untuk LLM dalam agen. | str | Tidak |
tools | Daftar tool yang dapat dipanggil oleh agen. Tool tersebut harus terdaftar di Alibaba Cloud Model Studio. | Optional[List[Dict]] | Tidak (default: []) |
metadata | Menyimpan parameter terkait lainnya untuk agen. | Dict | Tidak |
Hapus agen
- HTTP
- SDK
Nama Parameter Masukan | Deskripsi | Tipe | Wajib |
assistant_id | ID agen yang akan diambil. | str | Ya |
Objek agen
Objek Assistant yang dapat memanggil model dan menggunakan tool.
Contoh Objek Agen
Nama parameter | Tipe data | Deskripsi |
|---|---|---|
id | string | Identifier unik agen, yaitu ID asisten. |
object | string | Tipe objek. Nilai ini selalu |
created_at | integer | Stempel waktu Unix 13 digit, dalam milidetik, saat agen dibuat. |
model | string | Nama model yang digunakan oleh agen. Anda dapat melihat semua model yang tersedia di Ikhtisar API Asisten atau lihat Daftar model untuk detail lebih lanjut. |
name | string | Nama agen. |
description | string | Deskripsi agen. |
instructions | string | Instruksi sistem yang digunakan oleh agen. |
tools | array | Daftar tool yang diaktifkan pada agen. Tool tersebut dapat berupa plugin resmi (seperti `code_interpreter`, `quark_search`, atau `text_to_image`), Generasi yang Diperkaya dengan Pengambilan Data (RAG), atau pemanggilan fungsi. |
metadata | dict | Informasi tambahan tentang objek agen yang disimpan dalam format terstruktur. |
temperature | float | Suhu pengambilan sampel, yang berkisar antara 0 hingga 2. Nilai yang lebih tinggi, seperti 1, membuat output lebih acak. Nilai yang lebih rendah, seperti 0,2, membuat output lebih fokus dan deterministik. |
top_p | float | Alternatif dari pengambilan sampel suhu, yang disebut pengambilan sampel inti. Dalam metode pengambilan sampel ini, LLM memilih hasil token yang memiliki massa probabilitas kumulatif sebesar `top_p`. Nilai 0,1 berarti hanya token yang membentuk 10% teratas dari massa probabilitas yang dipertimbangkan. Atur parameter ini atau |
top_k | integer | Mirip dengan `top_p`, tetapi sampel dipilih dari k token dengan probabilitas tertinggi, tanpa mempertimbangkan massa probabilitas kumulatifnya. Jangan atur parameter ini bersamaan dengan |
max_tokens | integer | Jumlah maksimum token yang dapat dihasilkan agen dalam satu kali. |
request_id | string | Identifier unik pemanggilan yang terkait dengan agen. |