All Products
Search
Document Center

Alibaba Cloud Model Studio:Asisten

Last Updated:Mar 17, 2026

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.
Catatan

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:

{
 "type": "${plugin_id}",
     "auth": {  # Bidang ini hanya digunakan untuk autentikasi tingkat pengguna.
         "type": "user_http",
         "user_token": "bearer-token",
         } 
 }

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.

{

"type": "plugin_type", "auth": {"type": "user_http","user_token": "bearer-token", }

}

Saat asisten meminta plugin, token bearer ditambahkan ke header pemanggilan plugin dalam format {"plugin_type":{"user_token": "bearer-token"}}.

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: desc)

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, "list").

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, "assistant.deleted").

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 "assistant").

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 temperature, bukan keduanya.

top_k

integer

Mengambil sampel dari `k` token teratas berdasarkan probabilitas. Jangan sesuaikan bersamaan dengan temperature atau top_p.

max_tokens

integer

Jumlah maksimum token per respons.

request_id

string

Pengidentifikasi panggilan API.

Kode error

Lihat Pesan error untuk panggilan yang gagal.