TL;DR
Kimi Hosted Agents, kalıcı oturumlar, araç yürütme ve bulut sandbox’larıyla çok adımlı yapay zekâ görevlerini çalıştırır. Bu kılavuz, Bash, curl ve jq kullanarak bir Kimi API anahtarından indirilebilir üç slaytlı bir sunuma kadar ilerlemenizi sağlar. Önce tüm verileri içinde olan bir istemle tek bir görevi tamamlayın. Ardından bir belge yükleyin, iş araçlarını bağlayın ve dağıtılmış bir uygulamada önemli olan hataları ele alın.
Önemli Noktalar
- Kimi Hosted Agents, bir ajan tanımını, yürütme ortamını ve bir oturumu birbirine bağlar. İş akışı boyunca bu kimlikleri elinizde bulundurun.
- Küçük, doğrulanabilir bir sonuçla başlayın. İlk örnek, kontrol edebileceğiniz bir hesaplama ve kurgusal verilerle bir sunum üretir.
- Yürütmeyi izlemek için olay akışını kullanın, sonra teslim edilen dosyayı inceleyin. Başarılı bir HTTP yanıtı tek başına görevin başarıyla tamamlandığını göstermez.
- Çalışan örneği dosya girdileri, özel araçlar veya MCP hizmetleriyle genişletin. Her entegrasyonun kendi yürütme ve kimlik bilgisi gereksinimleri vardır.
- Kabul edilebilir bir sonuç üretmek için gereken yeniden çalıştırmalar dahil, çıkarım, sandbox çalışma süresi ve eklenti kullanımını birlikte bütçelendirin.
Kimi Hosted Agents Nedir?
Moonshot AI, Kimi Hosted Agents’i 5 Kasım 2026 tarihinde duyurdu; uzun süreli ajanlar oluşturan işletmeler ve geliştiriciler için bir hizmet olarak konumlandırıldı.
Ürün, Harness as a Service yaklaşımını kullanır. Harness, bir modelin etrafındaki ve işin nasıl ilerlediğini yöneten yazılımdır: durumu korur, araçları çağırır, yürütmeyi yönetir ve kesintilerden kurtulur.
Haftalık bir araştırma iş akışını düşünün. Metin üretimi yalnızca bir adımdır. Uygulamanın ayrıca kaynakları getirmesi, dosyaları işlemesi, grafikler oluşturması, bir sunumu kaydetmesi ve kopuk bir bağlantıdan sonra devam edebilmek için yeterli durumu koruması gerekebilir.
Hosted Agents bu operasyonel katmanı sağlar. Ekibiniz hâlâ iş görevini tanımlar, entegrasyonları seçer ve kabul edilebilir sonucu belirler.
Kimi’nin resmi mimarisi, barındırılan çalışma zamanında kullanılan uygulama, platform hizmetleri ve yürütme çekirdeğini gösterir.
İlk entegrasyonunuz için temel yetenekler
- Kalıcı oturumlar, bir görevin girdilerini, yürütme olaylarını ve çıktıları birlikte tutar.
- Bulut sandbox’ları, dosyaları işlemek ve teslimatlar oluşturmak için gereken araçları sağlar.
- Yetenekler ve eklentiler tekrar kullanılabilir kabiliyetleri paketler; özel araçlar ve MCP hizmetleri kendi sistemlerinize bağlanır.
İlk kontrol noktanız, açıp inceleyebileceğiniz bir sunumdur. Ayrıntılı çalışma zamanı özellikleri, bağımlılık eklediğinizde veya mevcut bir iş akışını sandbox’a taşıdığınızda faydalı hâle gelir; sandbox referansı mevcut ortamı belgeler.
Kimi Hosted Agents API’sini çağırmadan önce neye ihtiyacınız var?
- Hosted Agents erişimi ve bir API anahtarı olan bir Kimi platform hesabı.
- macOS, Linux veya WSL’li Windows üzerinde Bash, curl ve jq.
- İki terminal: Terminal A istek gönderir; Terminal B yürütme olaylarını izler.
- Üretilen PPTX’i açmak için bir sunum görüntüleyici.
Kimi platform hesabı oluşturun ve API anahtarını konsolun API yönetimi alanında oluşturun. Kurulum ve görev komutları için Terminal A olarak adlandırılan bir Bash terminali kullanın. Daha sonraki adımların değişkenlerini yeniden kullanabilmesi için açık bırakın. Devam etmeden önce curl ve jq’yu yükleyin. Örnekler beta API sürümü olan 2026-09-01-beta’yı kullanır.
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"
İlk Kimi Hosted Agents görevinizi nasıl çalıştırırsınız
İş akışı, Kimi’nin REST API hızlı başlangıç kılavuzunu izler. Kısa bir kurgusal iş özetini sunuma dönüştürmek için resmi PPT asistanını kullanacaksınız. İlk çalıştırma, istekte tüm girdi verilerini içerdiğinden dosya yüklemeye veya özel veri bağlantısına gerek yoktur.
Her bloğu sırayla çalıştırın ve devam etmeden önce çıktısını kontrol edin. && ile birleştirilen komutlar, bir istek veya doğrulama başarısız olduğunda o bloğu durdurur. Bir sonraki adıma geçmeden önce bildirilen hatayı düzeltin; mevcut bir kurulumu yeniden denerken aynı ortam ve oturum kimliklerini koruyun.
Adım 1: Resmi PPT asistanını seçin
Mevcut ajanları alın ve adlarını ve tanımlarını inceleyin. İstendiğinde, PPT yetenekleriyle yapılandırılmış resmi PPT asistanının kimliğini yapıştırın. Son komut, seçiminizin döndürülen listede bulunduğunu kontrol eder ve tanımını yazdırır.
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
Son komut seçilen ajanın tanımını yazdırmalıdır. Asistan projenizde yoksa, devam etmeden önce resmi PPT ajan yapılandırmasını kullanarak eşdeğer bir ajan hazırlayın.
Adım 2: Bulut ortamı oluşturun
Ortam (Environment), yürütme kurulumunuz için yeniden kullanılabilir bir yapılandırmadır; kurulu paketler, ağ erişimi ve başlangıç komutlarını içerir. Yeniden kullanmak, sonraki oturumlara aynı kurulumu sağlar; her bulut oturumu yine kendi sandbox’ını ve çalışma alanını alır. Yapılandırma seçenekleri için ortam kılavuzuna bakın.
Ortamı bir kez oluşturun ve kimliğini saklayın. Bulut imajları eşzamansız oluşturulur, bu yüzden bir oturum oluşturmadan önce derleme durumunun ready olmasını bekleyin. API hazır olmadığını bildirirse, aynı ENVIRONMENT_ID ile bekleyin ve yeniden deneyin. Başka bir ortam oluşturmak ilk derlemeyi tamamlamaz.
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"
Adım 3: Bir oturum oluşturun
Bir Oturum, oluşturulduğunda Ajan sürümünü ve kullanılabilir bir Ortam sürümünü sabitler. Aşağıdaki istek bunların kimliklerini sağlar; platform sürümleri seçer ve sabitler. Tam bir Ajan sürümünü seçmek için agent_version ayarlayabilirsiniz. Ajan veya Ortam güncellendiğinde mevcut oturum güncellenmez ve bir oturum environment_id’sini değiştiremez. Revize edilmiş yapılandırmaları kullanmak için yeni bir oturum oluşturun. Bu kurallar oturum oluşturma bölümünde belgelenmiştir.
Olay akışı ve görev istekleri için döndürülen oturum kimliğini saklayın. Yeni bir oturum idle durumunda başlar; user.message göndermek görevi başlatır.
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"
Adım 4: İkinci bir terminalde yürütmeyi izleyin
Terminal B’yi açın. Aynı API anahtarını girin, ardından Terminal A’da yazdırılan oturum kimliğini yapıştırın. Sunucu gönderimli olay akışı, Terminal A görevi gönderirken yürütme güncellemelerini gösterir. Sonucu inceleyene kadar bu terminali bağlı tutun.
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"
Adım 5: Kendinden yeterli bir görev gönderin
Terminal A’ya dönün ve bir user.message olayı gönderin. Örnek, kurgusal rakamlar kullanır ve belirli bir teslimat ister. Ajan, destekleyici iş verilerini aramak yerine sağlanan gerçekleri kullanmalıdır.
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
Adım 6: Sunumu indirin ve inceleyin
Terminal B’de session.status olaylarını izleyin. Oturum idle durumuna döndüğünde durma nedenini inceleyin: end_turn, turun bittiğini belirtirken requires_action, istemcinizin bir araç sonucu sağlaması veya bir onayı işlemesi gerektiği anlamına gelir. session.error olaylarını da kontrol edin. Tur, çözümlenmemiş bir hata olmadan bittiğinde, artifaktları listeleyin ve oluşturulan PPTX’i seçin.
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'
northstar.pptx dosyasını açın. Başarılı bir sonuç üç slayta sahiptir, verileri kurgusal olarak tanımlar ve haftalık etkinliği 90 ÷ 120 = %75 olarak hesaplar. Bu, gerçek iş verilerine bağlanmadan önce hem dosya teslimini hem de içerik doğruluğunu somut olarak kontrol etmenizi sağlar.
Kimi Hosted Agents Oturumuna Dosyalar Nasıl Yüklenir ve Eklenir?
İlk sunum çalıştıktan sonra, Terminal A’nın çalışma dizinine bir örnek report.pdf yerleştirin. Dosya API’si, bir dosyayı yüklemeyi oturuma eklemeden ayırır. İlk görevin bitmesinden sonra mevcut oturum kimliğiyle bu bloğu çalıştırın.
PDF’den metin çıkarmak için purpose=file-extract kullanın. Dosya API’si dosya başına 100 MiB’a kadar izin verir ve kuruluş başına varsayılan olarak 10 GiB depolama sağlar. Yüklenen dosyalar yerinde güncellenemez; revize bir dosya yükleyin ve yeni kimliğini bağlayın. Depolamayı boşaltmanız gerektiğinde kullanılmayan dosyaları kaldırın.
kimi-api-version: 2026-09-01-beta ile yükleme yanıtındaki extract_status değerini kontrol edin. Bu örnek yalnızca ready olduğunda devam eder. error ise PDF biçimi ve içeriğini inceleyin, ardından düzeltilmiş bir dosya yükleyin. API, başarısız bir çıkarımı ham dosya olarak ekleyebilir, ancak bu dersin beklediği çıkarılmış metni sağlamaz. Eksik veya beklenmeyen bir durum değeri de bloğu durdurur; devam etmeden önce upload.json dosyasını inceleyin.
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
Dosyayı eklemek yeni bir görev göndermez. Terminal B’yi bağlı tutun ve belgenin adını ve istenen çıktıyı belirten bir takip isteği gönderin.
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
Bu görev bittiğinde, artifakt listeleme adımını tekrarlayın ve yeni PPTX’i seçin. Özellikle sayı, tarih ve önerilen eylemler açısından iddialarını PDF ile karşılaştırın.
Kimi Hosted Agents’e Araçlar Nasıl Bağlanır?
Uygulamanız tarafından yürütülen özel araçlar
Bir projenin teslimat durumunu sorgulamak gibi bir iş eylemi için, uygulamanız tarafından uygulanan bir özel aracı kullanın. Aracı bildirmek onu ajana kullanılabilir hâle getirir; işlemi yine kodunuz gerçekleştirir.
- Ajanın
toolsdizisinde, ad, açıklama ve nesne biçimliinput_schemaile bircustomgirişi bildirin. - Olay akışından
agent.custom_tool_useolayını ele alın ve işlevinizi çalıştırmadan önce sağlanan argümanları doğrulayın. - Çağıran olayın JSON
iddeğerinidata.event_idolarak kullanarak oturuma biruser.custom_tool_resultolayı gönderin.
Salt okunur bir sorgulamayla başlayın. Bir entegrasyon iş kayıtlarını değiştirebiliyorsa, yetkilendirme ve yinelenen eylem korumasını uygulamada tutun.
MCP hizmetleri ve daha büyük iş akışları
Uzak bir MCP hizmeti için, bağlantısını mcp_servers içinde bildirin. Erişim kimlik bilgilerini bir kasada saklayın ve oturum oluştururken o kasayı bağlayın. Platform, hizmetin araçlarını keşfeder ve çağırır; sunucu tanımı, gizli bilgiler yerine bağlantı ayrıntılarını içermelidir.
İsteğe bağlı çok ajanlı orkestrasyon
Platform, koordinatörden alt iş parçacıklarına delege etmeyi destekler. Koordinatör, sınırlı görevleri alt iş parçacıklarına atayabilir ve sonuçlarını birleştirebilir.
Delege yapılandırması, 1–20 ajan girdisi kabul eder. Bu bir yapılandırma sınırıdır; 20 eşzamanlı çalışan veya 20× hız artışı kanıtı değildir. Alt iş parçacıkları başka bir alt katman oluşturamaz.
Kullanışlı bir tasarım, kaynak toplama, nicel analiz ve editoryal incelemeyi ayırabilir. Kısa bir özetleme görevi genellikle tek bir ajanla daha iyi ele alınır.
Kimi Hosted Agents Entegrasyonu Nasıl Dağıtılmalı?
Kimi API çağrılarını uygulamanızın arka ucunun arkasına koyun. Tarayıcı, görevi gönderebilir ve ilerlemeyi kendi uç noktalarınız üzerinden görüntüleyebilirken, arka uç API anahtarını saklar ve her kullanıcıyı erişebileceği oturumlarla eşler. Oturum kimliğini iş isteğiyle birlikte saklayın; bir sayfa yeniden yüklendiğinde aynı görevi yeniden açabilsin.
Barındırılan vs. Kendin Barındır (Self-Hosted) Yürütme
Bu kılavuzdaki PPT iş akışı için bir bulut ortamı kullanın: save_artifact ve oturum dosya iş akışını destekler. Yürütmenin sandbox içinde kuruluşunuzun yönettiği bir ana bilgisayarda çalışması gerektiğinde kendin barındırılan bir ortam seçin. Kimi yine model çıkarımı, orkestrasyon ve oturum yönetimini çalıştırır; araç girdileri ve sonuçları platformu üzerinden geçer. Bu hibrit bir yürütme modelidir.
- Kendin barındırılan ortamlar kurumsal doğrulama gerektirir. Worker ana bilgisayarını işletir, bağımlılıklarını yüklersiniz ve izolasyon ile kimlik bilgilerini yönetirsiniz. Worker’ın platforma giden HTTPS çıkışı gerekir.
- Kendin barındırılan mod şu anda
save_artifact, IPython ve görsel arama araçlarını içermez. Yüklenen dosyalar, yetenekler ve bellek Worker’a bağlanmaz ve bunun çıktı dosyaları oturum dosya listesinde görünmez. Bu kılavuzu o moda taşımadan önce girdileri nasıl sağlayacağınızı ve çıktıları nasıl alacağınızı planlayın.
İlk entegrasyon için bulutla başlayın. Yürütme ana bilgisayarının kontrolü, ek kurulum ve dosya teslimindeki değişiklikleri haklı çıkarıyorsa kendiniz barındırmayı düşünün.
Çalışma zamanını kimin işlettiğini seçmek
Oturum yürütmesini platformun yönetmesini istediğinizde Hosted Agents’i kullanın. Ekibiniz kendi ajan döngüsünü oluşturup işletmeye ihtiyaç duyuyorsa, CometAPI bu özel yığın için birleşik model API erişimi sağlar. Bu kılavuzdaki Hosted Agents örnekleri Kimi’nin kendi uç noktalarını ve kimlik bilgilerini kullanır.
Kimi Hosted Agents Fiyatlandırma ve Maliyet Optimizasyonu
Kimi Hosted Agents, model token’ları, bulut sandbox çalışma süresi ve ücretli eklenti çağrıları için ücret alır. Aşağıdaki tablo, bu ücretlerin bir sunum iş akışını nasıl etkilediğini gösterir. Fiyatlar Çin yuanı (CNY) cinsindendir; Hosted Agents fiyatlandırması ve model çıkarım fiyatlandırması 10 Kasım 2026’da kontrol edilmiştir. Bir milyon token 1 MTok’a eşittir.
| Ücret bileşeni | Faturalama birimi | Oran ve göreviniz için ne anlama geldiği |
|---|---|---|
| Model çıkarımı | 1 MTok başına | kimi-k3.1-pro için: temel girdi ¥13, çıktı ¥68, önbellek isabetleri ¥1.30, 5 dakikalık önbellek yazımları ¥13 ve 1 saatlik önbellek yazımları ¥26. Her kullanım kategorisi için oranı tüm model çağrıları boyunca uygulayın. |
| Bulut sandbox | Çalışma süresi; saniye bazlı | 1 CPU çekirdeği ve 1 GB bellekli bir sandbox için ¥0.072/saat. On dakika ¥0.012 tutar. |
| Eklentiler | Faturalandırılabilir çağrı | Örnekler: web araması ¥0.03/çağrı; görsel araması ¥0.045/çağrı. Diğer eklentilerin kendi oranları vardır. Her eklentinin çağrılarını listelenen fiyatıyla çarpın. |
| Toplam görev | Tamamlanan görev başına | Model, sandbox ve eklenti ücretlerini toplayın. Aşağıdaki çalışılmış PPT örneği, ücretli eklenti çağrıları olmadan toplamda ¥0.544; aynı varsayılan model kullanımı ve çalışma süresinde üç web araması ve iki görsel aramasıyla ¥0.724 tutar. |
Model oranı, kimi-k3.1-pro için bütçeleme örneğidir; her resmi PPT Ajanının bu modeli kullandığı iddiası değildir. Bu oranları uygulamadan önce seçilen Ajanın model tanımını kontrol edin. Diğer modeller ve yüksek hızlı varyantlar için oranlar farklıdır.
Girdi ve çıktı token’ları nasıl sayılır
Bir Ajan, tek bir sunum oluştururken modelini birkaç kez çağırabilir. Takip turları ve revizyonlar dahil her çağrıdan faturalandırılan kullanımı ekleyin. Girdiler, istemi, çıkarılmış PDF metnini, araç sonuçlarını ve konuşma bağlamını içerebilir; çıktı kullanımı slaytlarda görünen kelimelerle sınırlı değildir.
K3 önbellekleme için, önbelleksiz girdi, önbellek yazımları ve önbellek isabetlerini ayırın. Bunlar ayrı girdi kategorileridir: aynı token’lar için tam girdi toplamını temel orandan faturalandırıp sonra önbellek ücretlerini eklemeyin. Uygun 5 dakikalık veya 1 saatlik yazım oranını kullanın. Önbellek faturalama kılavuzu, bu kategorileri bildirilen kullanımla nasıl uzlaştıracağınızı açıklar.
Çalışılmış örnek: üç slaytlı bir sunum
Ajanınızın kimi-k3.1-pro kullandığını ve tam bir üç slaytlı PPT çalıştırmasının 20.000 girdi token’ı, 4.000 faturalandırılan çıktı token’ı ve 10 dakika faturalandırılabilir bulut çalışma süresi tükettiğini varsayalım. Önbellek isabetleri, 1 saatlik önbellek yazımları ve ücretli eklenti çağrıları olmadığını varsayın. Tüm girdiler ya önbelleksizdir ya da varsayılan 5 dakikalık önbelleğe yazılmıştır; her ikisi de ¥13/MTok fiyatlıdır. Bunlar planlama için tahmini kullanım miktarlarıdır; Northstar dersinin ölçümleri değildir.
| Ücret | Hesaplama | Tahmini tutar |
|---|---|---|
| Model girdi | 20,000 ÷ 1,000,000 × ¥13 | ¥0.260 |
| Model çıktı | 4,000 ÷ 1,000,000 × ¥68 | ¥0.272 |
| Bulut sandbox | 10 ÷ 60 × ¥0.072 | ¥0.012 |
| Ücretli eklenti | 0 faturalandırılabilir çağrı | ¥0.000 |
| Toplam | ¥0.260 + ¥0.272 + ¥0.012 | ¥0.544 (yaklaşık ¥0.54) |
Sağlanan-gerçekler dersi, Ajandan web’de gezinmemesini ister. Daha sonra bunu üç web araması ve iki görsel aramasıyla bir araştırma sunumuna genişletirseniz, eklenti ücreti 3 × ¥0.03 + 2 × ¥0.045 = ¥0.180 olur. Diğer miktarları sabit tutmak ¥0.544 + ¥0.180 = ¥0.724 verir. Araştırma model token’larını ve çalışma süresini de artırabilir, bu yüzden nihai fatura için ölçülen miktarları kullanın.
Birden çok ajan kullandığınızda ne değişir?
Delege etme, model çağrılarını, yinelenen bağlamı, araç çağrılarını ve revizyon çalışmalarını artırabilir. Kimi’nin çok ajanlı iş akışı, koordinatör ve alt iş parçacıklarını tek bir oturumda yerleştirir. Alt iş parçacıklarının sayısı tek başına sandbox ücretleri için bir çarpan değildir. Tüm iş parçacıkları arasında model ve eklenti kullanımını toplayın ve oturumun gerçek faturalandırılabilir çalışma süresini kullanın. Daha uzun yürütme veya ek bağımsız bulut oturumları sandbox maliyetini artırabilir. SSS, tüm iş parçacıkları bittiğinde ve oturum boşta (idle) olduğunda sandbox süresinin artmayı bıraktığını açıklar.
Kullanılabilir sunum başına maliyeti azaltın
Tek bir Ajan ve küçük bir teslimatla başlayın. İlgili kaynak pasajlarını sağlayın, slayt sayısını sınırlayın ve ücretli aramaları yalnızca görev ihtiyaç duyduğunda etkinleştirin. Aynı görevi tekrar göndermek yerine düşen olay akışına yeniden bağlanın. Yinelenen iş akışları için önbellek isabetlerini inceleyin ve yeniden kullanılabilir bağlamı sabit tutun. Tüm denemelerin toplam maliyetini gerçekten kabul ettiğiniz sunumların sayısıyla karşılaştırın; birkaç yeniden çalıştırma gerektiren ucuz bir ilk taslak toplamda daha pahalı olabilir.
Yaygın API Hatalarını Giderme
- Kimlik doğrulama başarısız: isteği gönderen terminalde API anahtarının ayarlı olduğundan ve amaçlanan hesaba ait olduğundan emin olun. Çağrıyı tekrarlamadan önce HTTP hatasını inceleyin.
- curl bir seçeneği reddediyor veya jq eksik: kurulu yardımcı programları kontrol edin. Bu örnekler
--fail-with-body’yi destekleyen bir curl sürümü ve aynı Bash ortamında çalışan bir jq yürütülebilir dosyası gerektirir. - jq bir kimliği çıkaramıyor: kaydedilen yanıt JSON’unu açın. Başarılı bir kaynak nesnesi yerine bir API hatası içerebilir. Bir sonraki uç noktaya boş bir kimlik iletmek yerine önce isteği düzeltin.
- Özel araç iş akışı ilerlemeyi durdurdu: bekleyen araç olaylarını inceleyin.
requires_actiondurma nedeni, etkilenen iş parçacığı devam etmeden önce istemcinin bir araç sonucu döndürmesi veya bir onayı işlemesi gerektiği anlamına gelir. - İndirilen slaytlar desteklenmeyen iddialar içeriyor: bunları sağlanan özet veya raporla karşılaştırın. Belirli tutarsızlığa görevi revize edin ve kullanmadan önce bir sonraki teslimatı inceleyin.
Bir hatayı teşhis ederken uç noktayı, HTTP durumunu, oturum kimliğini ve ilgili olayı kaydedin. API anahtarlarını tanılama günlüklerinden uzak tutun.
Sonuç
Tek bir Kimi Hosted Agents iş akışıyla başlayın: bir ajan seçin, ortamını hazırlayın, bir oturum oluşturun, bir görev gönderin ve teslim edilen dosyayı inceleyin. Bu yol çalıştığında, bir kaynak belge ve ardından uygulamanızın ihtiyaç duyduğu iş araçlarını ekleyin. İlerlemeyi görünür tutun ve her çalışmayı yalnızca isteğin başarıyla yapılmasına göre değil, çıktısının kullanılabilirliğine göre değerlendirin.
SSS
Bir kopma sonrası Kimi Hosted Agents görevini yeniden göndermem gerekir mi?
Hayır. Bağlantısı kesilmiş bir olay akışı yeni bir görev gönderimi gerektirmez. Okumaya devam etmek için son SSE çerçevesinin id: değerini Last-Event-ID üstbilgisi ile kullanarak yeniden bağlanın. Bu değer bir akış imlecidir, olay nesnesinin JSON kimliği değildir. Yeniden bağlanmak, aynı işi yanlışlıkla iki kez göndermekten kaçınır.
Bir Kimi Hosted Agents çıktısı artifaktlarda yoksa ne olur?
Bir sandbox dosyası, bir artifakt olarak kaydedilmeden var olabilir. Ajanın sunumu tamamlayıp save_artifact çağırıp çağırmadığını kontrol edin. Kayıt eksikse, çıktı dizinini incelemek için oturum dosya API’lerini kullanın: GET /v1/sessions/{session_id}/filesystem?prefix=output. Listeleme tek bir dizini kapsar; bir alt dizini incelemek için prefix’i güncelleyin. Döndürülen tam yolu kullanarak seçilen dosyayı GET /v1/sessions/{session_id}/filesystem/raw?path=output/northstar.pptx ile indirin; örnek yolu listede dönen yolu birebir değiştirin. Yol boşluk veya diğer ayrılmış karakterler içeriyorsa sorgu değerini URL kodlayın. Derstekiyle aynı yetkilendirme ve API sürüm üstbilgilerini ekleyin.
Bir Kimi Hosted Agents yapılandırmasını güncellemek etkin bir oturumu değiştirir mi?
Hayır. Bir oturum, oluşturulmada sabitlenen ajan sürümünü kullanır. Ajana güncelleme yapmak, sonraki oturumlar için yeni bir sürüm oluştururken mevcut oturumlar orijinal yapılandırmalarını korur. Revize talimatları veya araçları test etmek için yeni bir oturum başlatın ve çıktısını önceki çalışmayla karşılaştırın.

