Gunakan Assistant API untuk membuat, menampilkan daftar, mengambil, memperbarui, dan menghapus asisten.
Fitur: Untuk informasi lebih lanjut tentang fitur dan penggunaan dasar Assistant API, lihat Ikhtisar Assistant API.
Persistensi: Semua instans asisten disimpan di server Alibaba Cloud Model Studio dan tidak memiliki tanggal kedaluwarsa. Anda dapat mengambil asisten berdasarkan assistant.id-nya.
Aplikasi agen dan asisten keduanya merupakan jenis aplikasi model, tetapi berbeda dalam fitur dan penggunaannya.
-
Aplikasi agen: Anda hanya dapat membuat, melihat, memperbarui, dan menghapus aplikasi agen di Konsol, serta memanggilnya menggunakan Application Invocation API.
-
Asisten: Anda hanya dapat membuat, melihat, memperbarui, menghapus, dan memanggil asisten menggunakan Assistant API.
Buat asisten
Membuat asisten baru.
HTTP
Contoh kode
curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/assistants' \
--header "Content-Type: application/json" \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--data '{
"model": "qwen-max",
"name": "Intelligent assistant",
"description": "This is an intelligent assistant",
"instructions": "You are an intelligent assistant that can call different tools based on user query and then give responses. Please use tools when needed.",
"tools": [
{
"type": "code_interpreter"
}
],
"metadata": {}
}'
Parameter permintaan
|
Nama parameter |
Deskripsi |
Jenis parameter |
Wajib |
|
model |
Nama model yang digunakan oleh asisten. |
string |
Ya |
|
name |
Nama asisten. |
str |
Tidak |
|
description |
Deskripsi asisten. |
string |
Tidak |
|
instructions |
Prompt sistem. |
str |
Tidak |
|
tools |
Tool yang dapat dipanggil oleh asisten. Kirimkan autentikasi untuk plugin kustom:
|
Optional[List[Dict]] |
Tidak (default: []) |
|
metadata |
Informasi tambahan untuk disimpan. |
Dict |
Tidak |
|
temperature |
Mengontrol keacakan dan keragaman. |
float |
Tidak |
|
top_p |
Ambang batas probabilitas untuk pengambilan sampel inti. |
float |
Tidak |
|
top_k |
Ukuran kumpulan kandidat untuk pengambilan sampel. |
integer |
Tidak |
Contoh respons
{
"id": "asst_49079f4b-d1e8-4015-a12e-2dcdd1f18d84",
"object": "assistant",
"created_at": 1711713885724,
"model": "qwen-max",
"name": "Intelligent Assistant",
"description": "This is an intelligent assistant.",
"instructions": "You are an intelligent assistant. You can call different tools based on user needs to provide answers. Use tools as needed.",
"tools": [
{
"type": "code_interpreter"
}
],
"metadata": {},
"temperature": null,
"top_p": null,
"top_k": null,
"max_tokens": null,
"request_id": "b1778226-3865-9006-9e95-56329a710322"
}
Parameter output
Sebuah objek asisten.
SDK
Contoh kode
from dashscope import Assistants
import os
import dashscope
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'
assistant = Assistants.create(
# Setel variabel lingkungan untuk kunci API Anda. Jika Anda tidak menyetel variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx"
api_key=os.getenv("DASHSCOPE_API_KEY"),
# Contoh ini menggunakan qwen-max. Anda dapat menggantinya dengan nama model lain sesuai kebutuhan. Untuk daftar model, lihat https://www.alibabacloud.com/help/en/model-studio/getting-started/models
model='qwen-max',
name='smart helper',
description='A tool helper.',
instructions='You are a helpful assistant. When asked a question, use tools wherever possible.',
tools=[{
'type': 'search'
}, {
'type': 'function',
'function': {
'name': 'big_add',
'description': 'Add to number',
'parameters': {
'type': 'object',
'properties': {
'left': {
'type': 'integer',
'description': 'The left operator'
},
'right': {
'type': 'integer',
'description': 'The right operator.'
}
},
'required': ['left', 'right']
}
}
}],
)
print(assistant)
import com.alibaba.dashscope.assistants.Assistant;
import com.alibaba.dashscope.assistants.AssistantParam;
import com.alibaba.dashscope.assistants.Assistants;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.InvalidateParameter;
import com.alibaba.dashscope.exception.NoApiKeyException;
import java.lang.System;
import com.alibaba.dashscope.utils.JsonUtils;
import com.alibaba.dashscope.utils.Constants;
public class Main {
static {
Constants.baseHttpApiUrl="https://dashscope-intl.aliyuncs.com/api/v1";
}
public static void main(String[] args) throws ApiException, NoApiKeyException, InputRequiredException, InvalidateParameter, InterruptedException {
Assistants assistants = new Assistants();
// build assistant parameters
AssistantParam param = AssistantParam.builder()
// Contoh ini menggunakan qwen-max. Anda dapat menggantinya dengan nama model lain sesuai kebutuhan. Untuk daftar model, lihat https://www.alibabacloud.com/help/en/model-studio/getting-started/models
.model("qwen-max")
.name("intelligent guide")
.description("a smart guide")
.instructions("You are a helpful assistant.")
// Setel variabel lingkungan untuk kunci API Anda. Jika Anda tidak menyetel variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx"
.apiKey(System.getenv("DASHSCOPE_API_KEY"))
.build();
Assistant assistant = assistants.create(param);
System.out.println(JsonUtils.toJson(assistant));
// use assistant
}
}Parameter permintaan
|
Parameter |
Jenis |
Nilai default |
Deskripsi |
|
model |
string |
- |
Nama model yang digunakan oleh asisten. |
|
name |
string |
- |
Nama asisten |
|
description |
string |
- |
Deskripsi asisten. |
|
instructions |
string |
- |
Fitur/instruksi asisten |
|
tools |
array |
[] |
Tool yang digunakan oleh asisten. Catatan
Kirimkan informasi autentikasi untuk tool kustom.
Saat asisten meminta plugin, token bearer ditambahkan ke header pemanggilan plugin dalam format |
|
metadata |
object |
None |
Metadata asisten. |
|
workspace |
string |
None |
ID ruang kerja. Diperlukan hanya saat menggunakan kunci API sub-ruang kerja. |
|
api_key |
string |
None |
Kunci API Model Studio. Kami merekomendasikan mengonfigurasinya sebagai variabel lingkungan. |
Contoh respons
{
"tools":[
{
"type":"search"
},
{
"function":{
"name":"big_add",
"description":"Add to number",
"parameters":{
"type":"object",
"properties":{
"left":{
"type":"integer",
"description":"The left operator"
},
"right":{
"type":"integer",
"description":"The right operator."
}
},
"required":[
"left",
"right"
]
}
},
"type":"function"
}
],
"id":"asst_714cac72-81b2-49bf-a75d-c575b90a9398",
"object":"assistant",
"created_at":1726033638848,
"model":"qwen-max",
"name":"smart helper",
"description":"A tool helper.",
"instructions":"You are a helpful assistant. When asked a question, use tools wherever possible.",
"file_ids":[
],
"metadata":{
},
"temperature":"None",
"top_p":"None",
"top_k":"None",
"max_tokens":"None",
"request_id":"00f5962e-8d9f-92fd-9320-3173fa1525d6",
"status_code":200
}
Parameter respons
|
Bidang |
Jenis |
Deskripsi |
|
status_code |
integer |
Kode status HTTP. 200 = sukses, nilai lain = gagal. |
|
name |
string |
Nama asisten. |
|
id |
string |
ID asisten (string UUID). |
|
model |
string |
Nama model. |
|
description |
string |
Deskripsi asisten. |
|
instructions |
string |
Instruksi asisten. |
|
metadata |
object |
Metadata asisten. |
|
tools |
array |
Tool yang dapat digunakan oleh asisten. |
|
created_at |
integer |
Timestamp pembuatan. |
|
code |
string |
Kode error (hanya pada kegagalan, SDK Python saja). |
|
message |
string |
Pesan error detail (hanya pada kegagalan, SDK Python saja). |
Daftar asisten
Menampilkan daftar semua asisten.
HTTP
Contoh kode
curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/assistants?limit=2&order=desc' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"
Parameter permintaan
|
Parameter |
Parameter input |
Jenis |
Wajib |
|
limit |
Jumlah asisten yang dikembalikan |
int |
Tidak |
|
order |
Urutkan berdasarkan waktu pembuatan (asc atau desc). |
string |
Tidak (default: |
Contoh respons
{
"object": "list",
"data": [
{
"id": "asst_0678aa33-43e2-4268-95e6-b0010f9f7937",
"object": "assistant",
"created_at": 1711435564909,
"model": "qwen-max",
"name": "Intelligent Assistant",
"description": "This is an intelligent assistant.",
"instructions": "You are an intelligent assistant. You can call different tools based on user needs to provide answers. Use tools as needed.",
"tools": [
{
"type": "search"
},
{
"type": "text_to_image"
},
{
"type": "code_interpreter"
}
],
"metadata": {}
},
{
"id": "asst_7af23142-52bc-4218-aa98-dfdb1128f19c",
"object": "assistant",
"created_at": 1711422620443,
"model": "qwen-max",
"name": "helpful assistant",
"description": "",
"instructions": "You are a helpful assistant.",
"tools": [
{
"type": "text_to_image"
}
],
"file_ids": [],
"metadata": {}
}
],
"first_id": "asst_0678aa33-43e2-4268-95e6-b0010f9f7937",
"last_id": "asst_7af23142-52bc-4218-aa98-dfdb1128f19c",
"has_more": true,
"request_id": "bc257359-ce86-9547-98be-d804effba8d1"
}
Parameter respons
Mengembalikan daftar objek asisten.
SDK
Contoh kode
import dashscope
from dashscope import Assistants
import os
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'
assistants = Assistants.list(
# Setel variabel lingkungan untuk kunci API Anda. Jika Anda tidak menyetel variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx"
api_key=os.getenv("DASHSCOPE_API_KEY"),
limit=1,
order='desc'
)import com.alibaba.dashscope.assistants.Assistant;
import com.alibaba.dashscope.assistants.Assistants;
import com.alibaba.dashscope.common.GeneralListParam;
import com.alibaba.dashscope.common.ListResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.InvalidateParameter;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.Constants;
public class Main {
static {
Constants.baseHttpApiUrl="https://dashscope-intl.aliyuncs.com/api/v1";
}
public static void main(String[] args) throws ApiException, NoApiKeyException, InputRequiredException, InvalidateParameter, InterruptedException {
Assistants assistants = new Assistants();
GeneralListParam listParam = GeneralListParam.builder()
// Setel variabel lingkungan untuk kunci API Anda. Jika Anda tidak menyetel variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx"
.apiKey(System.getenv("DASHSCOPE_API_KEY"))
.limit(10l)
.build();
ListResult<Assistant> assistant = assistants.list(listParam);
}
}Parameter permintaan
|
Parameter |
Jenis |
Nilai default |
Deskripsi |
|
limit |
string |
None |
Jumlah asisten yang dikembalikan (menggunakan default server jika dihilangkan). |
|
order |
string |
None |
Urutan pengurutan: `desc` (menurun) atau `asc` (menaik). Menggunakan default server jika dihilangkan. |
|
workspace |
string |
None |
ID ruang kerja. Diperlukan hanya saat menggunakan kunci API sub-ruang kerja. |
|
api_key |
string |
None |
Kunci API Model Studio. Kami merekomendasikan mengonfigurasinya sebagai variabel lingkungan. |
Parameter respons
|
Nama bidang |
Jenis |
Deskripsi |
|
has_more |
boolean |
Apakah masih ada data yang tersedia. |
|
last_id |
string |
ID asisten terakhir dalam daftar. |
|
first_id |
string |
ID asisten pertama dalam daftar. |
|
data |
array |
Daftar objek asisten. |
|
object |
string |
Format data bidang `data` (misalnya, |
|
request_id |
string |
ID permintaan. |
|
status_code |
integer |
Kode status permintaan. |
Ambil asisten
HTTP
Contoh kode
curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/assistants/asst_0678aa33-43e2-4268-95e6-b0010f9f7937' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"
Parameter permintaan
|
Nama parameter input |
Deskripsi parameter input |
Jenis |
Wajib |
|
assistant_id |
ID asisten yang akan diambil. |
string |
Ya |
Contoh respons
{
"id": "asst_0678aa33-43e2-4268-95e6-b0010f9f7937",
"object": "assistant",
"created_at": 1711435564909,
"model": "qwen-max",
"name": "Intelligent Assistant",
"description": "This is an intelligent assistant.",
"instructions": "You are an intelligent assistant. You can call different tools based on user needs to provide answers. Use tools as needed.",
"tools": [
{
"type": "search"
},
{
"type": "text_to_image"
},
{
"type": "code_interpreter"
}
],
"metadata": {},
"request_id": "f0ec05b0-8813-984c-81b5-1166ae3478d1"
}
Parameter respons
Mengembalikan objek asisten yang diambil.
SDK
Contoh kode
from dashscope import Assistants
import dashscope
import os
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'
assistant = Assistants.retrieve(
assistant_id='your_assistant_id',
# Setel variabel lingkungan untuk kunci API Anda. Jika Anda tidak menyetel variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx"
api_key=os.getenv("DASHSCOPE_API_KEY")
)
print(assistant)
import com.alibaba.dashscope.assistants.Assistant;
import com.alibaba.dashscope.assistants.Assistants;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.InvalidateParameter;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.Constants;
public class Main {
static {
Constants.baseHttpApiUrl="https://dashscope-intl.aliyuncs.com/api/v1";
}
public static void main(String[] args) throws ApiException, NoApiKeyException, InputRequiredException, InvalidateParameter, InterruptedException {
Assistants assistants = new Assistants();
// Setel variabel lingkungan untuk kunci API Anda. Jika Anda tidak menyetel variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx"
String apiKey = System.getenv("DASHSCOPE_API_KEY");
Assistant assistant = assistants.retrieve("assistant_id", apiKey);
}
}
Parameter permintaan
|
Parameter |
Jenis |
Nilai default |
Deskripsi |
|
assistant_id |
string |
- |
ID asisten yang akan diambil. |
|
workspace |
string |
None |
ID ruang kerja. Diperlukan hanya saat menggunakan kunci API sub-ruang kerja. |
|
api_key |
string |
None |
Kunci API Model Studio. Kami merekomendasikan mengonfigurasinya sebagai variabel lingkungan. |
Parameter respons
Untuk informasi lebih lanjut, lihat objek asisten.
Perbarui asisten
HTTP
Contoh kode
curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/assistants/asst_0678aa33-43e2-4268-95e6-b0010f9f7937' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--data '{
"instructions": "You are a search assistant",
"name": "New Application-assistantAPI",
"description": "",
"model": "qwen-max"
}'
Parameter permintaan
|
Nama parameter input |
Deskripsi |
Jenis parameter |
Wajib |
|
assistant_id |
ID asisten yang akan diperbarui. |
string |
Ya |
|
* |
Parameter opsional lainnya. |
string |
Tidak |
|
model |
Nama model yang digunakan oleh asisten. |
string |
Ya |
|
name |
Nama asisten. |
string |
Tidak |
|
description |
Deskripsi asisten. |
string |
Tidak |
|
instructions |
Prompt sistem. |
str |
Tidak |
|
tools |
Tool yang dapat dipanggil oleh asisten. |
Optional[List[Dict]] |
Tidak (default: []) |
|
metadata |
Informasi tambahan untuk disimpan. |
Dict |
Tidak |
Contoh respons
{
"id": "asst_0678aa33-43e2-4268-95e6-b0010f9f7937",
"object": "assistant",
"created_at": 1711435564909,
"model": "qwen-max",
"name": "New Application-assistantAPI",
"description": "",
"instructions": "You are a search assistant.",
"tools": [
{
"type": "search"
},
{
"type": "text_to_image"
},
{
"type": "code_interpreter"
}
],
"metadata": {},
"request_id": "b0993831-a98b-9e71-b235-75174df9046e"
}
Parameter output
Mengembalikan objek asisten yang telah diperbarui.
SDK
Contoh kode
from dashscope import Assistants
import dashscope
import os
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'
assistants = Assistants.update(
'assistant_id',
model='new_model_name',
# Setel variabel lingkungan untuk kunci API Anda. Jika Anda tidak menyetel variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx"
api_key=os.getenv("DASHSCOPE_API_KEY")
)
import com.alibaba.dashscope.assistants.Assistant;
import com.alibaba.dashscope.assistants.AssistantParam;
import com.alibaba.dashscope.assistants.Assistants;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.InvalidateParameter;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.Constants;
public class Main {
static {
Constants.baseHttpApiUrl="https://dashscope-intl.aliyuncs.com/api/v1";
}
public static void main(String[] args) throws ApiException, NoApiKeyException, InputRequiredException, InvalidateParameter, InterruptedException {
Assistants assistants = new Assistants();
AssistantParam param = AssistantParam.builder()
.model("qwen-max")
.name("intelligent guide")
.description("a smart guide")
.instructions("You are a helpful assistant. When asked a question, use tools wherever possible.")
// Setel variabel lingkungan untuk kunci API Anda. Jika Anda tidak menyetel variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx"
.apiKey(System.getenv("DASHSCOPE_API_KEY"))
.build();
Assistant assistant = assistants.update("assistant_id", param);
}
}Parameter permintaan
|
Parameter |
Jenis |
Nilai default |
Deskripsi |
|
assistant_id |
string |
- |
ID asisten yang akan diperbarui. |
|
model |
string |
- |
Nama model yang digunakan oleh asisten. |
|
name |
string |
None |
Nama asisten. |
|
description |
string |
None |
Deskripsi asisten. |
|
instructions |
string |
None |
Instruksi asisten. |
|
tools |
array |
[] |
Tool yang dapat digunakan oleh asisten. |
|
metadata |
object |
None |
Metadata asisten. |
|
workspace |
string |
None |
ID ruang kerja. Diperlukan hanya saat menggunakan kunci API sub-ruang kerja. |
|
api_key |
string |
None |
Kunci API Model Studio. Kami merekomendasikan mengonfigurasinya sebagai variabel lingkungan. |
Parameter respons
Untuk informasi lebih lanjut, lihat objek asisten.
Hapus asisten
HTTP
Contoh kode
curl --location --request DELETE 'https://dashscope-intl.aliyuncs.com/api/v1/assistants/asst_0678aa33-43e2-4268-95e6-b0010f9f7937' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"
Parameter permintaan
|
Nama parameter input |
Deskripsi |
Jenis parameter |
Wajib |
|
assistant_id |
ID asisten yang akan dihapus. |
str |
Ya |
Contoh respons
{
"id": "asst_0678aa33-43e2-4268-95e6-b0010f9f7937",
"object": "assistant.deleted",
"deleted": true,
"request_id": "6af9320f-0430-9d01-b92f-d1beb6424dc5"
}
Parameter respons
Status penghapusan.
SDK
Contoh kode
from dashscope import Assistants
import dashscope
import os
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'
assistants = Assistants.delete(
'assistant_id',
# Setel variabel lingkungan untuk kunci API Anda. Jika Anda tidak menyetel variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx"
api_key=os.getenv("DASHSCOPE_API_KEY")
)import com.alibaba.dashscope.assistants.Assistants;
import com.alibaba.dashscope.common.DeletionStatus;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.InvalidateParameter;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.Constants;
public class Main {
static {
Constants.baseHttpApiUrl="https://dashscope-intl.aliyuncs.com/api/v1";
}
public static void main(String[] args) throws ApiException, NoApiKeyException, InputRequiredException, InvalidateParameter, InterruptedException {
Assistants assistants = new Assistants();
// Setel variabel lingkungan untuk kunci API Anda. Jika Anda tidak menyetel variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx"
String apiKey = System.getenv("DASHSCOPE_API_KEY");
DeletionStatus assistant = assistants.delete("assistant_id", apiKey);
}
}Parameter permintaan
|
Parameter |
Jenis |
Nilai default |
Deskripsi |
|
assistant_id |
string |
- |
ID asisten yang akan dihapus. |
|
workspace |
string |
None |
ID ruang kerja. Diperlukan hanya saat menggunakan kunci API sub-ruang kerja. |
|
api_key |
string |
None |
Kunci API Model Studio. Kami merekomendasikan mengonfigurasinya sebagai variabel lingkungan. |
Parameter respons
|
Nama bidang |
Jenis |
Deskripsi |
|
id |
string |
ID objek yang dihapus. |
|
object |
string |
Jenis objek (misalnya, |
|
deleted |
boolean |
Apakah penghapusan berhasil. |
|
request_id |
string |
ID permintaan. |
|
status_code |
integer |
Kode status permintaan. |
Objek asisten
Merupakan representasi asisten yang dapat memanggil model dan menggunakan tool.
Contoh objek asisten
{
"id": "asst_49079f4b-d1e8-4015-a12e-2dcdd1f18d84",
"object": "assistant",
"created_at": 1711713885724,
"model": "qwen-max",
"name": "Intelligent Assistant",
"description": "This is an intelligent assistant.",
"instructions": "You are an intelligent assistant. You can call different tools based on user needs to provide answers. Use tools as needed.",
"tools": [
{
"type": "code_interpreter"
}
],
"metadata": {},
"temperature": null,
"top_p": null,
"top_k": null,
"max_tokens": null,
"request_id": "b1778226-3865-9006-9e95-56329a710322"
}
|
Parameter |
Jenis data |
Deskripsi |
|
id |
string |
ID asisten. |
|
object |
string |
Jenis objek (selalu |
|
created_at |
integer |
Timestamp pembuatan (Unix, milidetik). |
|
model |
string |
Nama model. Lihat Ikhtisar Assistant API atau Daftar Model untuk model yang tersedia. |
|
name |
string |
Nama asisten. |
|
description |
string |
Deskripsi asisten. |
|
instructions |
string |
Instruksi asisten. |
|
tools |
array |
Tool yang diaktifkan untuk asisten (plugin resmi, RAG, atau pemanggilan fungsi). |
|
metadata |
dict |
Informasi terstruktur tambahan mengenai asisten. |
|
temperature |
float |
Suhu pengambilan sampel (0-2). Nilai lebih tinggi (misalnya, 1.0) = lebih acak; nilai lebih rendah (misalnya, 0.2) = lebih deterministik. |
|
top_p |
float |
Pengambilan sampel inti: mempertimbangkan token dengan massa probabilitas kumulatif sebesar `top_p` (misalnya, 0.1 = 10% teratas). Sesuaikan salah satu dari ini atau |
|
top_k |
integer |
Mengambil sampel dari `k` token teratas berdasarkan probabilitas. Jangan sesuaikan bersamaan dengan |
|
max_tokens |
integer |
Jumlah maksimum token per respons. |
|
request_id |
string |
Pengidentifikasi panggilan API. |
Kode error
Lihat Pesan error untuk panggilan yang gagal.