TL;DR
Kimi Hosted Agents führt mehrstufige KI-Aufgaben mit persistenten Sitzungen, Toolausführung und Cloud-Sandboxes aus. Dieser Leitfaden führt Sie von einem Kimi-API-Schlüssel bis zu einer herunterladbaren Präsentation mit drei Folien – mit Bash, curl und jq. Führen Sie zunächst eine Aufgabe mit einem in sich geschlossenen Prompt aus. Fügen Sie anschließend ein hochgeladenes Dokument hinzu, binden Sie Geschäftstools an und behandeln Sie die Fehler, die in einer produktiven Anwendung relevant sind.
Wichtigste Erkenntnisse
- Kimi Hosted Agents verbindet eine Agent-Definition, eine Ausführungsumgebung und eine Sitzung. Halten Sie deren IDs während des gesamten Workflows griffbereit.
- Beginnen Sie mit einem kleinen, verifizierbaren Ergebnis. Das erste Beispiel erzeugt eine Präsentation mit fiktiven Daten und einer überprüfbaren Berechnung.
- Verwenden Sie den Event-Stream, um die Ausführung zu verfolgen, und prüfen Sie anschließend die gelieferte Datei. Eine erfolgreiche HTTP-Antwort allein belegt keinen erfolgreichen Abschluss der Aufgabe.
- Erweitern Sie das funktionierende Beispiel mit Dateieingaben, benutzerdefinierten Tools oder MCP-Services. Jede Integration hat eigene Ausführungs- und Anforderungsprofile für Zugangsdaten.
- Planen Sie Inferenz, Sandbox-Laufzeit und Plugin-Nutzung gemeinsam ein, einschließlich notwendiger Wiederholungen, um ein akzeptables Ergebnis zu erzielen.
Was sind Kimi Hosted Agents?
Moonshot AI hat Kimi Hosted Agents am 5. November 2026 angekündigt und als Service für Unternehmen und Entwickler positioniert, die langlaufende Agenten aufbauen.
Das Produkt nutzt einen Harness-as-a-Service-Ansatz. Ein Harness ist die Software um ein Modell herum, die den Arbeitsfortschritt steuert: Zustand beibehalten, Tools aufrufen, Ausführung verwalten und sich von Unterbrechungen erholen.
Betrachten Sie einen wöchentlichen Research-Workflow. Die Texterzeugung ist nur ein Schritt. Die Anwendung muss möglicherweise auch Quellen abrufen, Dateien verarbeiten, Diagramme erstellen, eine Präsentation speichern und genügend Zustand bewahren, um nach einer Trennung fortsetzen zu können.
Hosted Agents liefert diese operative Schicht. Ihr Team definiert weiterhin die geschäftliche Aufgabe, wählt Integrationen und legt fest, was ein akzeptables Ergebnis ist.
Kimis offizielle Architektur zeigt die Anwendung, Plattformdienste und den Ausführungskern, die die gehostete Laufzeit nutzt.
Zentrale Funktionen für Ihre erste Integration
- Persistente Sitzungen halten die Eingaben, Ausführungsereignisse und Ausgaben einer Aufgabe zusammen.
- Cloud-Sandboxes stellen die Tools bereit, die für die Verarbeitung von Dateien und das Erstellen von Ergebnissen benötigt werden.
- Skills und Plugins bündeln wiederverwendbare Fähigkeiten; benutzerdefinierte Tools und MCP-Services verbinden Ihre eigenen Systeme.
Ihr erster Kontrollpunkt ist eine Präsentation, die Sie öffnen und prüfen können. Detaillierte Laufzeitspezifikationen werden nützlich, wenn Sie Abhängigkeiten hinzufügen oder einen bestehenden Workflow in die Sandbox verlagern; die Sandbox-Referenz dokumentiert die verfügbare Umgebung.
Was benötigen Sie, bevor Sie die Kimi Hosted Agents API aufrufen?
- Ein Kimi-Plattformkonto mit Zugriff auf Hosted Agents und einen API-Schlüssel.
- Bash, curl und jq auf macOS, Linux oder Windows mit WSL.
- Zwei Terminals: Terminal A sendet Anfragen; Terminal B beobachtet Ausführungsereignisse.
- Ein Präsentationsprogramm zum Öffnen der erzeugten PPTX.
Erstellen Sie im Konsolenbereich für API-Verwaltung ein Kimi-Plattformkonto und einen API-Schlüssel. Verwenden Sie ein Bash-Terminal, genannt Terminal A, für die Einrichtung und Aufgabenbefehle. Halten Sie es geöffnet, damit spätere Schritte seine Variablen wiederverwenden können. Installieren Sie vorab curl und jq. Die Beispiele verwenden die Beta-API-Version 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"
Wie führen Sie Ihre erste Kimi Hosted Agents-Aufgabe aus
Der Workflow folgt Kimis REST-API-Quickstart. Sie verwenden den offiziellen PPT-Assistenten, um ein kurzes fiktives Business-Briefing in eine Präsentation zu verwandeln. Alle Eingabedaten sind in der Anfrage enthalten, daher sind für den ersten Lauf weder Datei-Uploads noch private Datenverbindungen nötig.
Führen Sie jeden Block der Reihe nach aus und prüfen Sie die Ausgabe, bevor Sie fortfahren. Mit && verknüpfte Befehle stoppen den Block, wenn eine Anfrage oder Validierung fehlschlägt. Beheben Sie den gemeldeten Fehler, bevor Sie mit dem nächsten Schritt fortfahren; verwenden Sie beim erneuten Versuch dieselben Umgebungs- und Sitzungs-IDs für eine bestehende Einrichtung.
Schritt 1: Wählen Sie den offiziellen PPT-Assistenten
Rufen Sie die verfügbaren Agenten ab und prüfen Sie ihre Namen und Definitionen. Wenn Sie dazu aufgefordert werden, fügen Sie die ID des offiziellen PPT-Assistenten mit konfigurierten PPT-Skills ein. Der letzte Befehl prüft, ob Ihre Auswahl in der zurückgegebenen Liste existiert, und gibt ihre Definition aus.
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
Der letzte Befehl sollte die Definition des ausgewählten Agenten ausgeben. Falls der Assistent in Ihrem Projekt nicht verfügbar ist, verwenden Sie die offizielle PPT-Agent-Konfiguration, um vor dem Fortfahren einen gleichwertigen Agenten vorzubereiten.
Schritt 2: Erstellen Sie eine Cloud-Umgebung
Eine Environment ist eine wiederverwendbare Konfiguration für Ihre Ausführungsumgebung, einschließlich installierter Pakete, Netzwerkzugriff und Startbefehle. Durch Wiederverwendung erhalten spätere Sitzungen dieselbe Einrichtung; jede Cloud-Sitzung erhält dennoch ihre eigene Sandbox und ihren eigenen Arbeitsbereich. Siehe den Environment-Leitfaden für Konfigurationsoptionen.
Erstellen Sie die Environment einmal und behalten Sie ihre ID. Cloud-Images werden asynchron aufgebaut, warten Sie also, bis ihr Build-Status ready ist, bevor Sie eine Sitzung erstellen. Wenn die API meldet, dass sie nicht bereit ist, warten Sie und versuchen Sie es mit derselben ENVIRONMENT_ID erneut. Das Erstellen einer weiteren Environment schließt den ersten Build nicht ab.
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"
Schritt 3: Erstellen Sie eine Sitzung
Eine Session fixiert die Agent-Version und eine verfügbare Environment-Version zum Zeitpunkt ihrer Erstellung. Die folgende Anfrage übergibt deren IDs; die Plattform wählt und friert die Versionen ein. Sie können auch agent_version setzen, um eine exakte Agent-Version auszuwählen. Ein späteres Aktualisieren von Agent oder Environment aktualisiert eine bestehende Sitzung nicht, und eine Sitzung kann ihre environment_id nicht wechseln. Erstellen Sie eine neue Sitzung, um überarbeitete Konfigurationen zu verwenden. Diese Regeln sind in der Sitzungserstellung dokumentiert.
Behalten Sie die zurückgegebene Sitzungs-ID sowohl für den Event-Stream als auch für Aufgabenanfragen. Eine neue Sitzung startet in idle; das Senden von user.message startet die Aufgabe.
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"
Schritt 4: Verfolgen Sie die Ausführung in einem zweiten Terminal
Öffnen Sie Terminal B. Geben Sie denselben API-Schlüssel ein und fügen Sie dann die in Terminal A ausgegebene Sitzungs-ID ein. Der Server-Sent-Event-Stream zeigt Ausführungsupdates an, während Terminal A die Aufgabe übermittelt. Lassen Sie dieses Terminal verbunden, bis Sie das Ergebnis geprüft haben.
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"
Schritt 5: Senden Sie eine in sich geschlossene Aufgabe
Kehren Sie zu Terminal A zurück und senden Sie ein user.message-Ereignis. Das Beispiel verwendet fiktive Zahlen und fordert ein konkretes Ergebnis an. Der Agent sollte die bereitgestellten Fakten verwenden und keine Geschäftsdaten suchen.
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
Schritt 6: Laden Sie die Präsentation herunter und prüfen Sie sie
Beobachten Sie in Terminal B session.status-Ereignisse. Wenn die Sitzung zu idle zurückkehrt, prüfen Sie den Stopgrund: end_turn bedeutet, dass der Zug beendet ist, während requires_action heißt, dass Ihr Client ein Toolergebnis liefern oder eine Bestätigung bearbeiten muss. Prüfen Sie auch session.error-Ereignisse. Nachdem der Zug ohne ungelösten Fehler beendet ist, listen Sie die Artefakte auf und wählen Sie die erzeugte 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'
Öffnen Sie northstar.pptx. Ein erfolgreiches Ergebnis hat drei Folien, kennzeichnet die Daten als fiktiv und berechnet die wöchentliche Aktivität mit 90 ÷ 120 = 75%. So erhalten Sie eine konkrete Prüfung sowohl der Dateizustellung als auch der Inhaltsgenauigkeit, bevor Sie echte Geschäftsdaten anbinden.
Wie laden Sie Dateien hoch und fügen sie einer Kimi Hosted Agents-Sitzung hinzu?
Nachdem die erste Präsentation funktioniert, legen Sie eine Beispiel-report.pdf im Arbeitsverzeichnis von Terminal A ab. Die File-API trennt das Hochladen einer Datei von der Verknüpfung mit einer Sitzung. Führen Sie diesen Block mit der bestehenden Sitzungs-ID aus, nachdem die erste Aufgabe beendet ist.
Verwenden Sie purpose=file-extract, um Text aus dem PDF zu extrahieren. Die File-API erlaubt bis zu 100 MiB pro Datei und standardmäßig 10 GiB Speicher pro Organisation. Hochgeladene Dateien können nicht inplace aktualisiert werden; laden Sie eine überarbeitete Datei hoch und binden Sie ihre neue ID. Entfernen Sie ungenutzte Dateien, wenn Sie Speicher freigeben müssen.
Mit kimi-api-version: 2026-09-01-beta prüfen Sie extract_status in der Upload-Antwort. Dieses Beispiel fährt nur fort, wenn dieser Wert ready ist. Bei error prüfen Sie das PDF-Format und den Inhalt und laden eine korrigierte Datei hoch. Die API kann eine fehlgeschlagene Extraktion als Rohdatei anhängen, liefert dann aber nicht den extrahierten Text, den dieses Tutorial erwartet. Ein fehlender oder unerwarteter Status stoppt den Block ebenfalls; prüfen Sie upload.json, bevor Sie fortfahren.
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
Das Anhängen der Datei sendet keine neue Aufgabe. Halten Sie Terminal B verbunden und übermitteln Sie eine Folgeanfrage, die das Dokument und das gewünschte Ergebnis benennt.
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
Wenn diese Aufgabe beendet ist, wiederholen Sie den Schritt zum Auflisten der Artefakte und wählen Sie die neue PPTX. Vergleichen Sie ihre Aussagen mit dem PDF, insbesondere Zahlen, Daten und vorgeschlagene Maßnahmen.
Wie verbinden Sie Tools mit Kimi Hosted Agents?
Benutzerdefinierte Tools, die von Ihrer Anwendung ausgeführt werden
Für eine geschäftliche Aktion, etwa das Nachschlagen des Lieferstatus eines Projekts, verwenden Sie ein benutzerdefiniertes Tool, das von Ihrer Anwendung implementiert wird. Das Deklarieren des Tools macht es für den Agenten verfügbar; Ihre Anwendung führt die Operation weiterhin aus.
- Deklarieren Sie einen
custom-Eintrag imtools-Array des Agenten mit Name, Beschreibung und objektförmigeminput_schema. - Behandeln Sie
agent.custom_tool_useaus dem Event-Stream und validieren Sie die übergebenen Argumente, bevor Sie Ihre Funktion ausführen. - Senden Sie ein
user.custom_tool_result-Ereignis an die Sitzung und verwenden Sie die JSON-iddes aufrufenden Ereignisses alsdata.event_id.
Beginnen Sie mit einer schreibgeschützten Abfrage. Behalten Sie Autorisierung und Schutz vor Doppelaktionen in der Anwendung, wenn eine Integration Geschäftsdatensätze ändern kann.
MCP-Services und größere Workflows
Für einen entfernten MCP-Service deklarieren Sie seine Verbindung in mcp_servers. Speichern Sie Zugangsdaten in einem Vault und binden Sie diesen beim Erstellen der Sitzung. Die Plattform entdeckt und ruft die Tools des Services auf; die Serverdefinition sollte Verbindungsdetails statt Geheimnisse enthalten.
Optionale Multi-Agent-Orchestrierung
Die Plattform unterstützt Delegation vom Koordinator an Kind-Threads. Ein Koordinator kann abgegrenzte Aufgaben an Kind-Threads vergeben und deren Ergebnisse kombinieren.
Seine Delegationskonfiguration akzeptiert 1–20 Agent-Einträge. Dies ist ein Konfigurationslimit, kein Beleg für 20 gleichzeitige Worker oder eine 20×-Geschwindigkeitssteigerung. Kind-Threads können keine weitere Ebene von Kind-Threads erstellen.
Ein sinnvolles Design könnte Quellensammlung, quantitative Analyse und redaktionelle Prüfung trennen. Eine kurze Zusammenfassungsaufgabe wird in der Regel besser von einem einzelnen Agenten erledigt.
Wie sollten Sie eine Kimi Hosted Agents-Integration bereitstellen?
Legen Sie Kimi-API-Aufrufe hinter Ihr Backend. Der Browser kann eine Aufgabe über Ihre eigenen Endpunkte übermitteln und Fortschritt anzeigen, während das Backend den API-Schlüssel verwahrt und jeden Nutzer den Sitzungen zuordnet, auf die er zugreifen darf. Speichern Sie die Sitzungs-ID bei der Geschäftsanforderung, damit eine Seitenaktualisierung dieselbe Aufgabe erneut öffnen kann.
Gehostete vs. selbstgehostete Ausführung
Verwenden Sie für den PPT-Workflow in diesem Leitfaden eine Cloud-Umgebung: Sie unterstützt save_artifact und den Sitzungsdatei-Workflow. Wählen Sie eine selbstgehostete Umgebung, wenn die Sandbox-Ausführung auf einem von Ihrer Organisation verwalteten Host laufen muss. Kimi betreibt weiterhin Modellinferenz, Orchestrierung und Sitzungsverwaltung; Tool-Eingaben und -Ergebnisse laufen über die Plattform. Dies ist ein hybrides Ausführungsmodell.
- Selbstgehostete Umgebungen erfordern Unternehmensverifizierung. Sie betreiben den Worker-Host, installieren dessen Abhängigkeiten und verwalten Isolation und Zugangsdaten. Der Worker benötigt ausgehenden HTTPS-Zugriff auf die Plattform.
- Der selbstgehostete Modus unterstützt derzeit
save_artifact, IPython und Bildersuche-Tools nicht. Hochgeladene Dateien, Skills und Speicher werden nicht im Worker eingehängt, und seine Ausgabedateien erscheinen nicht in der Sitzungsdateiliste. Planen Sie, wie Sie Eingaben bereitstellen und Ausgaben abrufen, bevor Sie dieses Tutorial in diesen Modus übertragen.
Beginnen Sie für die erste Integration in der Cloud. Erwägen Sie Self-Hosting, wenn die Kontrolle über den Ausführungshost den zusätzlichen Aufwand und die Änderungen bei der Dateizustellung rechtfertigt.
Auswahl, wer die Laufzeit betreibt
Verwenden Sie Hosted Agents, wenn die Plattform die Sitzungsausführung verwalten soll. Wenn Ihr Team seine eigene Agent-Schleife bauen und betreiben muss, stellt CometAPI einen einheitlichen Modell-API-Zugang bereit für diesen kundenspezifischen Stack. Die Hosted-Agents-Beispiele in diesem Leitfaden verwenden Kimis eigene Endpunkte und Zugangsdaten.
Kimi Hosted Agents – Preise und Kostenoptimierung
Kimi Hosted Agents berechnet Modell-Token, Cloud-Sandbox-Laufzeit und kostenpflichtige Plugin-Aufrufe. Die folgende Tabelle zeigt, wie sich diese Kosten auf einen Präsentations-Workflow auswirken. Preise in Chinesischen Yuan (CNY), geprüft am 10. November 2026 anhand der Hosted-Agents-Preise und der Modell-Inferenzpreise. Eine Million Tokens entspricht 1 MTok.
| Kostenkomponente | Abrechnungseinheit | Satz und Bedeutung für Ihre Aufgabe |
|---|---|---|
| Modellinferenz | Pro 1 MTok | Für kimi-k3.1-pro: Basiseingabe ¥13, Ausgabe ¥68, Cache-Treffer ¥1.30, 5-Minuten-Cache-Schreibvorgänge ¥13 und 1-Stunden-Cache-Schreibvorgänge ¥26. Wenden Sie den Satz für jede Nutzungskategorie auf alle Modellaufrufe an. |
| Cloud-Sandbox | Laufzeit; sekundengenau | ¥0.072/Stunde für eine Sandbox mit 1 CPU-Kern und 1 GB Arbeitsspeicher. Zehn Minuten kosten ¥0.012. |
| Plugins | Pro abrechenbarem Aufruf | Beispiele: Websuche ¥0.03/Aufruf; Bildersuche ¥0.045/Aufruf. Andere Plugins haben eigene Sätze. Multiplizieren Sie die Aufrufe jedes Plugins mit seinem ausgewiesenen Preis. |
| Gesamtkosten pro Aufgabe | Pro abgeschlossener Task | Addieren Sie Modell-, Sandbox- und Plugin-Gebühren. Das durchgerechnete PPT-Beispiel unten summiert sich auf ¥0.544 ohne kostenpflichtige Plugin-Aufrufe bzw. ¥0.724 mit drei Websuchen und zwei Bildersuchen bei gleicher angenommener Modellnutzung und Laufzeit. |
Der Modellsatz ist ein Budgetierungsbeispiel für kimi-k3.1-pro, nicht die Behauptung, dass jeder offizielle PPT-Agent dieses Modell verwendet. Prüfen Sie die Modelldefinition des ausgewählten Agenten, bevor Sie diese Sätze anwenden. Sätze für andere Modelle und Hochgeschwindigkeitsvarianten unterscheiden sich.
Wie Sie Eingabe- und Ausgabetokens zählen
Ein Agent kann sein Modell mehrfach aufrufen, um eine einzige Präsentation zu erstellen. Summieren Sie die abgerechnete Nutzung aus jedem Aufruf, einschließlich Folgeinteraktionen und Überarbeitungen. Eingaben können Prompt, extrahierten PDF-Text, Tool-Ergebnisse und Gesprächskontext umfassen; die Ausgabenutzung ist nicht auf die auf den Folien sichtbaren Wörter beschränkt.
Für K3-Caching trennen Sie nicht im Cache befindliche Eingaben, Cache-Schreibvorgänge und Cache-Treffer. Dies sind getrennte Eingangskategorien: Berechnen Sie nicht die gesamte Eingabe zum Basissatz und addieren dann für dieselben Tokens noch Cache-Gebühren. Verwenden Sie den passenden 5-Minuten- oder 1-Stunden-Schreibsatz. Der Cache-Abrechnungsleitfaden erklärt, wie diese Kategorien mit der gemeldeten Nutzung abgeglichen werden.
Durchgerechnetes Beispiel: eine Präsentation mit drei Folien
Angenommen, Ihr Agent verwendet kimi-k3.1-pro, und ein vollständiger Drei-Folien-PPT-Lauf verbraucht 20.000 Eingabe-Tokens, 4.000 abgerechnete Ausgabe-Tokens und 10 Minuten abrechenbare Cloud-Laufzeit. Nehmen Sie keine Cache-Treffer, keine 1-Stunden-Cache-Schreibvorgänge und keine kostenpflichtigen Plugin-Aufrufe an. Alle Eingaben sind entweder nicht gecached oder werden in den Standard-5-Minuten-Cache geschrieben, beides mit ¥13/MTok bepreist. Dies sind Schätzwerte zur Planung, keine Messwerte des Northstar-Tutorials.
| Gebühr | Berechnung | Geschätzte Kosten |
|---|---|---|
| Modelleingabe | 20,000 ÷ 1,000,000 × ¥13 | ¥0.260 |
| Modellausgabe | 4,000 ÷ 1,000,000 × ¥68 | ¥0.272 |
| Cloud-Sandbox | 10 ÷ 60 × ¥0.072 | ¥0.012 |
| Kostenpflichtige Plugins | 0 abrechenbare Aufrufe | ¥0.000 |
| Summe | ¥0.260 + ¥0.272 + ¥0.012 | ¥0.544 (rund ¥0.54) |
Das Tutorial mit gelieferten Fakten bittet den Agenten, nicht im Web zu browsen. Wenn Sie es später zu einer Research-Präsentation mit drei Websuchen und zwei Bildersuchen erweitern, wären die Plugin-Gebühren 3 × ¥0.03 + 2 × ¥0.045 = ¥0.180. Bei unveränderten anderen Mengen ergibt das ¥0.544 + ¥0.180 = ¥0.724. Research kann auch Modell-Tokens und Laufzeit erhöhen, daher verwenden Sie für die Endabrechnung die gemessenen Mengen.
Was ändert sich bei mehreren Agenten?
Delegation kann Modellaufrufe, wiederholten Kontext, Tool-Aufrufe und Überarbeitungsarbeit hinzufügen. Kimis Multi-Agent-Workflow platziert den Koordinator und die Kind-Threads in einer Sitzung. Die Anzahl der Kind-Threads allein ist kein Multiplikator für Sandbox-Kosten. Summieren Sie Modell- und Plugin-Nutzung über alle Threads und verwenden Sie die tatsächliche abrechenbare Laufzeit der Sitzung. Längere Ausführung oder zusätzliche unabhängige Cloud-Sitzungen können die Sandbox-Kosten erhöhen. Die FAQ erklärt, dass die Sandbox-Zeit nicht weiterläuft, wenn alle Threads beendet sind und die Sitzung in den Leerlauf geht.
Kosten pro nutzbarer Präsentation senken
Beginnen Sie mit einem Agenten und einem kleinen Ergebnis. Liefern Sie die relevanten Quellpassagen, begrenzen Sie die Folienanzahl und aktivieren Sie kostenpflichtige Suchen nur, wenn die Aufgabe sie benötigt. Stellen Sie eine getrennte Event-Stream-Verbindung wieder her, statt dieselbe Aufgabe erneut einzureichen. Prüfen Sie bei wiederkehrenden Workflows Cache-Treffer und halten Sie wiederverwendbaren Kontext stabil. Vergleichen Sie die Gesamtkosten aller Versuche mit der Zahl tatsächlich akzeptierter Präsentationen; ein billiger erster Entwurf, der mehrere Neuversuche benötigt, kann insgesamt teurer sein.
Fehlerbehebung bei häufigen API-Fehlern
- Authentifizierung schlägt fehl: Prüfen Sie, ob der API-Schlüssel im sendenden Terminal gesetzt ist und zum gewünschten Konto gehört. Prüfen Sie den HTTP-Fehler, bevor Sie den Aufruf wiederholen.
- curl lehnt eine Option ab oder jq fehlt: Prüfen Sie die installierten Tools. Diese Beispiele erfordern eine curl-Version mit
--fail-with-bodyund ein funktionierendes jq im selben Bash-Umfeld. - jq kann keine ID extrahieren: Öffnen Sie die gespeicherte Antwort-JSON. Sie könnte einen API-Fehler statt eines erfolgreichen Ressourcenobjekts enthalten. Beheben Sie zuerst die Anfrage, statt eine leere ID an den nächsten Endpunkt zu übergeben.
- Ein benutzerdefinierter-Tool-Workflow kommt nicht voran: Prüfen Sie ausstehende Tool-Ereignisse. Ein Stopgrund
requires_actionbedeutet, dass der Client ein Toolergebnis liefern oder eine Bestätigung verarbeiten muss, bevor der betroffene Thread fortfährt. - Die heruntergeladenen Folien enthalten nicht belegte Aussagen: Vergleichen Sie sie mit dem gelieferten Briefing oder Bericht. Überarbeiten Sie die Aufgabe mit der spezifischen Abweichung und prüfen Sie das nächste Ergebnis, bevor Sie es verwenden.
Protokollieren Sie Endpunkt, HTTP-Status, Sitzungs-ID und relevantes Ereignis bei der Fehlerdiagnose. Halten Sie API-Schlüssel aus Diagnoselogs heraus.
Fazit
Beginnen Sie mit einem vollständigen Kimi Hosted Agents-Workflow: Wählen Sie einen Agenten, bereiten Sie die Umgebung vor, erstellen Sie eine Sitzung, übermitteln Sie eine Aufgabe und prüfen Sie die gelieferte Datei. Wenn dieser Pfad funktioniert, fügen Sie ein Quelldokument und anschließend die Geschäftstools hinzu, die Ihre Anwendung benötigt. Halten Sie den Fortschritt sichtbar und bewerten Sie jeden Lauf anhand der Nützlichkeit des Ergebnisses, nicht nur daran, ob die Anfrage erfolgreich war.
FAQ
Muss ich eine Kimi Hosted Agents-Aufgabe nach einer Trennung erneut senden?
Nein. Ein unterbrochener Event-Stream erfordert keine erneute Aufgabenübermittlung. Stellen Sie die Verbindung mit dem id:-Wert des letzten SSE-Frames im Last-Event-ID-Header wieder her. Dieser Wert ist ein Stream-Cursor, nicht die JSON-ID des Ereignisobjekts. Durch Wiederverbinden vermeiden Sie, dieselbe Arbeit versehentlich doppelt einzureichen.
Was, wenn eine Kimi Hosted Agents-Ausgabe bei den Artefakten fehlt?
Eine Sandbox-Datei kann existieren, ohne als Artefakt registriert zu sein. Prüfen Sie, ob der Agent die Präsentation abgeschlossen und save_artifact aufgerufen hat. Fehlt die Registrierung, verwenden Sie die Sitzungsdatei-APIs, um das Ausgabeverzeichnis zu prüfen: GET /v1/sessions/{session_id}/filesystem?prefix=output. Das Listing umfasst jeweils ein Verzeichnis; aktualisieren Sie prefix, um ein Unterverzeichnis zu prüfen. Laden Sie die gewählte Datei mit GET /v1/sessions/{session_id}/filesystem/raw?path=output/northstar.pptx herunter und ersetzen Sie den Beispielpfad durch den exakten Pfad aus dem Listing. URL-kodieren Sie den Query-Wert, wenn der Pfad Leerzeichen oder andere reservierte Zeichen enthält. Fügen Sie dieselben Autorisierungs- und API-Versionsheader wie im Tutorial hinzu.
Führt das Aktualisieren einer Kimi Hosted Agents-Konfiguration zu Änderungen an einer aktiven Sitzung?
Nein. Eine Sitzung verwendet die bei Erstellung fixierte Agent-Version. Das Aktualisieren des Agenten erzeugt eine neue Version für nachfolgende Sitzungen, während bestehende Sitzungen ihre ursprüngliche Konfiguration behalten. Um überarbeitete Anweisungen oder Tools zu testen, starten Sie eine neue Sitzung und vergleichen Sie deren Ergebnis mit dem vorherigen Lauf.

