TL;DR
Kimi Hosted Agents は、永続セッション、ツール実行、クラウドサンドボックスを備えた多段 AI タスクを実行します。本ガイドは、Bash、curl、jq を用いて、Kimi の API キー取得からダウンロード可能な3枚のスライドのプレゼン作成までを案内します。まず自己完結型のプロンプトで1つのタスクを完了します。次に、アップロードしたドキュメントを追加し、業務ツールを接続し、デプロイ済みアプリケーションで重要となる失敗を適切に扱います。
Key Takeaways
- Kimi Hosted Agents は、エージェント定義、実行環境、セッションを接続します。ワークフロー全体でそれぞれの ID を保持してください。
- 小さく検証可能な成果から始めましょう。最初の例は、架空データと検算可能な計算を含むプレゼンを生成します。
- イベントストリームで実行を追跡し、その後配信ファイルを確認します。HTTP レスポンスが成功でも、それだけではタスクの成功を保証しません。
- 動作する例をファイル入力、カスタムツール、または MCP サービスで拡張します。各統合には独自の実行要件と認証要件があります。
- 推論、サンドボックスのランタイム、プラグイン使用を合わせて予算化し、受け入れ可能な結果に必要な再実行も含めて計画します。
What Is Kimi Hosted Agents?
Moonshot AI は November 5, 2026 に Kimi Hosted Agents を発表し、長時間稼働のエージェントを構築する企業や開発者向けのサービスとして位置付けています。
このプロダクトは Harness as a Service アプローチを採用しています。ハーネスとは、モデルの周辺で作業の進行を管理するソフトウェアであり、状態維持、ツール呼び出し、実行管理、中断からの復旧を行います。
週間のリサーチワークフローを考えてみましょう。テキスト生成は1ステップに過ぎません。アプリケーションは、ソースの取得、ファイル処理、チャート作成、プレゼン保存、切断後に再開できるだけの状態保持も必要かもしれません。
Hosted Agents はその運用レイヤーを提供します。チームは依然として業務タスクを定義し、統合を選び、許容可能な成果の基準を決めます。
Kimi の公式アーキテクチャは、ホストされたランタイムで使用されるアプリケーション、プラットフォームサービス、実行コアを示しています。
初回統合に向けた中核機能
- 永続セッションは、タスクの入力、実行イベント、出力を一体として保持します。
- クラウドサンドボックスは、ファイルを処理し成果物を作成するためのツールを提供します。
- Skills とプラグインは再利用可能な機能をパッケージ化します。カスタムツールや MCP サービスで自社システムに接続できます。
最初のチェックポイントは、開いて確認できるプレゼンです。依存関係を追加したり既存のワークフローをサンドボックスへ移す際には詳細なランタイム仕様が有用になります。利用可能な環境は sandbox reference に文書化されています。
What Do You Need Before Calling the Kimi Hosted Agents API?
- Hosted Agents にアクセスできる Kimi プラットフォームアカウントと API キー
- macOS、Linux、または WSL を備えた Windows 上の Bash、curl、jq
- 2つのターミナル:ターミナル A はリクエスト送信用、ターミナル B は実行イベント監視用
- 生成された PPTX を開くためのプレゼンビューア
Kimi プラットフォームアカウントを作成し、コンソールの API 管理エリアで API キーを作成します。セットアップとタスク用のコマンドには Bash のターミナル(ターミナル A)を使用します。後続の手順で変数を再利用できるよう開いたままにしてください。続行前に curl と jq をインストールします。例ではベータ 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
ワークフローは Kimi のREST API クイックスタートに従います。公式 PPT アシスタントを使用して、短い架空のビジネスブリーフからプレゼンを作成します。すべての入力データはリクエストに含まれているため、初回の実行ではファイルアップロードやプライベートデータ接続は不要です。
各ブロックを順に実行し、次へ進む前に出力を確認します。&& で連結されたコマンドは、そのブロック内でリクエストや検証が失敗すると停止します。次のステップへ進む前に報告されたエラーを解決してください。既存のセットアップを再試行する場合は、同じ環境 ID とセッション ID を維持します。
Step 1: Select the official PPT assistant
利用可能なエージェントを取得し、その名前と定義を確認します。プロンプトが表示されたら、PPT スキルで構成された公式 PPT アシスタントの ID を貼り付けてください。最後のコマンドは、選択が返却リストに存在することを確認し、その定義を出力します。
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
最後のコマンドは、選択したアシスタントの定義を表示するはずです。アシスタントがあなたのプロジェクトで利用できない場合は、公式 PPT エージェント構成を使用して同等のエージェントを準備してから続行してください。
Step 2: Create a cloud environment
Environment は、インストール済みパッケージ、ネットワークアクセス、起動コマンドなどの実行セットアップの再利用可能な構成です。再利用することで後続のセッションに同一のセットアップを提供できますが、各クラウドセッションは独自のサンドボックスとワークスペースを受け取ります。構成オプションは environment guide を参照してください。
環境は一度作成し、その ID を保持します。クラウドイメージは非同期でビルドされるため、ビルドステータスが ready になるまでセッションを作成しないでください。API が未準備であると報告した場合は待機し、同じ ENVIRONMENT_ID でリトライします。別の環境を作成しても最初のビルドは完了しません。
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
Session は作成時に、利用可能な Agent バージョンと Environment バージョンを固定します。以下のリクエストはそれらの ID を渡し、プラットフォームがバージョンを選択して凍結します。正確な Agent バージョンを選択するために agent_version を設定することも可能です。Agent や Environment を後から更新しても既存セッションは更新されず、セッションはその environment_id を変更できません。改訂済み構成を使用するには新しいセッションを作成してください。これらのルールはセッション作成に記載されています。
イベントストリームとタスクリクエストの両方で返却されたセッション ID を保持します。新しいセッションは idle で開始され、user.message を送信するとタスクが開始します。
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
ターミナル B を開きます。同じ API キーを入力し、次にターミナル A で表示されたセッション ID を貼り付けます。server-sent event stream は、ターミナル A がタスクを送信している間に実行更新を表示します。結果を検査するまでこのターミナルを接続したままにしてください。
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
ターミナル A に戻り、user.message イベントを送信します。例では架空の数値を使用し、具体的な成果物を求めます。エージェントは、支援となるビジネスデータを検索するのではなく、提供された事実のみを使用するべきです。
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
ターミナル B で session.status イベントを監視します。セッションが idle に戻ったら、停止理由を確認します。end_turn はターンが完了したことを示し、requires_action はクライアントがツール結果の提供や確認の処理を行う必要があることを意味します。session.error イベントも確認してください。未解決のエラーがない状態でターンが完了したら、成果物を一覧表示して生成された 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'
northstar.pptx を開きます。成功した結果は3枚のスライドを持ち、データが架空であることを明示し、週次アクティビティを 90 ÷ 120 = 75% と計算します。これにより、ファイル配信とコンテンツの正確性の両方を、実ビジネスデータの接続前に具体的に確認できます。
How to Upload and Attach Files to a Kimi Hosted Agents Session?
最初のプレゼンが動作したら、サンプルの report.pdf をターミナル A の作業ディレクトリに配置します。file API はファイルのアップロードとセッションへの添付を分離しています。最初のタスクが完了した後、既存のセッション ID でこのブロックを実行します。
PDF からテキストを抽出するには purpose=file-extract を使用します。file API はファイルあたり最大 100 MiB を許可し、組織当たりデフォルトで 10 GiB のストレージを提供します。アップロード済みファイルはその場で更新できません。改訂版をアップロードし、新しい ID をバインドしてください。ストレージを解放する必要がある場合は未使用のファイルを削除します。
kimi-api-version: 2026-09-01-beta の場合、アップロードレスポンスの extract_status を確認します。この例では ready の時のみ続行します。error の場合は PDF の形式と内容を確認し、修正したファイルをアップロードしてください。API は失敗した抽出を生ファイルとして添付できますが、このチュートリアルが想定する抽出テキストは提供されません。ステータスが欠落している、または想定外の場合もブロックは停止します。続行前に upload.json を確認してください。
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
ファイルの添付は新しいタスクを送信しません。ターミナル B を接続したまま、ドキュメント名と望む出力を指定したフォローアップを送信します。
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
このタスクが完了したら、成果物の一覧表示ステップを繰り返し、新しい PPTX を選択します。特に数値、日付、提案されたアクションについて、PDF と主張が一致しているか比較してください。
How Do You Connect Tools to Kimi Hosted Agents?
Custom tools executed by your application
プロジェクトの納品状況の参照などの業務アクションには、アプリケーションが実装するカスタムツールを使用します。ツールを宣言するとエージェントで利用可能になりますが、操作の実行はあなたのコードが行います。
- エージェントの
tools配列にcustomエントリを宣言し、名前、説明、オブジェクト形状のinput_schemaを含めます。 - イベントストリームの
agent.custom_tool_useを処理し、関数を実行する前に提供された引数を検証します。 - 呼び出しイベントの JSON
idをdata.event_idとして使用し、user.custom_tool_resultイベントをセッションへ投稿します。
読み取り専用の参照から始めましょう。統合が業務レコードを変更できる場合は、認可と重複アクション防止をアプリケーション側に保持してください。
MCP services and larger workflows
リモートの MCP サービスには、mcp_servers に接続を宣言します。アクセス認証情報はボルトに保管し、セッション作成時にそのボルトをバインドします。プラットフォームはサービスのツールを検出・呼び出します。サーバー定義には秘密情報ではなく接続詳細を含めるべきです。
Optional multi-agent orchestration
プラットフォームはコーディネーターから子への委譲をサポートします。コーディネーターは限定的なタスクを子スレッドへ割り当て、その結果を統合できます。
委譲構成は1–20 のエージェントエントリを受け付けます。これは構成上の上限であり、20 の同時ワーカーや 20 倍の速度改善を示す証拠ではありません。子スレッドはさらに別の子スレッド層を作成できません。
有用な設計としては、ソース収集、定量分析、編集レビューを分離することが考えられます。短い要約タスクは通常、1 つのエージェントで処理する方が適切です。
How Should You Deploy a Kimi Hosted Agents Integration?
Kimi API 呼び出しはアプリケーションのバックエンドの背後に置きます。ブラウザはタスクを送信し、進行状況をあなたのエンドポイント経由で表示でき、バックエンドは API キーを保持し、各ユーザーをそのユーザーがアクセス可能なセッションへマッピングします。セッション ID を業務リクエストと共に保存しておくと、ページ再読み込み時に同じタスクを再度開けます。
Hosted vs. Self-Hosted Execution
このガイドの PPT ワークフローにはクラウド環境を使用してください。save_artifact とセッションファイルのワークフローをサポートします。サンドボックスの実行を組織管理のホスト上で行う必要がある場合は、セルフホスト環境を選択します。Kimi はモデル推論、オーケストレーション、セッション管理を引き続き実行し、ツール入力と結果はプラットフォームを経由します。これはハイブリッド実行モデルです。
- セルフホスト環境にはエンタープライズ検証が必要です。あなたは Worker ホストを運用し、依存関係をインストールし、分離と認証情報を管理します。Worker はプラットフォームへのアウトバウンド HTTPS アクセスを必要とします。
- セルフホストモードは現在、
save_artifact、IPython、画像検索ツールを欠きます。アップロードファイル、スキル、メモリは Worker にマウントされず、その出力ファイルはセッションのファイル一覧に表示されません。このチュートリアルをそのモードへ移す前に、入力の提供方法と出力の取得方法を計画してください。
初回統合ではクラウドから始めましょう。実行ホストの制御が追加セットアップやファイル配信の変更を正当化する場合にセルフホストを検討します。
Choosing who operates the runtime
セッション実行をプラットフォームに管理してほしい場合は Hosted Agents を使用します。チームが独自のエージェントループを構築・運用する必要がある場合は、CometAPI は統一されたモデル API アクセスを提供します。このガイドの Hosted Agents の例は Kimi のエンドポイントと認証情報を使用します。
Kimi Hosted Agents Pricing and Cost Optimization
Kimi Hosted Agents の課金は、モデルトークン、クラウドサンドボックスのランタイム、有料プラグイン呼び出しが対象です。以下の表は、これらの料金がプレゼンワークフローにどう影響するかを示します。価格は中国人民元(CNY)で、Hosted Agents pricing と model inference pricing を 2026年11月10日に確認しました。100万トークンは 1 MTok に相当します。
| Cost component | Billing unit | Rate and what it means for your task |
|---|---|---|
| Model inference | Per 1 MTok | kimi-k3.1-pro の場合:ベース入力 ¥13、出力 ¥68、キャッシュヒット ¥1.30、5分キャッシュ書き込み ¥13、1時間キャッシュ書き込み ¥26。全てのモデル呼び出しにわたる各使用カテゴリに該当レートを適用します。 |
| Cloud sandbox | Runtime; billed by the second | 1 CPU コア・1 GB メモリのサンドボックスで ¥0.072/時。10分で ¥0.012。 |
| Plugins | Per billable call | 例:ウェブ検索 ¥0.03/回、画像検索 ¥0.045/回。その他プラグインには独自のレートがあります。各プラグインの呼び出し回数にその価格を乗じます。 |
| Total task cost | Per completed task | モデル、サンドボックス、プラグインの料金を合計します。以下の作業例では、有料プラグイン呼び出しなしで合計 ¥0.544、同じ想定のモデル使用量とランタイムでウェブ検索3回・画像検索2回を追加した場合は ¥0.724。 |
モデルレートは kimi-k3.1-pro に対する予算の例であり、すべての公式 PPT エージェントがこのモデルを使用するという主張ではありません。これらのレートを適用する前に選択したエージェントのモデル定義を確認してください。他のモデルや高速亜種のレートは異なります。
How to count input and output tokens
エージェントは、1 つのプレゼンを作成する間にモデルを複数回呼び出すことがあります。フォローアップのターンや改訂を含め、全ての呼び出しから課金対象の使用量を合算してください。入力にはプロンプト、抽出された PDF テキスト、ツール結果、会話コンテキストが含まれ得ます。出力使用量はスライド上で見える言葉に限定されません。
K3 のキャッシングでは、未キャッシュ入力、キャッシュ書き込み、キャッシュヒットを分けます。これらは別個の入力カテゴリです。同一トークンに対して、ベースレートで入力合計を課金した後にキャッシュ料金を追加するような二重計上は避けてください。該当する 5 分または 1 時間の書き込みレートを使用します。cache billing guide は、これらのカテゴリを報告された使用量とどのように整合させるかを説明します。
Worked example: a three-slide presentation
あなたのエージェントが kimi-k3.1-pro を使用し、完全な3枚スライドの PPT 実行で 20,000 入力トークン、4,000 課金対象の出力トークン、10 分の課金対象クラウドランタイムを消費したと仮定します。キャッシュヒットなし、1 時間キャッシュ書き込みなし、有料プラグイン呼び出しなしを仮定します。すべての入力は未キャッシュ、またはデフォルトの 5 分キャッシュに書き込まれたもので、どちらも ¥13/MTok の価格です。これらは計画用の推定値であり、Northstar チュートリアルの測定値ではありません。
| Charge | Calculation | Estimated cost |
|---|---|---|
| Model input | 20,000 ÷ 1,000,000 × ¥13 | ¥0.260 |
| Model output | 4,000 ÷ 1,000,000 × ¥68 | ¥0.272 |
| Cloud sandbox | 10 ÷ 60 × ¥0.072 | ¥0.012 |
| Paid plugins | 0 billable calls | ¥0.000 |
| Total | ¥0.260 + ¥0.272 + ¥0.012 | ¥0.544(約 ¥0.54) |
支給事実に基づくチュートリアルでは、エージェントにウェブ閲覧を行わないよう求めています。後にこれを 3 回のウェブ検索と 2 回の画像検索を含むリサーチプレゼンへ拡張する場合、プラグイン料金は 3 × ¥0.03 + 2 × ¥0.045 = ¥0.180 となります。他の数量を一定とすると ¥0.544 + ¥0.180 = ¥0.724 です。リサーチによりモデルトークンやランタイムが増えることもあるため、最終的な請求には測定値を使用してください。
What changes when you use multiple agents?
委譲はモデル呼び出し、コンテキストの繰り返し、ツール呼び出し、改訂作業を増加させる可能性があります。Kimi のマルチエージェントワークフローは、コーディネーターと子スレッドを 1 つのセッションに配置します。子スレッドの数だけでサンドボックス料金が乗数的に増えるわけではありません。スレッド全体のモデルとプラグイン使用量を合算し、セッションの実際の課金対象ランタイムを使用してください。長い実行や独立したクラウドセッションの追加はサンドボックスコストを増やすことがあります。FAQ は、すべてのスレッドが終了してセッションが idle になるとサンドボックスの時間の累積が止まることを説明しています。
Reduce cost per usable presentation
まず 1 つのエージェントと小さな成果物から始めます。関連するソース記述を支給し、スライド枚数を制限し、タスクに必要な場合のみ有料検索を有効にします。同じタスクを再送信する代わりに、切断されたイベントストリームを再接続します。繰り返しワークフローではキャッシュヒットを確認し、再利用可能なコンテキストを安定させます。すべての試行の総コストを、実際に受け入れたプレゼンの数と比較してください。安価な初稿でも複数回の再実行が必要なら、全体としては高くつく可能性があります。
Troubleshooting Common API Errors
- 認証失敗:リクエストを送信するターミナルで API キーが設定され、意図したアカウントに属しているか確認します。呼び出しを繰り返す前に HTTP エラーを確認します。
- curl がオプションを拒否、または jq が見つからない:インストール済みユーティリティを確認します。これらの例は
--fail-with-bodyをサポートする curl と、同じ Bash 環境で動作する jq を必要とします。 - jq が ID を抽出できない:保存されたレスポンス JSON を開きます。成功したリソースオブジェクトではなく、API エラーが含まれている可能性があります。空の ID を次のエンドポイントへ渡すのではなく、まずリクエストを修正してください。
- カスタムツールのワークフローが進行しない:保留中のツールイベントを確認します。
requires_actionの停止理由は、影響を受けるスレッドが続行する前に、クライアントがツール結果を返すか確認処理を行う必要があることを意味します。 - ダウンロードしたスライドに裏付けのない主張が含まれる:支給ブリーフまたはレポートと比較します。具体的な不一致を明記してタスクを改訂し、次の成果物を使用前に確認してください。
障害を診断する際は、エンドポイント、HTTP ステータス、セッション ID、関連イベントを記録します。診断ログに API キーを含めないでください。
Conclusion
Kimi Hosted Agents のワークフローを 1 つ完成させることから始めます:エージェントを選択し、環境を準備し、セッションを作成し、タスクを送信し、配信されたファイルを検査します。この経路が動作したら、ソースドキュメントを追加し、アプリケーションに必要な業務ツールを組み込みます。進捗を可視化し、リクエストが成功したかどうかではなく、出力の有用性で各実行を評価してください。
FAQ
Do I need to resend a Kimi Hosted Agents task after a disconnect?
いいえ。切断されたイベントストリームは新しいタスク送信を必要としません。Last-Event-ID ヘッダーに最後の SSE フレームの id: 値を指定して再接続し、読み取りを再開します。この値はストリームカーソルであり、イベントオブジェクトの JSON ID ではありません。再接続により、同じ作業を誤って二重送信することを避けられます。
What if a Kimi Hosted Agents output is missing from artifacts?
サンドボックスのファイルは、成果物として登録されていなくても存在する可能性があります。エージェントがプレゼンを完了し、save_artifact を呼び出したか確認してください。登録が欠落している場合は、session file APIs を使用して出力ディレクトリを検査します:GET /v1/sessions/{session_id}/filesystem?prefix=output。一覧は一度に 1 つのディレクトリを対象とします。サブディレクトリを検査するには prefix を更新してください。返却された正確なパスに置き換え、GET /v1/sessions/{session_id}/filesystem/raw?path=output/northstar.pptx で選択したファイルをダウンロードします。パスにスペースやその他の予約文字が含まれる場合は、クエリ値を URL エンコードしてください。チュートリアルと同じ認証ヘッダーと API バージョンヘッダーを含めます。
Will updating a Kimi Hosted Agents configuration change an active session?
いいえ。セッションは作成時に固定されたエージェントバージョンを使用します。エージェントを更新すると、その後のセッション向けに新しいバージョンが作成されますが、既存セッションは元の構成を保持します。改訂された指示やツールをテストするには、新しいセッションを開始し、前回の実行との出力を比較してください。

