TL;DR
Kimi Hosted Agents voert meerstaps AI-taken uit met persistente sessies, toolexecutie en cloud-sandboxen. Deze gids brengt je van een Kimi API-sleutel naar een downloadbare presentatie van drie diaโs met Bash, curl en jq. Voltooi eerst รฉรฉn taak met een zelfstandige prompt. Voeg daarna een geรผpload document toe, koppel zakelijke tools en ga om met de fouten die ertoe doen in een uitgerolde applicatie.
Key Takeaways
- Kimi Hosted Agents verbindt een agentdefinitie, een execution environment en een sessie. Houd hun IDโs beschikbaar gedurende de hele workflow.
- Begin met een klein, verifieerbaar resultaat. Het eerste voorbeeld levert een presentatie op met fictieve data en een berekening die je kunt controleren.
- Gebruik de eventstream om de uitvoering te volgen en inspecteer vervolgens het geleverde bestand. Een succesvolle HTTP-respons alleen bewijst geen taaksucces.
- Breid het werkende voorbeeld uit met bestandsinvoer, custom tools of MCP-services. Elke integratie heeft eigen uitvoering- en inlogvereisten.
- Begroot gezamenlijk voor inference, sandbox-runtime en plugin-gebruik, inclusief heruitvoeringen die nodig zijn om een acceptabel resultaat te produceren.
What Is Kimi Hosted Agents?
Moonshot AI kondigde Kimi Hosted Agents aan op November 5, 2026, gepositioneerd als een dienst voor ondernemingen en ontwikkelaars die langlopende agents bouwen.
Het product gebruikt een Harness as a Service-benadering. Een โharnessโ is de software rond een model die beheert hoe werk vordert: status bijhouden, tools aanroepen, uitvoering beheren en herstellen na onderbrekingen.
Neem een wekelijks onderzoeksworkflow als voorbeeld. Tekst genereren is slechts รฉรฉn stap. De applicatie moet mogelijk ook bronnen ophalen, bestanden verwerken, grafieken maken, een presentatie opslaan en genoeg status bewaren om na een disconnect door te kunnen gaan.
Hosted Agents levert die operationele laag. Jouw team definieert nog steeds de zakelijke taak, selecteert integraties en bepaalt wat een acceptabel resultaat is.
Kimiโs officiรซle architectuur toont de applicatie, platformservices en uitvoeringkernen die door de gehoste runtime worden gebruikt.
Kernmogelijkheden voor je eerste integratie
- Persistente sessies houden de invoer, uitvoeringsevents en output van een taak bij elkaar.
- Cloud-sandboxen bieden de tools om bestanden te verwerken en deliverables te creรซren.
- Skills en plug-ins verpakken herbruikbare capaciteiten; custom tools en MCP-services koppelen je eigen systemen.
Je eerste controlepunt is een presentatie die je kunt openen en inspecteren. Gedetailleerde runtimespecificaties worden nuttig zodra je afhankelijkheden toevoegt of een bestaande workflow naar de sandbox verhuist; de sandboxreferentie documenteert de beschikbare omgeving.
What Do You Need Before Calling the Kimi Hosted Agents API?
- Een Kimi-platformaccount met toegang tot Hosted Agents en een API-sleutel.
- Bash, curl en jq op macOS, Linux of Windows met WSL.
- Twee terminals: Terminal A stuurt requests; Terminal B volgt uitvoeringsevents.
- Een presentatieviewer om de gegenereerde PPTX te openen.
Maak een Kimi-platformaccount en een API-sleutel aan in het API-beheer van de console. Gebruik รฉรฉn Bash-terminal, genaamd Terminal A, voor de set-up en taakcommandoโs. Houd deze open zodat latere stappen de variabelen kunnen hergebruiken. Installeer curl en jq voordat je verdergaat. De voorbeelden gebruiken de beta API-versie 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
De workflow volgt Kimiโs REST API-quickstart. Je gebruikt de officiรซle PPT-assistent om een korte, fictieve businessbrief te veranderen in een presentatie. Alle invoergegevens zitten in het request, dus voor de eerste run is geen bestandsupload of private dataverbinding nodig.
Voer elk blok op volgorde uit en controleer de output voordat je doorgaat. Met && gekoppelde commandoโs stoppen dat blok wanneer een request of validatie faalt. Los de gemelde fout op voordat je naar de volgende stap gaat; behoud dezelfde omgeving- en sessie-IDโs bij het opnieuw proberen van een bestaande set-up.
Step 1: Select the official PPT assistant
Haal de beschikbare agents op en bekijk hun namen en definities. Wanneer daarom wordt gevraagd, plak je de ID van de officiรซle PPT-assistent die is geconfigureerd met PPT-skills. Het laatste commando controleert of je selectie in de geretourneerde lijst bestaat en print de definitie.
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
Het laatste commando zou de definitie van de geselecteerde agent moeten printen. Als de assistent niet beschikbaar is in je project, gebruik dan de officiรซle PPT-agentconfiguratie om een equivalente agent voor te bereiden voordat je verdergaat.
Step 2: Create a cloud environment
Een Environment is een herbruikbare configuratie voor je uitvoering, inclusief geรฏnstalleerde packages, netwerktoegang en opstartcommandoโs. Hergebruik ervan geeft latere sessies dezelfde set-up; elke cloudsessie krijgt nog steeds zijn eigen sandbox en workspace. Zie de environment-gids voor configuratie-opties.
Maak de Environment รฉรฉn keer aan en bewaar de ID. Cloudimages worden asynchroon gebouwd, dus wacht tot de buildstatus ready is voordat je een sessie aanmaakt. Als de API meldt dat deze niet gereed is, wacht en probeer het opnieuw met dezelfde ENVIRONMENT_ID. Een andere Environment aanmaken voltooit de eerste build niet.
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
Een Session legt de Agent-versie en een beschikbare Environment-versie vast op het moment van aanmaken. Onderstaand request levert hun IDโs aan; het platform selecteert en bevriest de versies. Je kunt ook agent_version instellen om een exacte Agent-versie te kiezen. Het updaten van de Agent of Environment werkt een bestaande sessie niet bij, en een sessie kan niet van environment_id wisselen. Maak een nieuwe sessie om gewijzigde configuraties te gebruiken. Deze regels staan gedocumenteerd in session creation.
Bewaar de geretourneerde sessie-ID voor zowel de eventstream als taakrequests. Een nieuwe sessie start in idle; het sturen van user.message start de taak.
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
Open Terminal B. Voer dezelfde API-sleutel in en plak vervolgens de sessie-ID die in Terminal A is geprint. De server-sent eventstream toont uitvoeringupdates terwijl Terminal A de taak indient. Laat deze terminal verbonden totdat je het resultaat hebt geรฏnspecteerd.
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
Ga terug naar Terminal A en stuur een user.message-event. Het voorbeeld gebruikt fictieve cijfers en vraagt om een specifiek deliverable. De agent moet de aangeleverde feiten gebruiken en niet zoeken naar ondersteunende bedrijfsdata.
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
Kijk in Terminal B naar session.status-events. Wanneer de sessie terugkeert naar idle, inspecteer dan de stopreden: end_turn geeft aan dat de beurt is afgerond, terwijl requires_action betekent dat je client een toolresultaat moet leveren of een bevestiging moet afhandelen. Controleer ook session.error-events. Nadat de beurt is afgerond zonder onopgeloste fout, lijst je de artifacts op en selecteer je de gegenereerde 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'
Open northstar.pptx. Een succesvol resultaat heeft drie diaโs, identificeert de data als fictief en berekent wekelijkse activiteit als 90 รท 120 = 75%. Dit geeft je een concrete controle op zowel bestandslevering als inhoudsnauwkeurigheid voordat je echte bedrijfsdata koppelt.
How to Upload and Attach Files to a Kimi Hosted Agents Session?
Nadat de eerste presentatie werkt, plaats je een voorbeeldbestand report.pdf in de werkdirectory van Terminal A. De file-API scheidt het uploaden van een bestand van het koppelen aan een sessie. Voer dit blok uit met de bestaande sessie-ID nadat de eerste taak is voltooid.
Gebruik purpose=file-extract om tekst uit de PDF te extraheren. De file-API staat tot 100 MiB per bestand toe en hanteert standaard 10 GiB opslag per organisatie. Geรผploade bestanden kunnen niet in-place worden geรผpdatet; upload een aangepaste versie en koppel de nieuwe ID. Verwijder ongebruikte bestanden wanneer je opslag moet vrijmaken.
Met kimi-api-version: 2026-09-01-beta controleer je extract_status in de uploadrespons. Dit voorbeeld gaat alleen verder wanneer deze ready is. Als het error is, inspecteer dan de PDF-indeling en -inhoud en upload een gecorrigeerd bestand. De API kan een mislukte extractie als raw bestand koppelen, maar dat levert niet de geรซxtraheerde tekst die deze tutorial verwacht. Een ontbrekende of onverwachte status stopt het blok ook; inspecteer upload.json voordat je verdergaat.
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
Het koppelen van het bestand verzendt geen nieuwe taak. Houd Terminal B verbonden en dien een vervolgopdracht in die het document en de gewenste output benoemt.
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
Wanneer deze taak is afgerond, herhaal je de stap voor het ophalen van artifacts en selecteer je de nieuwe PPTX. Vergelijk de beweringen met de PDF, vooral cijfers, datums en voorgestelde acties.
How Do You Connect Tools to Kimi Hosted Agents?
Custom tools uitgevoerd door je applicatie
Voor een zakelijke actie zoals het opzoeken van de leveringsstatus van een project, gebruik je een custom tool die door je applicatie is geรฏmplementeerd. Het declareren van de tool maakt deze beschikbaar voor de agent; jouw code voert de bewerking uit.
- Declareer een
custom-item in detools-array van de agent met een naam, beschrijving en objectvormiginput_schema. - Handel
agent.custom_tool_useaf vanuit de eventstream en valideer de meegeleverde argumenten voordat je je functie uitvoert. - Post een
user.custom_tool_result-event naar de sessie, met gebruik van de JSON-idvan het aanroepende event alsdata.event_id.
Begin met een alleen-lezen lookup. Houd autorisatie en bescherming tegen dubbele acties in de applicatie wanneer een integratie bedrijfsrecords kan wijzigen.
MCP-services en grotere workflows
Voor een externe MCP-service declareer je de verbinding in mcp_servers. Sla toegangsgegevens op in een kluis en koppel die kluis bij het aanmaken van de sessie. Het platform ontdekt en roept de tools van de service aan; de serverdefinitie moet verbindingsdetails bevatten in plaats van secrets.
Optionele multi-agent-orkestratie
Het platform ondersteunt coรถrdinator-naar-child-delegatie. Een coรถrdinator kan begrensde taken toewijzen aan child-threads en hun resultaten combineren.
De delegatieconfiguratie accepteert 1โ20 agent-items. Dit is een configuratielimiet, geen bewijs van 20 gelijktijdige workers of een 20ร snelheidsverbetering. Child-threads kunnen geen extra laag child-threads aanmaken.
Een nuttig ontwerp kan bronverzameling, kwantitatieve analyse en redactionele review scheiden. Een korte samenvattingstaak kan doorgaans beter door รฉรฉn agent worden uitgevoerd.
How Should You Deploy a Kimi Hosted Agents Integration?
Plaats Kimi API-calls achter de backend van je applicatie. De browser kan een taak indienen en voortgang weergeven via je eigen endpoints, terwijl de backend de API-sleutel bewaart en elke gebruiker mappt op de sessies die hij mag benaderen. Sla de sessie-ID op bij het zakelijke verzoek zodat een paginavernieuwing dezelfde taak kan heropenen.
Hosted vs. Self-Hosted Execution
Gebruik een cloudomgeving voor de PPT-workflow in deze gids: deze ondersteunt save_artifact en de sessiebestandsworkflow. Kies een zelfgehoste omgeving wanneer de sandbox-uitvoering op een host moet draaien die jouw organisatie beheert. Kimi verzorgt nog steeds modelinference, orkestratie en sessiebeheer; toolinvoer en resultaten gaan via het platform. Dit is een hybride uitvoeringsmodel.
- Zelfgehoste omgevingen vereisen bedrijfsverificatie. Jij beheert de Worker-host, installeert afhankelijkheden en beheert isolatie en credentials. De Worker heeft uitgaande HTTPS-toegang tot het platform nodig.
- In zelfgehoste modus ontbreken momenteel
save_artifact, IPython en tools voor afbeeldingszoekopdrachten. Geรผploade bestanden, skills en geheugen worden niet op de Worker gemount en de outputbestanden verschijnen niet in de sessiebestandslijst. Plan hoe je input aanlevert en output ophaalt voordat je deze tutorial naar die modus verplaatst.
Begin voor een eerste integratie in de cloud. Overweeg zelfhosting wanneer controle over de uitvoeringshost de extra set-up en wijzigingen in bestandslevering rechtvaardigt.
Kiezen wie de runtime beheert
Gebruik Hosted Agents wanneer je wilt dat het platform sessie-uitvoering beheert. Als je team zijn eigen agentloop moet bouwen en beheren, biedt CometAPI uniforme model-API-toegang voor die custom stack. De Hosted Agents-voorbeelden in deze gids gebruiken Kimiโs eigen endpoints en credentials.
Kimi Hosted Agents Pricing and Cost Optimization
Kimi Hosted Agents rekent kosten voor modeltokens, cloud-sandboxruntime en betaalde plugin-calls. De onderstaande tabel toont hoe die kosten een presentatieworkflow beรฏnvloeden. Prijzen zijn in Chinese yuan (CNY), gecontroleerd op 10 november 2026 aan de hand van Hosted Agents-prijzen en modelinferenceprijzen. Eรฉn miljoen tokens staat gelijk aan 1 MTok.
| Kostcomponent | Facturatie-eenheid | Tarief en wat het betekent voor je taak |
|---|---|---|
| Modelinference | Per 1 MTok | Voor kimi-k3.1-pro: basisinvoer ยฅ13, uitvoer ยฅ68, cache-hits ยฅ1.30, 5-minuten cachewrites ยฅ13 en 1-uur cachewrites ยฅ26. Pas het tarief toe voor elke gebruikscategorie over alle modelcalls. |
| Cloud-sandbox | Runtime; per seconde | ยฅ0.072/uur voor een sandbox met 1 CPU-core en 1 GB geheugen. Tien minuten kost ยฅ0.012. |
| Plug-ins | Per factureerbare call | Voorbeelden: websearch ยฅ0.03/call; afbeeldingssearch ยฅ0.045/call. Andere plug-ins hebben eigen tarieven. Vermenigvuldig het aantal calls per plug-in met de vermelde prijs. |
| Totale taakkost | Per voltooide taak | Tel model-, sandbox- en plug-inkosten op. Het uitgewerkte PPT-voorbeeld hieronder komt uit op ยฅ0.544 zonder betaalde plug-ins, of ยฅ0.724 met drie websearches en twee afbeeldingssearches bij gelijke aannames. |
Het modeltarief is een begrotingsvoorbeeld voor kimi-k3.1-pro, niet de claim dat elke officiรซle PPT-agent dat model gebruikt. Controleer de modeldefinitie van de geselecteerde Agent voordat je deze tarieven toepast. Tarieven voor andere modellen en high-speedvarianten verschillen.
Hoe invoer- en uitvoertokens te tellen
Een Agent kan zijn model meerdere keren aanroepen tijdens het maken van รฉรฉn presentatie. Tel het gefactureerde gebruik van elke call op, inclusief vervolgbeurten en revisies. Invoer kan de prompt, geรซxtraheerde PDF-tekst, toolresultaten en conversatiecontext omvatten; uitvoergebruik is niet beperkt tot de woorden die op de diaโs zichtbaar zijn.
Voor K3-caching, scheid ongecachete invoer, cachewrites en cache-hits. Dit zijn afzonderlijke invoercategorieรซn: reken niet het volledige invoertotaal af tegen het basistarief en voeg daarna cachekosten toe voor dezelfde tokens. Gebruik het toepasselijke 5-minuten- of 1-uur-schrijftarief. De gids voor cachefacturatie legt uit hoe je deze categorieรซn afstemt op gerapporteerd gebruik.
Uitgewerkt voorbeeld: een presentatie met drie diaโs
Stel dat je Agent kimi-k3.1-pro gebruikt en een volledige run met drie diaโs 20.000 invoertokens, 4.000 gefactureerde uitvoertokens en 10 minuten factureerbare cloudruntime verbruikt. Ga uit van geen cache-hits, geen 1-uur cachewrites en geen betaalde plug-ins. Alle invoer is ongecached of geschreven naar de standaard 5-minuten-cache, beide geprijsd op ยฅ13/MTok. Dit zijn geschatte gebruikshoeveelheden voor planning, geen metingen van de Northstar-tutorial.
| Kost | Berekening | Geschatte kosten |
|---|---|---|
| Modelinvoer | 20,000 รท 1,000,000 ร ยฅ13 | ยฅ0.260 |
| Modeluitvoer | 4,000 รท 1,000,000 ร ยฅ68 | ยฅ0.272 |
| Cloud-sandbox | 10 รท 60 ร ยฅ0.072 | ยฅ0.012 |
| Betaalde plug-ins | 0 factureerbare calls | ยฅ0.000 |
| Totaal | ยฅ0.260 + ยฅ0.272 + ยฅ0.012 | ยฅ0.544 (ongeveer ยฅ0.54) |
De tutorial met aangeleverde feiten vraagt de Agent niet op het web te browsen. Als je dit later uitbreidt naar een researchpresentatie met drie websearches en twee afbeeldingssearches, dan is de plug-inkost 3 ร ยฅ0.03 + 2 ร ยฅ0.045 = ยฅ0.180. Bij gelijkblijvende overige hoeveelheden geeft dat ยฅ0.544 + ยฅ0.180 = ยฅ0.724. Research kan ook modeltokens en runtime verhogen, dus gebruik de gemeten hoeveelheden voor de uiteindelijke factuur.
Wat verandert er als je meerdere agents gebruikt?
Delegatie kan modelcalls, herhaalde context, toolcalls en revisiewerk toevoegen. Kimiโs multi-agent-workflow plaatst de coรถrdinator en child-threads in รฉรฉn sessie. Alleen het aantal child-threads is geen vermenigvuldiger voor sandboxkosten. Som model- en plug-ingebruik op over threads en gebruik de werkelijke factureerbare runtime van de sessie. Langere uitvoering of extra, onafhankelijke cloudsessies kunnen de sandboxkost verhogen. De FAQ legt uit dat sandboxtijd stopt wanneer alle threads klaar zijn en de sessie idle wordt.
Verlaag de kost per bruikbare presentatie
Begin met รฉรฉn Agent en een klein deliverable. Lever de relevante bronpassages aan, beperk het aantal diaโs en schakel betaalde zoekopdrachten alleen in als de taak ze nodig heeft. Verbind een onderbroken eventstream opnieuw in plaats van dezelfde taak opnieuw in te dienen. Inspecteer bij herhaalworkflows cache-hits en houd herbruikbare context stabiel. Vergelijk de totale kost van alle pogingen met het aantal presentaties dat je daadwerkelijk accepteert; een goedkope eerste versie die meerdere heruitvoeringen vereist, kan per saldo meer kosten.
Troubleshooting Common API Errors
- Authenticatie mislukt: controleer dat de API-sleutel is ingesteld in de terminal die het request verzendt en bij het bedoelde account hoort. Inspecteer de HTTP-fout voordat je de call herhaalt.
- curl wijst een optie af of jq ontbreekt: controleer de geรฏnstalleerde utilities. Deze voorbeelden vereisen een curl-versie met
--fail-with-body-ondersteuning en een werkende jq-binary in dezelfde Bash-omgeving. - jq kan geen ID extraheren: open de opgeslagen response-JSON. Deze kan een API-fout bevatten in plaats van een succesvol resourceobject. Repareer eerst het request in plaats van een lege ID door te geven aan het volgende endpoint.
- Een custom-toolworkflow vordert niet: inspecteer openstaande toolevents. Een stopreden
requires_actionbetekent dat de client een toolresultaat moet teruggeven of een bevestiging moet afhandelen voordat de betreffende thread doorgaat. - De gedownloade diaโs bevatten niet-ondersteunde claims: vergelijk deze met de aangeleverde brief of het rapport. Werk de taak bij met de specifieke afwijking en inspecteer de volgende deliverable voordat je die gebruikt.
Noteer het endpoint, de HTTP-status, de sessie-ID en het relevante event bij het diagnosticeren van een fout. Houd API-sleutels buiten diagnoselogboeken.
Conclusion
Begin met รฉรฉn complete Kimi Hosted Agents-workflow: selecteer een agent, bereid de omgeving voor, maak een sessie, dien een taak in en inspecteer het geleverde bestand. Voeg zodra dat pad werkt een brondocument toe en daarna de zakelijke tools die je applicatie nodig heeft. Houd voortgang zichtbaar en beoordeel elke run op de bruikbaarheid van de output, niet alleen op het slagen van het request.
FAQ
Do I need to resend a Kimi Hosted Agents task after a disconnect?
Nee. Een onderbroken eventstream vereist geen nieuwe taaksumbissie. Verbind opnieuw met de id:-waarde van het laatste SSE-frame in de Last-Event-ID header om het lezen te hervatten. Deze waarde is een streamcursor, niet de JSON-ID van het eventobject. Opnieuw verbinden voorkomt dat je per ongeluk hetzelfde werk twee keer indient.
What if a Kimi Hosted Agents output is missing from artifacts?
Een sandboxbestand kan bestaan zonder als artifact te zijn geregistreerd. Controleer of de agent de presentatie heeft voltooid en save_artifact heeft aangeroepen. Als registratie ontbreekt, gebruik dan de sessiebestands-APIโs om de outputdirectory te inspecteren: GET /v1/sessions/{session_id}/filesystem?prefix=output. De lijst toont รฉรฉn directory tegelijk; pas prefix aan om een subdirectory te inspecteren. Download het gekozen bestand met GET /v1/sessions/{session_id}/filesystem/raw?path=output/northstar.pptx, waarbij je het voorbeeldpad vervangt door het exacte pad uit de lijst. URL-encode de querywaarde als het pad spaties of andere gereserveerde tekens bevat. Voeg dezelfde autorisatie- en API-versieheaders toe als in de tutorial.
Will updating a Kimi Hosted Agents configuration change an active session?
Nee. Een sessie gebruikt de agentversie die bij aanmaak is vastgelegd. Het updaten van de agent creรซert een nieuwe versie voor volgende sessies, terwijl bestaande sessies hun oorspronkelijke configuratie behouden. Start een nieuwe sessie om gewijzigde instructies of tools te testen en vergelijk de output met de vorige run.

