Model

Memungkinkan Mini App memakai model AI yang sudah disiapkan di Cowork. API key tetap di dalam Cowork dan tidak pernah sampai ke halaman. Setiap panggilan adalah satu permintaan dan satu balasan: tanpa alat, tanpa riwayat obrolan.

MAESTROSDK.llm.providers() Belum dirilis

Menampilkan daftar penyedia model yang siap dipakai (sudah masuk atau punya key), beserta model dan tingkat penalarannya.

Parameter

Tidak ada.

Nilai kembalian

Promise<Provider[]>. Daftar kosong jika belum ada yang disiapkan, jika halaman tidak punya identitas tab Cowork, atau jika panggilan gagal.

Field	Tipe	Deskripsi
id	string	ID penyedia, diberikan ke complete sebagai provider
label	string	Nama yang ditampilkan
models[].id	string	ID model, diberikan sebagai model
models[].label	string	Nama yang ditampilkan
models[].defaultEffort	string	Tingkat penalaran yang dipakai Cowork secara default
models[].efforts[]	{ id, label }[]	Tingkat penalaran yang diterima model ini; berikan sebuah id sebagai effort

Contoh

const providers = await MAESTROSDK.llm.providers();
const first = providers[0]?.models[0];

MAESTROSDK.llm.complete(request) Belum dirilis

Mengirim satu prompt ke satu model dan mengembalikan balasan teksnya.

Parameter

Nama	Tipe	Wajib	Deskripsi
request.provider	string	Ya	Sebuah id penyedia dari providers()
request.model	string	Ya	Sebuah id model dari penyedia itu
request.effort	string	Ya	Sebuah id tingkat penalaran dari model itu
request.prompt	string	Ya	Prompt, paling banyak 32.000 karakter

Satu panggilan menunggu model paling lama 120 detik.

Nilai kembalian

Promise<{ ok: true, text: string } | { ok: false, error: string }>

Error

error	Arti
provider, model, effort and prompt are required	Ada field yang tidak ada atau kosong
prompt_too_long	Prompt lebih dari 32.000 karakter
empty_prompt	Prompt hanya berisi spasi
unknown_model	Kombinasinya tidak ada di providers()
empty_reply	Model tidak mengembalikan teks
no_instance	Halaman tidak punya identitas tab Cowork
host_unavailable	Cowork tidak bisa menerima panggilan
Teks lain	Pesan error dari model itu sendiri, atau model_failed

Contoh

const [provider] = await MAESTROSDK.llm.providers();
const model = provider.models[0];
const reply = await MAESTROSDK.llm.complete({
  provider: provider.id,
  model: model.id,
  effort: model.defaultEffort,
  prompt: 'Summarise this note in one sentence: ...'
});
if (reply.ok) show(reply.text); else showError(reply.error);

Terkait

• Chat: Model dan Tingkat Penalaran Tempat model disiapkan
• Ikhtisar Semua modul SDK Mini App