TL;DR
Kimi Hosted Agents menjalankan tugas AI multi-langkah dengan sesi persisten, eksekusi tool, dan sandbox cloud. Panduan ini membawa Anda dari kunci API Kimi hingga presentasi tiga slide yang dapat diunduh menggunakan Bash, curl, dan jq. Pertama selesaikan satu tugas dengan prompt mandiri. Lalu tambahkan dokumen terunggah, hubungkan tool bisnis, dan tangani kegagalan yang penting dalam aplikasi yang dideploy.
Poin Penting
- Kimi Hosted Agents menghubungkan definisi agen, lingkungan eksekusi, dan sesi. Simpan ID masing-masing sepanjang alur kerja.
- Mulailah dengan hasil kecil yang dapat diverifikasi. Contoh pertama menghasilkan presentasi dengan data fiksi dan perhitungan yang bisa Anda cek.
- Gunakan event stream untuk mengikuti eksekusi, lalu periksa file yang dikirimkan. Respons HTTP yang sukses saja tidak membuktikan keberhasilan tugas.
- Perluas contoh yang berfungsi dengan input file, tool kustom, atau layanan MCP. Setiap integrasi memiliki persyaratan eksekusi dan kredensialnya sendiri.
- Anggarkan inferensi, runtime sandbox, dan penggunaan plugin bersama-sama, termasuk pengulangan yang diperlukan untuk menghasilkan hasil yang dapat diterima.
Apa itu Kimi Hosted Agents?
Moonshot AI mengumumkan Kimi Hosted Agents pada 5 November 2026, memposisikannya sebagai layanan untuk perusahaan dan pengembang yang membangun agen jangka panjang.
Produk ini menggunakan pendekatan Harness as a Service. Harness adalah perangkat lunak di sekitar model yang mengelola kemajuan pekerjaan: mempertahankan state, memanggil tool, mengelola eksekusi, dan memulihkan dari gangguan.
Pertimbangkan alur kerja riset mingguan. Menghasilkan teks hanyalah satu langkah. Aplikasi mungkin juga perlu mengambil sumber, memproses file, membuat grafik, menyimpan presentasi, dan menyimpan cukup state untuk melanjutkan setelah disconnect.
Hosted Agents menyediakan lapisan operasional tersebut. Tim Anda tetap mendefinisikan tugas bisnis, memilih integrasi, dan memutuskan apa yang merupakan hasil yang dapat diterima.
Kimi’s official architecture memperlihatkan aplikasi, layanan platform, dan inti eksekusi yang digunakan oleh runtime hosted.
Kemampuan inti untuk integrasi pertama Anda
- Sesi persisten menjaga input tugas, event eksekusi, dan output tetap bersama.
- Sandbox cloud menyediakan tool yang dibutuhkan untuk memproses file dan membuat deliverable.
- Skills dan plugin mengemas kapabilitas yang dapat digunakan kembali; custom tool dan layanan MCP menghubungkan sistem Anda sendiri.
Checkpoint pertama Anda adalah presentasi yang bisa dibuka dan diperiksa. Spesifikasi runtime terperinci menjadi berguna ketika Anda menambahkan dependensi atau memindahkan alur kerja yang ada ke sandbox; sandbox reference mendokumentasikan lingkungan yang tersedia.
Apa yang Anda perlukan sebelum memanggil Kimi Hosted Agents API?
- Akun platform Kimi dengan akses ke Hosted Agents dan kunci API.
- Bash, curl, dan jq di macOS, Linux, atau Windows dengan WSL.
- Dua terminal: Terminal A mengirim permintaan; Terminal B memantau event eksekusi.
- Penampil presentasi untuk membuka PPTX yang dihasilkan.
Buat akun platform Kimi dan kunci API di area manajemen API konsol. Gunakan satu terminal Bash, disebut Terminal A, untuk perintah setup dan tugas. Biarkan terbuka agar langkah selanjutnya bisa menggunakan variabelnya. Instal curl dan jq sebelum melanjutkan. Contoh menggunakan versi API beta 2026-09-01-beta.
command -v curl &&
command -v jq &&
read -rsp "Kimi API key: " KIMI_API_KEY &&
printf '\n' &&
test -n "$KIMI_API_KEY" &&
export KIMI_API_KEY &&
export KIMI_BASE="https://api.moonshot.cn/v1" &&
export KIMI_VERSION="2026-09-01-beta"
Bagaimana cara menjalankan tugas Kimi Hosted Agents pertama Anda
Alur kerja mengikuti REST API quickstart Kimi. Anda akan menggunakan asisten PPT resmi untuk mengubah brief bisnis fiksi yang singkat menjadi presentasi. Semua data input disertakan dalam permintaan, jadi run pertama tidak perlu unggahan file atau koneksi data privat.
Jalankan setiap blok secara berurutan dan periksa outputnya sebelum melanjutkan. Perintah yang digabung dengan && menghentikan blok tersebut ketika permintaan atau validasi gagal. Perbaiki error yang dilaporkan sebelum melangkah ke langkah berikutnya; gunakan ID environment dan sesi yang sama saat mencoba ulang setup yang ada.
Langkah 1: Pilih asisten PPT resmi
Ambil agen yang tersedia dan periksa nama serta definisinya. Saat diminta, tempelkan ID asisten PPT resmi yang dikonfigurasi dengan kemampuan PPT. Perintah terakhir memeriksa bahwa pilihan Anda ada dalam daftar yang dikembalikan dan mencetak definisinya.
curl --fail-with-body -sS "$KIMI_BASE/agents" \
-H "Authorization: Bearer $KIMI_API_KEY" \
-H "kimi-api-version: $KIMI_VERSION" \
-o agents.json &&
jq -r '.items[] | [.id, .name] | @tsv' agents.json &&
read -rp "PPT assistant ID: " AGENT_ID &&
jq -e --arg id "$AGENT_ID" \
'.items[] | select(.id == $id)' agents.json &&
export AGENT_ID
Perintah terakhir harus mencetak definisi agen yang dipilih. Jika asisten tidak tersedia di proyek Anda, gunakan konfigurasi agen PPT resmi untuk menyiapkan agen yang setara sebelum melanjutkan.
Langkah 2: Buat environment cloud
Environment adalah konfigurasi yang dapat digunakan ulang untuk setup eksekusi Anda, termasuk paket yang terpasang, akses jaringan, dan perintah startup. Menggunakannya kembali memberi sesi selanjutnya setup yang sama; setiap sesi cloud tetap menerima sandbox dan workspace masing-masing. Lihat panduan environment untuk opsi konfigurasi.
Buat environment sekali dan simpan ID-nya. Image cloud dibangun secara asinkron, jadi tunggu hingga status build-nya ready sebelum membuat sesi. Jika API melaporkan bahwa belum siap, tunggu dan coba lagi dengan ENVIRONMENT_ID yang sama. Membuat environment lain tidak menyelesaikan build pertama.
curl --fail-with-body -sS "$KIMI_BASE/environments" \
-H "Authorization: Bearer $KIMI_API_KEY" \
-H "kimi-api-version: $KIMI_VERSION" \
-H "Content-Type: application/json" \
-d '{"name":"First presentation environment","config":{"type":"cloud"}}' \
-o environment.json &&
ENVIRONMENT_ID="$(jq -er '.id | strings | select(length > 0)' environment.json)" &&
export ENVIRONMENT_ID &&
printf 'Environment: %s\n' "$ENVIRONMENT_ID"
Langkah 3: Buat sesi
Sesi memfiksasi versi Agen dan versi Environment yang tersedia saat dibuat. Permintaan di bawah ini menyertakan ID mereka; platform memilih dan membekukan versinya. Anda juga bisa menetapkan agent_version untuk memilih versi Agen yang spesifik. Memperbarui Agen atau Environment di kemudian hari tidak memperbarui sesi yang ada, dan sesi tidak dapat mengganti environment_id-nya. Buat sesi baru untuk menggunakan konfigurasi yang direvisi. Aturan ini didokumentasikan dalam pembuatan sesi.
Simpan ID sesi yang dikembalikan untuk event stream dan permintaan tugas. Sesi baru dimulai dalam idle; mengirim user.message memulai tugas.
test -n "$AGENT_ID" &&
test -n "$ENVIRONMENT_ID" &&
jq -n --arg agent "$AGENT_ID" --arg env "$ENVIRONMENT_ID" \
'{agent_id:$agent,environment_id:$env,title:"First product update presentation"}' \
> session-request.json &&
curl --fail-with-body -sS "$KIMI_BASE/sessions" \
-H "Authorization: Bearer $KIMI_API_KEY" \
-H "kimi-api-version: $KIMI_VERSION" \
-H "Content-Type: application/json" \
--data-binary @session-request.json \
-o session.json &&
SESSION_ID="$(jq -er '.id | strings | select(length > 0)' session.json)" &&
export SESSION_ID &&
printf 'Session: %s\n' "$SESSION_ID"
Langkah 4: Pantau eksekusi di terminal kedua
Buka Terminal B. Masukkan kunci API yang sama, lalu tempelkan ID sesi yang dicetak di Terminal A. Server-sent event stream menampilkan pembaruan eksekusi saat Terminal A mengirim tugas. Biarkan terminal ini tetap terhubung hingga Anda memeriksa hasilnya.
read -rsp "Kimi API key: " KIMI_API_KEY &&
printf '\n' &&
test -n "$KIMI_API_KEY" &&
read -rp "Session ID from Terminal A: " SESSION_ID &&
test -n "$SESSION_ID" &&
curl --fail-with-body -sS -N \
"https://api.moonshot.cn/v1/sessions/$SESSION_ID/events/stream" \
-H "Authorization: Bearer $KIMI_API_KEY" \
-H "kimi-api-version: 2026-09-01-beta" \
-H "Accept: text/event-stream"
Langkah 5: Kirim tugas yang berdiri sendiri
Kembali ke Terminal A dan kirim event user.message. Contoh menggunakan angka fiksi dan meminta deliverable spesifik. Agen harus menggunakan fakta yang diberikan alih-alih mencari data bisnis pendukung.
cat > task.json <<'JSON' &&
{
"events": [{
"type": "user.message",
"data": {"content": [{
"type": "text",
"text": "Create a three-slide PPTX for a fictional product called Northstar. Use only these supplied facts: the pilot has 120 users; 90 were active this week; the team plans to interview 10 users next week. Slide 1: pilot overview. Slide 2: weekly activity, including the active-user percentage. Slide 3: next steps. Label the business and data as fictional. Do not browse the web. Save the presentation and register the PPTX as a downloadable artifact using save_artifact."
}]}
}]
}
JSON
curl --fail-with-body -sS "$KIMI_BASE/sessions/$SESSION_ID/events" \
-H "Authorization: Bearer $KIMI_API_KEY" \
-H "kimi-api-version: $KIMI_VERSION" \
-H "Content-Type: application/json" \
--data-binary @task.json
Langkah 6: Unduh dan periksa presentasi
Pantau event session.status di Terminal B. Saat sesi kembali ke idle, periksa alasan berhentinya: end_turn menunjukkan giliran telah selesai, sedangkan requires_action berarti klien Anda harus memberikan hasil tool atau menangani konfirmasi. Periksa juga event session.error. Setelah giliran selesai tanpa error yang belum terselesaikan, daftar artifak dan pilih PPTX yang dihasilkan.
curl --fail-with-body -sS "$KIMI_BASE/artifacts?session_id=$SESSION_ID" \
-H "Authorization: Bearer $KIMI_API_KEY" \
-H "kimi-api-version: $KIMI_VERSION" \
-o artifacts.json &&
jq . artifacts.json &&
read -rp "PPTX artifact ID: " ARTIFACT_ID &&
test -n "$ARTIFACT_ID" &&
curl --fail-with-body -sS "$KIMI_BASE/artifacts/$ARTIFACT_ID/content" \
-H "Authorization: Bearer $KIMI_API_KEY" \
-H "kimi-api-version: $KIMI_VERSION" \
-o northstar.pptx &&
printf 'Downloaded northstar.pptx\n'
Buka northstar.pptx. Hasil yang sukses memiliki tiga slide, mengidentifikasi data sebagai fiksi, dan menghitung aktivitas mingguan sebagai 90 ÷ 120 = 75%. Ini memberi Anda pemeriksaan konkret atas pengiriman file dan akurasi konten sebelum menghubungkan data bisnis yang nyata.
Bagaimana cara mengunggah dan melampirkan file ke sesi Kimi Hosted Agents?
Setelah presentasi pertama berfungsi, tempatkan report.pdf sampel di direktori kerja Terminal A. File API memisahkan pengunggahan file dari pelampirannya ke sesi. Jalankan blok ini dengan ID sesi yang ada setelah tugas pertama selesai.
Gunakan purpose=file-extract untuk mengekstrak teks dari PDF. File API mengizinkan hingga 100 MiB per file dan default 10 GiB penyimpanan per organisasi. File yang diunggah tidak dapat diperbarui di tempat; unggah file yang direvisi dan ikat ID barunya. Hapus file yang tidak digunakan saat Anda perlu mengosongkan penyimpanan.
Dengan kimi-api-version: 2026-09-01-beta, periksa extract_status dalam respons upload. Contoh ini hanya melanjutkan saat statusnya ready. Jika error, periksa format dan konten PDF, lalu unggah file yang dikoreksi. API dapat melampirkan ekstraksi yang gagal sebagai file mentah, tetapi itu tidak menyediakan teks hasil ekstraksi yang diharapkan tutorial ini. Status yang hilang atau tidak terduga juga menghentikan blok; periksa upload.json sebelum melanjutkan.
test -f report.pdf &&
test -n "$SESSION_ID" &&
curl --fail-with-body -sS "$KIMI_BASE/files" \
-H "Authorization: Bearer $KIMI_API_KEY" \
-H "kimi-api-version: $KIMI_VERSION" \
-F "file=@report.pdf" \
-F "purpose=file-extract" \
-o upload.json &&
FILE_ID="$(jq -er '.id | strings | select(length > 0)' upload.json)" &&
{
EXTRACT_STATUS="$(jq -r '.extract_status // "missing"' upload.json)" &&
case "$EXTRACT_STATUS" in
ready) true ;;
error)
printf '%s\n' 'PDF extraction failed. Check the PDF and upload a corrected file.' >&2
false ;;
*)
printf 'Unexpected extract_status: %s. Inspect upload.json before continuing.\n' "$EXTRACT_STATUS" >&2
false ;;
esac
} &&
jq -n --arg file "$FILE_ID" \
'{type:"file",file_id:$file}' > resource-request.json &&
curl --fail-with-body -sS "$KIMI_BASE/sessions/$SESSION_ID/resources" \
-H "Authorization: Bearer $KIMI_API_KEY" \
-H "kimi-api-version: $KIMI_VERSION" \
-H "Content-Type: application/json" \
--data-binary @resource-request.json
Melampirkan file tidak mengirim tugas baru. Biarkan Terminal B terhubung dan kirim tindak lanjut yang menyebutkan dokumen dan output yang diinginkan.
jq -n --arg prompt \
"Use the attached report.pdf to create a new three-slide PPTX. Replace the earlier fictional brief. Summarize the report, its evidence, and its next steps. Do not invent missing figures or browse the web. Register the finished PPTX with save_artifact." \
'{events:[{type:"user.message",data:{content:[{type:"text",text:$prompt}]}}]}' \
> followup.json &&
curl --fail-with-body -sS "$KIMI_BASE/sessions/$SESSION_ID/events" \
-H "Authorization: Bearer $KIMI_API_KEY" \
-H "kimi-api-version: $KIMI_VERSION" \
-H "Content-Type: application/json" \
--data-binary @followup.json
Saat tugas ini selesai, ulangi langkah pendataan artifak dan pilih PPTX yang baru. Bandingkan klaimnya dengan PDF, terutama angka, tanggal, dan tindakan yang diusulkan.
Bagaimana cara menghubungkan tools ke Kimi Hosted Agents?
Custom tool yang dieksekusi oleh aplikasi Anda
Untuk tindakan bisnis seperti melihat status pengiriman proyek, gunakan custom tool yang diimplementasikan oleh aplikasi Anda. Mendeklarasikan tool membuatnya tersedia bagi agen; kode Anda tetap melakukan operasinya.
- Deklarasikan entri
customdalam arraytoolsagen dengan nama, deskripsi, daninput_schemaberbentuk objek. - Tangani
agent.custom_tool_usedari event stream dan validasi argumen yang diberikan sebelum mengeksekusi fungsi Anda. - Posting event
user.custom_tool_resultke sesi, menggunakanidJSON event pemanggil sebagaidata.event_id.
Mulailah dengan lookup read-only. Simpan otorisasi dan perlindungan tindakan duplikat dalam aplikasi ketika sebuah integrasi dapat memodifikasi catatan bisnis.
Layanan MCP dan alur kerja yang lebih besar
Untuk layanan MCP jarak jauh, deklarasikan koneksinya di mcp_servers. Simpan kredensial akses dalam vault dan ikat vault tersebut saat membuat sesi. Platform menemukan dan memanggil tool layanan; definisi server harus berisi detail koneksi alih-alih secret.
Orkestrasi multi-agen opsional
Platform mendukung delegasi koordinator-ke-child. Koordinator dapat menugaskan tugas terbatas kepada thread child dan menggabungkan hasilnya.
Konfigurasi delegasinya menerima 1–20 entri agen. Ini adalah batas konfigurasi, bukan bukti 20 pekerja simultan atau peningkatan kecepatan 20×. Thread child tidak dapat membuat lapisan thread child lain.
Desain yang berguna dapat memisahkan pengumpulan sumber, analisis kuantitatif, dan tinjauan editorial. Tugas ringkas untuk pensarikan biasanya lebih baik ditangani oleh satu agen.
Bagaimana cara mendepoy integrasi Kimi Hosted Agents?
Letakkan panggilan API Kimi di belakang backend aplikasi Anda. Browser dapat mengirim tugas dan menampilkan progres melalui endpoint Anda sendiri, sementara backend menyimpan kunci API dan memetakan setiap pengguna ke sesi yang boleh mereka akses. Simpan ID sesi bersama permintaan bisnis agar muatan ulang halaman dapat membuka kembali tugas yang sama.
Eksekusi Hosted vs. Self-Hosted
Gunakan environment cloud untuk alur kerja PPT dalam panduan ini: ia mendukung save_artifact dan alur kerja file sesi. Pilih environment self-hosted ketika eksekusi sandbox harus berjalan di host yang dikelola organisasi Anda. Kimi tetap menjalankan inferensi model, orkestrasi, dan manajemen sesi; input tool dan hasil melewati platformnya. Ini adalah model eksekusi hybrid.
- Environment self-hosted memerlukan verifikasi enterprise. Anda mengoperasikan host Worker, memasang dependensi, dan mengelola isolasi serta kredensial. Worker memerlukan akses HTTPS outbound ke platform.
- Mode self-hosted saat ini tidak memiliki
save_artifact, IPython, dan tool pencarian gambar. File yang diunggah, skills, dan memori tidak di-mount pada Worker, dan file outputnya tidak muncul di daftar file sesi. Rencanakan bagaimana memasok input dan mengambil output sebelum memindahkan tutorial ini ke mode tersebut.
Untuk integrasi pertama, mulailah di cloud. Pertimbangkan self-hosting ketika kontrol atas host eksekusi membenarkan setup tambahan dan perubahan pengiriman file.
Memilih siapa yang mengoperasikan runtime
Gunakan Hosted Agents saat Anda ingin platform mengelola eksekusi sesi. Jika tim Anda perlu membangun dan mengoperasikan loop agen sendiri, CometAPI menyediakan akses API model terpadu untuk stack kustom tersebut. Contoh Hosted Agents dalam panduan ini menggunakan endpoint dan kredensial Kimi sendiri.
Harga Kimi Hosted Agents dan Optimasi Biaya
Kimi Hosted Agents menagih token model, runtime sandbox cloud, dan panggilan plugin berbayar. Tabel di bawah menunjukkan bagaimana biaya tersebut memengaruhi alur kerja presentasi. Harga dalam yuan Tiongkok (CNY), dicek pada 10 November 2026 terhadap harga Hosted Agents dan harga inferensi model. Satu juta token sama dengan 1 MTok.
| Komponen biaya | Unit penagihan | Tarif dan artinya bagi tugas Anda |
|---|---|---|
| Inferensi model | Per 1 MTok | Untuk kimi-k3.1-pro: input dasar ¥13, output ¥68, cache hits ¥1.30, penulisan cache 5 menit ¥13, dan penulisan cache 1 jam ¥26. Terapkan tarif untuk setiap kategori penggunaan di seluruh panggilan model. |
| Sandbox cloud | Runtime; ditagih per detik | ¥0.072/jam untuk sandbox dengan 1 inti CPU dan 1 GB memori. Sepuluh menit biayanya ¥0.012. |
| Plugin | Per panggilan yang ditagih | Contoh: pencarian web ¥0.03/panggilan; pencarian gambar ¥0.045/panggilan. Plugin lain memiliki tarif masing-masing. Kalikan panggilan setiap plugin dengan harga yang tercantum. |
| Total biaya tugas | Per tugas yang selesai | Tambahkan biaya model, sandbox, dan plugin. Contoh PPT yang dikerjakan di bawah total ¥0.544 tanpa panggilan plugin berbayar, atau ¥0.724 dengan tiga pencarian web dan dua pencarian gambar pada asumsi yang sama. |
Tarif model adalah contoh penganggaran untuk kimi-k3.1-pro, bukan klaim bahwa setiap Agen PPT resmi menggunakan model itu. Periksa definisi model Agen yang dipilih sebelum menerapkan tarif ini. Tarif untuk model lain dan varian berkecepatan tinggi berbeda.
Cara menghitung token input dan output
Agen dapat memanggil modelnya beberapa kali saat membuat satu presentasi. Tambahkan penggunaan yang ditagih dari setiap panggilan, termasuk giliran lanjutan dan revisi. Input dapat termasuk prompt, teks PDF yang diekstrak, hasil tool, dan konteks percakapan; penggunaan output tidak terbatas pada kata-kata yang terlihat di slide.
Untuk caching K3, pisahkan input tanpa cache, penulisan cache, dan cache hits. Ini adalah kategori input yang berbeda: jangan menagih total input penuh pada tarif dasar lalu menambahkan biaya cache untuk token yang sama. Gunakan tarif penulisan 5 menit atau 1 jam yang berlaku. Panduan penagihan cache menjelaskan cara merekonsiliasi kategori ini dengan penggunaan yang dilaporkan.
Contoh perhitungan: presentasi tiga slide
Misalkan Agen Anda menggunakan kimi-k3.1-pro dan satu run lengkap presentasi tiga slide mengonsumsi 20.000 token input, 4.000 token output yang ditagih, dan 10 menit runtime cloud yang ditagih. Asumsikan tidak ada cache hits, tidak ada penulisan cache 1 jam, dan tidak ada panggilan plugin berbayar. Semua input adalah tanpa cache atau ditulis ke cache 5 menit default, keduanya dihargai ¥13/MTok. Ini adalah perkiraan kuantitas penggunaan untuk perencanaan, bukan pengukuran tutorial Northstar.
| Biaya | Perhitungan | Perkiraan biaya |
|---|---|---|
| Input model | 20,000 ÷ 1,000,000 × ¥13 | ¥0.260 |
| Output model | 4,000 ÷ 1,000,000 × ¥68 | ¥0.272 |
| Sandbox cloud | 10 ÷ 60 × ¥0.072 | ¥0.012 |
| Plugin berbayar | 0 panggilan yang ditagih | ¥0.000 |
| Total | ¥0.260 + ¥0.272 + ¥0.012 | ¥0.544 (sekitar ¥0.54) |
Tutorial dengan fakta yang disuplai meminta Agen untuk tidak menjelajah web. Jika nanti Anda memperluasnya menjadi presentasi riset dengan tiga pencarian web dan dua pencarian gambar, biaya plugin adalah 3 × ¥0.03 + 2 × ¥0.045 = ¥0.180. Dengan menahan kuantitas lainnya konstan, hasilnya ¥0.544 + ¥0.180 = ¥0.724. Riset juga dapat meningkatkan token model dan runtime, jadi gunakan kuantitas terukur untuk tagihan final.
Apa yang berubah saat Anda menggunakan banyak agen?
Delegasi dapat menambah panggilan model, konteks berulang, panggilan tool, dan pekerjaan revisi. Alur kerja multi-agen Kimi menempatkan koordinator dan thread child dalam satu sesi. Jumlah thread child saja bukan pengali untuk biaya sandbox. Jumlahkan penggunaan model dan plugin di seluruh thread, dan gunakan runtime yang benar-benar ditagih untuk sesi tersebut. Eksekusi lebih lama atau penambahan sesi cloud independen dapat meningkatkan biaya sandbox. FAQ menjelaskan bahwa waktu sandbox berhenti terakumulasi ketika semua thread selesai dan sesi menjadi idle.
Kurangi biaya per presentasi yang dapat digunakan
Mulailah dengan satu Agen dan deliverable kecil. Suplai bagian sumber yang relevan, batasi jumlah slide, dan aktifkan pencarian berbayar hanya saat tugas membutuhkannya. Sambungkan kembali event stream yang terputus alih-alih mengirim tugas yang sama lagi. Untuk alur kerja berulang, periksa cache hits dan jaga konteks yang dapat digunakan ulang tetap stabil. Bandingkan total biaya semua percobaan dengan jumlah presentasi yang benar-benar Anda terima; draf awal yang murah tetapi membutuhkan beberapa pengulangan mungkin lebih mahal secara keseluruhan.
Pemecahan Masalah Umum API
- Gagal autentikasi: periksa bahwa kunci API disetel di terminal yang mengirim permintaan dan milik akun yang dimaksud. Periksa error HTTP sebelum mengulang panggilan.
- curl menolak opsi, atau jq tidak ada: periksa utilitas yang terpasang. Contoh ini memerlukan versi curl yang mendukung
--fail-with-bodydan executable jq yang berfungsi di lingkungan Bash yang sama. - jq tidak dapat mengekstrak ID: buka JSON respons yang disimpan. Itu mungkin berisi error API alih-alih objek resource yang sukses. Perbaiki permintaan terlebih dahulu daripada meneruskan ID kosong ke endpoint berikutnya.
- Alur kerja custom-tool berhenti berkembang: periksa event tool yang tertunda. Alasan berhenti
requires_actionberarti klien perlu mengembalikan hasil tool atau menangani konfirmasi sebelum thread yang terkena dampak melanjutkan. - Slide yang diunduh berisi klaim yang tidak didukung: bandingkan dengan brief atau laporan yang disuplai. Revisi tugas dengan ketidaksesuaian spesifik dan periksa deliverable berikutnya sebelum menggunakannya.
Catat endpoint, status HTTP, ID sesi, dan event yang relevan saat mendiagnosis kegagalan. Jaga kunci API tetap keluar dari log diagnostik.
Kesimpulan
Mulailah dengan satu alur kerja Kimi Hosted Agents yang lengkap: pilih agen, siapkan environment, buat sesi, kirim tugas, dan periksa file yang dikirimkan. Setelah jalur tersebut berfungsi, tambahkan dokumen sumber lalu tool bisnis yang dibutuhkan aplikasi Anda. Jaga progres tetap terlihat dan nilai setiap run dari kegunaan outputnya, bukan hanya apakah permintaannya berhasil.
FAQ
Apakah saya perlu mengirim ulang tugas Kimi Hosted Agents setelah disconnect?
Tidak. Event stream yang terputus tidak memerlukan pengiriman tugas baru. Sambungkan kembali dengan nilai id: frame SSE terakhir di header Last-Event-ID untuk melanjutkan pembacaan. Nilai ini adalah kursor stream, bukan ID JSON objek event. Menyambungkan kembali menghindari pengiriman pekerjaan yang sama dua kali secara tidak sengaja.
Bagaimana jika output Kimi Hosted Agents tidak ada di artifak?
File sandbox dapat ada tanpa didaftarkan sebagai artifak. Periksa apakah agen menyelesaikan presentasi dan memanggil save_artifact. Jika pendaftaran hilang, gunakan API file sesi untuk memeriksa direktori output: GET /v1/sessions/{session_id}/filesystem?prefix=output. Listing mencakup satu direktori pada satu waktu; perbarui prefix untuk memeriksa subdirektori. Unduh file yang dipilih dengan GET /v1/sessions/{session_id}/filesystem/raw?path=output/northstar.pptx, mengganti path contoh dengan path tepat yang dikembalikan oleh listing. URL-encode nilai query jika path berisi spasi atau karakter terreservasi lainnya. Sertakan header otorisasi dan versi API yang sama seperti di tutorial.
Apakah memperbarui konfigurasi Kimi Hosted Agents akan mengubah sesi aktif?
Tidak. Sesi menggunakan versi agen yang difiksasi saat dibuat. Memperbarui agen membuat versi baru untuk sesi berikutnya sementara sesi yang ada mempertahankan konfigurasi aslinya. Untuk menguji instruksi atau tool yang direvisi, mulai sesi baru dan bandingkan outputnya dengan run sebelumnya.

