TL;DR
Kimi Hosted Agents uruchamia wieloetapowe zadania AI z trwałymi sesjami, wykonywaniem narzędzi i piaskownicami w chmurze. Ten przewodnik prowadzi od klucza API Kimi do możliwej do pobrania, trójslajdowej prezentacji przy użyciu Bash, curl i jq. Najpierw zrealizuj jedno zadanie z samowystarczalną podpowiedzią. Następnie dodaj przesłany dokument, podłącz narzędzia biznesowe i obsłuż te błędy, które mają znaczenie w wdrożonej aplikacji.
Key Takeaways
- Kimi Hosted Agents łączy definicję agenta, środowisko wykonawcze i sesję. Zachowaj ich identyfikatory przez cały przepływ pracy.
- Zacznij od małego, weryfikowalnego wyniku. Pierwszy przykład tworzy prezentację z fikcyjnymi danymi i obliczeniem, które możesz sprawdzić.
- Użyj strumienia zdarzeń, aby śledzić wykonanie, a następnie sprawdź dostarczony plik. Sam pomyślny wynik HTTP nie potwierdza sukcesu zadania.
- Rozszerz działający przykład o wejścia plikowe, własne narzędzia lub usługi MCP. Każda integracja ma własne wymagania dotyczące wykonania i poświadczeń.
- Planuj budżet łącznie na inferencję, czas działania piaskownicy i użycie wtyczek, uwzględniając ponowne uruchomienia potrzebne do uzyskania akceptowalnego wyniku.
What Is Kimi Hosted Agents?
Moonshot AI ogłosiło Kimi Hosted Agents 5 listopada 2026 r. (https://www.kimi.com/news/kimi-hosted-agents), pozycjonując je jako usługę dla przedsiębiorstw i deweloperów budujących długo działające agentowe rozwiązania.
Produkt stosuje podejście Harness as a Service. Harness to oprogramowanie wokół modelu, które zarządza przebiegiem pracy: utrzymuje stan, wywołuje narzędzia, zarządza wykonaniem i odzyskuje ciągłość po przerwach.
Rozważ cotygodniowy przepływ badań. Generowanie tekstu to tylko jeden krok. Aplikacja może też potrzebować pobrać źródła, przetworzyć pliki, utworzyć wykresy, zapisać prezentację i zachować wystarczająco dużo stanu, by kontynuować po rozłączeniu.
Hosted Agents dostarcza tę warstwę operacyjną. Twój zespół nadal definiuje zadanie biznesowe, wybiera integracje i decyduje, co stanowi akceptowalny wynik.
Oficjalna architektura Kimi (https://platform.kimi.com/docs/hosted-agents/overview) pokazuje aplikację, usługi platformy i rdzeń wykonawczy używane przez środowisko hostowane.
Core capabilities for your first integration
- Trwałe sesje łączą wejścia zadania, zdarzenia wykonania i wyjścia.
- Piaskownice w chmurze zapewniają narzędzia potrzebne do przetwarzania plików i tworzenia rezultatów.
- Umiejętności i wtyczki pakują wielokrotnego użytku możliwości; własne narzędzia i usługi MCP łączą twoje systemy.
Twoim pierwszym punktem kontrolnym jest prezentacja, którą możesz otworzyć i sprawdzić. Szczegółowe specyfikacje środowiska wykonawczego stają się przydatne, gdy dodasz zależności lub przeniesiesz istniejący przepływ do piaskownicy; dokumentacja środowiska znajduje się w sandbox reference (https://platform.kimi.com/docs/hosted-agents/sandbox-reference).
What Do You Need Before Calling the Kimi Hosted Agents API?
- Konto na platformie Kimi z dostępem do Hosted Agents i klucz API.
- Bash, curl i jq na macOS, Linux lub Windows z WSL.
- Dwa terminale: Terminal A wysyła żądania; Terminal B obserwuje zdarzenia wykonania.
- Przeglądarka prezentacji do otwarcia wygenerowanego PPTX.
Utwórz konto na platformie Kimi i klucz API w obszarze zarządzania API w konsoli. Użyj jednego terminala Bash, nazwanego Terminal A, do konfiguracji i poleceń zadań. Trzymaj go otwartego, aby późniejsze kroki mogły ponownie użyć jego zmiennych. Zainstaluj curl i jq przed kontynuacją. Przykłady używają beta wersji API 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"
How Do You Run Your First Kimi Hosted Agents Task
Przepływ pracy podąża za szybkim startem Kimi REST API (https://platform.kimi.com/docs/hosted-agents/quickstart). Użyjesz oficjalnego asystenta PPT, aby przekształcić krótki fikcyjny brief biznesowy w prezentację. Wszystkie dane wejściowe są zawarte w żądaniu, więc pierwszy przebieg nie wymaga przesyłania plików ani prywatnego połączenia danych.
Uruchamiaj każdy blok po kolei i sprawdzaj jego wynik przed kontynuacją. Polecenia połączone przez && zatrzymają blok, gdy żądanie lub walidacja się nie powiedzie. Rozwiąż zgłoszony błąd przed przejściem do następnego kroku; zachowaj te same identyfikatory środowiska i sesji podczas ponawiania istniejącej konfiguracji.
Step 1: Select the official PPT assistant
Pobierz dostępnych agentów i sprawdź ich nazwy oraz definicje. Gdy zostaniesz poproszony, wklej ID oficjalnego asystenta PPT skonfigurowanego z umiejętnościami PPT. Ostatnie polecenie sprawdza, czy twój wybór istnieje na zwróconej liście i drukuje jego definicję.
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
Ostatnie polecenie powinno wydrukować definicję wybranego agenta. Jeśli asystent nie jest dostępny w twoim projekcie, użyj oficjalnej konfiguracji agenta PPT (https://platform.kimi.com/docs/hosted-agents/official-ppt-agent), aby przygotować równoważnego agenta przed kontynuacją.
Step 2: Create a cloud environment
Środowisko (Environment) to wielokrotnego użytku konfiguracja twojego ustawienia wykonawczego, obejmująca zainstalowane pakiety, dostęp do sieci i polecenia startowe. Ponowne użycie daje późniejszym sesjom to samo ustawienie; każda sesja w chmurze nadal otrzymuje własną piaskownicę i przestrzeń roboczą. Zobacz przewodnik po środowiskach (https://platform.kimi.com/docs/hosted-agents/environments) po opcje konfiguracji.
Utwórz środowisko raz i zachowaj jego ID. Obrazy w chmurze budują się asynchronicznie, więc poczekaj, aż status budowy będzie ready, zanim utworzysz sesję. Jeśli API zgłosi, że nie jest gotowe, poczekaj i ponów próbę z tym samym ENVIRONMENT_ID. Utworzenie innego środowiska nie dokończy pierwszej budowy.
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"
Step 3: Create a session
Sesja utrwala wersję Agenta i dostępną wersję Środowiska w momencie jej utworzenia. Poniższe żądanie dostarcza ich ID; platforma wybiera i zamraża wersje. Możesz także ustawić agent_version, aby wybrać dokładną wersję Agenta. Aktualizacja Agenta lub Środowiska później nie aktualizuje istniejącej sesji, a sesja nie może zmienić swojego environment_id. Utwórz nową sesję, aby użyć zmienionych konfiguracji. Zasady te są udokumentowane w tworzeniu sesji (https://platform.kimi.com/docs/hosted-agents/sessions).
Zachowaj zwrócone ID sesji zarówno dla strumienia zdarzeń, jak i żądań zadań. Nowa sesja zaczyna w stanie idle; wysłanie user.message uruchamia zadanie.
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"
Step 4: Watch execution in a second terminal
Otwórz Terminal B. Wprowadź ten sam klucz API, a następnie wklej ID sesji wydrukowane w Terminalu A. Strumień zdarzeń wysyłanych przez serwer (https://platform.kimi.com/docs/hosted-agents/event-stream) wyświetla aktualizacje wykonania, gdy Terminal A przesyła zadanie. Pozostaw ten terminal połączony, aż sprawdzisz wynik.
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"
Step 5: Send a self-contained task
Wróć do Terminala A i wyślij zdarzenie user.message. Przykład używa fikcyjnych liczb i prosi o konkretny rezultat. Agent powinien użyć dostarczonych faktów zamiast wyszukiwać wspierające dane biznesowe.
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
Step 6: Download and inspect the presentation
Obserwuj session.status w Terminalu B. Gdy sesja wróci do idle, sprawdź powód zatrzymania: end_turn wskazuje, że tura się zakończyła, natomiast requires_action oznacza, że twój klient musi dostarczyć wynik narzędzia lub obsłużyć potwierdzenie. Sprawdź również session.error. Po zakończeniu tury bez nierozwiązanego błędu, wylistuj artefakty i wybierz wygenerowany PPTX.
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'
Otwórz northstar.pptx. Pomyślny wynik ma trzy slajdy, identyfikuje dane jako fikcyjne i oblicza aktywność tygodniową jako 90 ÷ 120 = 75%. Daje to konkretną weryfikację zarówno dostarczenia pliku, jak i poprawności treści przed podłączeniem rzeczywistych danych biznesowych.
How to Upload and Attach Files to a Kimi Hosted Agents Session?
Po działającej pierwszej prezentacji umieść przykładowy report.pdf w katalogu roboczym Terminala A. Interfejs plików (https://platform.kimi.com/docs/hosted-agents/files) rozdziela przesyłanie pliku od dołączania go do sesji. Uruchom ten blok z istniejącym ID sesji po zakończeniu pierwszego zadania.
Użyj purpose=file-extract, aby wyodrębnić tekst z PDF. Interfejs plików (https://platform.kimi.com/docs/hosted-agents/files) pozwala na pliki do 100 MiB i domyślnie 10 GiB przestrzeni na organizację. Przesłanych plików nie można aktualizować w miejscu; prześlij zmieniony plik i powiąż jego nowe ID. Usuń nieużywane pliki, gdy potrzebujesz zwolnić przestrzeń.
Z kimi-api-version: 2026-09-01-beta sprawdź extract_status w odpowiedzi na przesyłanie. Ten przykład przechodzi dalej tylko, gdy jest ready. Jeśli jest error, sprawdź format i zawartość PDF, a następnie prześlij poprawiony plik. API może dołączyć nieudane przetwarzanie jako surowy plik, ale nie dostarcza to wyodrębnionego tekstu, którego oczekuje ten samouczek. Brakujący lub nieoczekiwany status również zatrzymuje blok; sprawdź upload.json przed kontynuacją.
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
Dołączenie pliku nie wysyła nowego zadania. Pozostaw Terminal B podłączony i wyślij kontynuację, która nazywa dokument i pożądany wynik.
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
Gdy to zadanie się zakończy, powtórz krok listowania artefaktów i wybierz nowy PPTX. Porównaj jego twierdzenia z PDF, zwłaszcza liczby, daty i proponowane działania.
How Do You Connect Tools to Kimi Hosted Agents?
Custom tools executed by your application
Dla działania biznesowego, takiego jak sprawdzenie statusu dostawy projektu, użyj niestandardowego narzędzia (https://platform.kimi.com/docs/hosted-agents/tools) zaimplementowanego przez twoją aplikację. Zadeklarowanie narzędzia udostępnia je agentowi; twoje oprogramowanie nadal wykonuje operację.
- Zadeklaruj wpis
customw tablicytoolsagenta z nazwą, opisem i schematem wejściainput_schemaw formie obiektu. - Obsłuż
agent.custom_tool_useze strumienia zdarzeń i zweryfikuj dostarczone argumenty przed wykonaniem funkcji. - Wyślij do sesji zdarzenie
user.custom_tool_result, używając JSON-owegoidzdarzenia wywołującego jakodata.event_id.
Zacznij od odczytowego wyszukiwania. Zachowaj autoryzację i ochronę przed duplikacją działań w aplikacji, gdy integracja może modyfikować rekordy biznesowe.
MCP services and larger workflows
Dla zdalnej usługi MCP (https://platform.kimi.com/docs/hosted-agents/mcp) zadeklaruj jej połączenie w mcp_servers. Przechowuj poświadczenia dostępu w vault i powiąż ten vault podczas tworzenia sesji. Platforma wykrywa i wywołuje narzędzia serwisu; definicja serwera powinna zawierać szczegóły połączenia zamiast sekretów.
Optional multi-agent orchestration
Platforma obsługuje delegowanie koordynator–podrzędny (https://platform.kimi.com/docs/hosted-agents/multiagent-orchestration). Koordynator może przypisywać ograniczone zadania wątkom podrzędnym i łączyć ich wyniki.
Jego konfiguracja delegowania akceptuje 1–20 wpisów agenta. To limit konfiguracji, a nie dowód na 20 jednoczesnych pracowników lub 20× przyspieszenie. Wątki podrzędne nie mogą tworzyć kolejnej warstwy wątków podrzędnych.
Użyteczny projekt może rozdzielać zbieranie źródeł, analizę ilościową i przegląd redakcyjny. Krótkie zadanie podsumowania zwykle lepiej obsługuje jeden agent.
How Should You Deploy a Kimi Hosted Agents Integration?
Umieść wywołania API Kimi za backendem twojej aplikacji. Przeglądarka może przesłać zadanie i wyświetlać postęp przez twoje własne endpointy, podczas gdy backend przechowuje klucz API i mapuje każdego użytkownika do sesji, do których ma dostęp. Przechowuj ID sesji wraz z żądaniem biznesowym, aby odświeżenie strony mogło ponownie otworzyć to samo zadanie.
Hosted vs. Self-Hosted Execution
Użyj środowiska chmurowego dla przepływu PPT w tym przewodniku: obsługuje save_artifact i workflow plików sesji. Wybierz środowisko samodzielnie hostowane, gdy wykonanie w piaskownicy musi działać na hoście zarządzanym przez twoją organizację. Kimi nadal realizuje inferencję modelu, orkiestrację i zarządzanie sesjami; wejścia narzędzi i wyniki przechodzą przez jej platformę. To hybrydowy model wykonania.
- Środowiska samodzielnie hostowane wymagają weryfikacji przedsiębiorstwa. Zarządzasz hostem Worker, instalujesz jego zależności i zarządzasz izolacją oraz poświadczeniami. Worker potrzebuje wychodzącego dostępu HTTPS do platformy.
- Tryb samodzielnie hostowany obecnie nie oferuje
save_artifact, narzędzi IPython i wyszukiwania obrazów. Przesłane pliki, umiejętności i pamięć nie są montowane na Worker, a jego pliki wyjściowe nie pojawiają się na liście plików sesji. Zaplanuj sposób dostarczania wejść i pobierania wyjść przed przeniesieniem tego samouczka do tego trybu.
Na pierwszą integrację zacznij w chmurze. Rozważ samodzielne hostowanie, gdy kontrola nad hostem wykonawczym uzasadnia dodatkową konfigurację i zmiany w dostarczaniu plików.
Choosing who operates the runtime
Użyj Hosted Agents, gdy chcesz, aby platforma zarządzała wykonaniem sesji. Jeśli twój zespół potrzebuje zbudować i obsługiwać własną pętlę agenta, CometAPI zapewnia jednolity dostęp do API modeli (https://www.cometapi.com/about/) dla tego niestandardowego stosu. Przykłady Hosted Agents w tym przewodniku używają własnych endpointów i poświadczeń Kimi.
Kimi Hosted Agents Pricing and Cost Optimization
Kimi Hosted Agents nalicza opłaty za tokeny modelu, czas działania piaskownicy w chmurze i płatne wywołania wtyczek. Poniższa tabela pokazuje, jak te opłaty wpływają na workflow tworzenia prezentacji. Ceny w juanach chińskich (CNY), sprawdzone 10 listopada 2026 r. względem cennika Hosted Agents (https://platform.kimi.com/docs/pricing/hosted-agents) i cennika inferencji modeli (https://platform.kimi.com/docs/pricing/chat). Jeden milion tokenów to 1 MTok.
| Składnik kosztu | Jednostka rozliczeniowa | Stawka i co oznacza dla twojego zadania |
|---|---|---|
| Inferencja modelu | Za 1 MTok | Dla kimi-k3.1-pro: wejście bazowe ¥13, wyjście ¥68, trafienia z cache ¥1.30, zapisy do cache 5-minutowej ¥13 i 1-godzinnej ¥26. Zastosuj stawkę dla każdej kategorii użycia w ramach wszystkich wywołań modelu. |
| Piaskownica w chmurze | Czas działania; za sekundę | ¥0.072/godzinę dla piaskownicy z 1 rdzeniem CPU i 1 GB pamięci. Dziesięć minut kosztuje ¥0.012. |
| Wtyczki | Za rozliczalne wywołanie | Przykłady: wyszukiwanie w sieci ¥0.03/wywołanie; wyszukiwanie obrazów ¥0.045/wywołanie. Inne wtyczki mają własne stawki. Pomnóż liczbę wywołań każdej wtyczki przez jej cenę. |
| Całkowity koszt zadania | Za ukończone zadanie | Dodaj opłaty za model, piaskownicę i wtyczki. Poniższy przykład PPT daje razem ¥0.544 bez płatnych wtyczek lub ¥0.724 przy trzech wyszukiwaniach web i dwóch wyszukiwaniach obrazów przy tym samym użyciu modelu i czasie. |
Stawka modelu to przykład budżetowania dla kimi-k3.1-pro, a nie twierdzenie, że każdy oficjalny Agent PPT używa tego modelu. Sprawdź definicję modelu wybranego Agenta przed zastosowaniem tych stawek. Stawki dla innych modeli i wariantów wysokiej szybkości różnią się.
How to count input and output tokens
Agent może wywołać swój model kilka razy podczas tworzenia jednej prezentacji. Zsumuj rozliczone użycie ze wszystkich wywołań, w tym z kolejnych tur i poprawek. Wejście może obejmować prompt, wyodrębniony tekst PDF, wyniki narzędzi i kontekst konwersacji; użycie wyjścia nie ogranicza się do słów widocznych na slajdach.
Dla buforowania K3 rozdziel tokeny niebuforowane, zapisy do cache i trafienia z cache. To odrębne kategorie wejścia: nie naliczaj pełnej sumy wejścia po stawce bazowej, a następnie nie dodawaj opłat za cache dla tych samych tokenów. Użyj odpowiedniej stawki zapisu 5-minutowego lub 1-godzinnego. Przewodnik rozliczania cache (https://platform.kimi.com/docs/guide/context-caching) wyjaśnia, jak pogodzić te kategorie z raportowanym użyciem.
Worked example: a three-slide presentation
Załóżmy, że twój Agent używa kimi-k3.1-pro, a pełny przebieg trzy-slajdowej prezentacji zużywa 20 000 tokenów wejściowych, 4 000 rozliczanych tokenów wyjściowych i 10 minut rozliczanego czasu działania w chmurze. Załóż brak trafień z cache, brak zapisów do cache 1-godzinnej i brak płatnych wywołań wtyczek. Całe wejście jest albo niebuforowane, albo zapisywane do domyślnej 5-minutowej pamięci podręcznej, obie w cenie ¥13/MTok. To szacunkowe wielkości do planowania, a nie pomiary dla samouczka Northstar.
| Opłata | Obliczenie | Szacunkowy koszt |
|---|---|---|
| Wejście modelu | 20,000 ÷ 1,000,000 × ¥13 | ¥0.260 |
| Wyjście modelu | 4,000 ÷ 1,000,000 × ¥68 | ¥0.272 |
| Piaskownica w chmurze | 10 ÷ 60 × ¥0.072 | ¥0.012 |
| Płatne wtyczki | 0 rozliczalnych wywołań | ¥0.000 |
| Razem | ¥0.260 + ¥0.272 + ¥0.012 | ¥0.544 (około ¥0.54) |
Samouczek z dostarczonymi faktami prosi Agenta, by nie przeglądał sieci. Jeśli później rozszerzysz go do prezentacji badawczej z trzema wyszukiwaniami w sieci i dwoma wyszukiwaniami obrazów, opłata za wtyczki wyniesie 3 × ¥0.03 + 2 × ¥0.045 = ¥0.180. Przy pozostałych wielkościach stałych daje to ¥0.544 + ¥0.180 = ¥0.724. Badania mogą również zwiększyć liczbę tokenów modelu i czas działania, więc do końcowego rachunku użyj zmierzonych wielkości.
What changes when you use multiple agents?
Delegowanie może dodać wywołania modelu, powtórzony kontekst, wywołania narzędzi i prace redakcyjne. Wieloagentowy przepływ pracy Kimi (https://platform.kimi.com/docs/hosted-agents/multiagent-orchestration) umieszcza koordynatora i wątki podrzędne w jednej sesji. Sama liczba wątków podrzędnych nie jest mnożnikiem dla kosztów piaskownicy. Zsumuj użycie modelu i wtyczek we wszystkich wątkach i użyj rzeczywistego rozliczanego czasu działania sesji. Dłuższe wykonanie lub dodatkowe niezależne sesje chmurowe mogą zwiększyć koszt piaskownicy. FAQ (https://platform.kimi.com/docs/hosted-agents/faq) wyjaśnia, że czas piaskownicy przestaje się naliczać, gdy wszystkie wątki kończą, a sesja przechodzi w stan idle.
Reduce cost per usable presentation
Zacznij od jednego Agenta i małego rezultatu. Dostarcz istotne fragmenty źródeł, ogranicz liczbę slajdów i włącz płatne wyszukiwania tylko wtedy, gdy są potrzebne. Ponownie połącz rozłączony strumień zdarzeń zamiast przesyłać to samo zadanie ponownie. Dla powtarzalnych przepływów sprawdź trafienia z cache i utrzymuj stabilny, ponownie używalny kontekst. Porównaj łączny koszt wszystkich prób z liczbą prezentacji, które faktycznie akceptujesz; tani pierwszy szkic, który wymaga kilku powtórzeń, może kosztować więcej łącznie.
Troubleshooting Common API Errors
- Błąd uwierzytelniania: sprawdź, czy klucz API jest ustawiony w terminalu wysyłającym żądanie i należy do zamierzonego konta. Sprawdź błąd HTTP przed powtórzeniem wywołania.
- curl odrzuca opcję lub brakuje jq: sprawdź zainstalowane narzędzia. Te przykłady wymagają wersji curl obsługującej
--fail-with-bodyi działającego jq w tym samym środowisku Bash. - jq nie może wyodrębnić ID: otwórz zapisane JSON z odpowiedzią. Może zawierać błąd API zamiast poprawnego obiektu zasobu. Najpierw napraw żądanie, zamiast przekazywać puste ID do kolejnego endpointu.
- Workflow z niestandardowym narzędziem nie postępuje: sprawdź oczekujące zdarzenia narzędzi. Powód zatrzymania
requires_actionoznacza, że klient musi zwrócić wynik narzędzia lub obsłużyć potwierdzenie, zanim dany wątek będzie kontynuował. - Pobrane slajdy zawierają niepoparte twierdzenia: porównaj je z dostarczonym briefem lub raportem. Zmodyfikuj zadanie z konkretną rozbieżnością i sprawdź kolejny rezultat przed użyciem.
Zapisuj endpoint, status HTTP, ID sesji i istotne zdarzenie podczas diagnozowania awarii. Nie umieszczaj kluczy API w logach diagnostycznych.
Conclusion
Zacznij od jednego kompletnego workflow Kimi Hosted Agents: wybierz agenta, przygotuj jego środowisko, utwórz sesję, prześlij zadanie i sprawdź dostarczony plik. Gdy ta ścieżka działa, dodaj dokument źródłowy, a następnie narzędzia biznesowe potrzebne twojej aplikacji. Utrzymuj widoczność postępu i oceniaj każdy przebieg przez pryzmat użyteczności wyniku, a nie tylko sukcesu żądania.
FAQ
Do I need to resend a Kimi Hosted Agents task after a disconnect?
Nie. Rozłączony strumień zdarzeń nie wymaga ponownego przesłania zadania. Połącz się ponownie, używając wartości id: z ostatniej ramki SSE w nagłówku Last-Event-ID (https://platform.kimi.com/docs/hosted-agents/event-stream), aby wznowić odczyt. Ta wartość to kursor strumienia, a nie JSON-owe ID obiektu zdarzenia. Ponowne połączenie zapobiega przypadkowemu przesłaniu tej samej pracy dwa razy.
What if a Kimi Hosted Agents output is missing from artifacts?
Plik w piaskownicy może istnieć bez zarejestrowania go jako artefaktu. Sprawdź, czy agent ukończył prezentację i wywołał save_artifact. Jeśli rejestracja jest brakująca, użyj interfejsów plików sesji (https://platform.kimi.com/docs/hosted-agents/files), aby sprawdzić katalog wyjściowy: GET /v1/sessions/{session_id}/filesystem?prefix=output. Lista obejmuje jeden katalog naraz; zaktualizuj prefix, aby sprawdzić podkatalog. Pobierz wybrany plik poleceniem GET /v1/sessions/{session_id}/filesystem/raw?path=output/northstar.pptx, zastępując przykładową ścieżkę dokładną ścieżką zwróconą przez listowanie. Zakoduj wartość zapytania jako URL, jeśli ścieżka zawiera spacje lub inne zarezerwowane znaki. Dołącz te same nagłówki autoryzacji i wersji API co w samouczku.
Will updating a Kimi Hosted Agents configuration change an active session?
Nie. Sesja używa wersji agenta utrwalonej przy tworzeniu (https://platform.kimi.com/docs/hosted-agents/agents). Aktualizacja agenta tworzy nową wersję dla kolejnych sesji, podczas gdy istniejące sesje zachowują pierwotną konfigurację. Aby przetestować zmienione instrukcje lub narzędzia, rozpocznij nową sesję i porównaj jej wynik z poprzednim przebiegiem.

