TL;DR
Kimi Hosted Agents chạy các tác vụ AI nhiều bước với phiên làm việc bền bỉ, thực thi công cụ và sandbox đám mây. Hướng dẫn này đưa bạn từ khóa API Kimi đến một bản trình chiếu ba trang có thể tải xuống bằng Bash, curl và jq. Trước hết, hoàn thành một tác vụ bằng lời nhắc tự đầy đủ. Sau đó thêm một tài liệu tải lên, kết nối các công cụ kinh doanh và xử lý những lỗi quan trọng trong một ứng dụng đã triển khai.
Key Takeaways
- Kimi Hosted Agents kết nối một định nghĩa Agent, một môi trường thực thi và một phiên. Giữ các ID của chúng sẵn có trong suốt quy trình.
- Bắt đầu bằng kết quả nhỏ, có thể kiểm chứng. Ví dụ đầu tiên tạo một bản trình chiếu với dữ liệu hư cấu và một phép tính bạn có thể kiểm tra.
- Dùng luồng sự kiện để theo dõi thực thi, rồi kiểm tra tệp được gửi. Phản hồi HTTP thành công không tự động chứng minh tác vụ thành công.
- Mở rộng ví dụ hoạt động bằng đầu vào tệp, công cụ tùy chỉnh hoặc dịch vụ MCP. Mỗi tích hợp có yêu cầu thực thi và thông tin xác thực riêng.
- Lập ngân sách cho suy luận, thời gian chạy sandbox và việc dùng plugin cùng nhau, bao gồm các lần chạy lại cần thiết để có kết quả chấp nhận được.
What Is Kimi Hosted Agents?
Moonshot AI công bố Kimi Hosted Agents vào ngày 5 tháng 11, 2026, định vị đây là dịch vụ cho doanh nghiệp và nhà phát triển xây dựng các tác nhân chạy lâu.
Sản phẩm sử dụng cách tiếp cận Harness as a Service. “Harness” là phần mềm bao quanh một mô hình để quản lý tiến trình công việc: duy trì trạng thái, gọi công cụ, quản lý thực thi và khôi phục sau gián đoạn.
Hãy xem xét một quy trình nghiên cứu hàng tuần. Việc tạo văn bản chỉ là một bước. Ứng dụng cũng có thể cần truy xuất nguồn, xử lý tệp, tạo biểu đồ, lưu bản trình chiếu và lưu đủ trạng thái để tiếp tục sau khi bị ngắt kết nối.
Hosted Agents cung cấp lớp vận hành đó. Nhóm của bạn vẫn xác định tác vụ kinh doanh, chọn tích hợp và quyết định thế nào là kết quả chấp nhận được.
Kiến trúc chính thức của Kimi cho thấy ứng dụng, các dịch vụ nền tảng và lõi thực thi được dùng bởi runtime được lưu trữ.
Core capabilities for your first integration
- Phiên bền bỉ giữ cùng nhau các đầu vào, sự kiện thực thi và đầu ra của một tác vụ.
- Sandbox đám mây cung cấp các công cụ cần thiết để xử lý tệp và tạo kết quả bàn giao.
- Kỹ năng và plugin đóng gói các năng lực có thể tái sử dụng; công cụ tùy chỉnh và dịch vụ MCP kết nối hệ thống riêng của bạn.
Điểm kiểm tra đầu tiên của bạn là một bản trình chiếu có thể mở và kiểm tra. Thông số runtime chi tiết trở nên hữu ích khi bạn thêm phụ thuộc hoặc chuyển một quy trình hiện có vào sandbox; tài liệu tham chiếu sandbox ghi lại môi trường sẵn có.
What Do You Need Before Calling the Kimi Hosted Agents API?
- Tài khoản nền tảng Kimi có quyền truy cập Hosted Agents và một khóa API.
- Bash, curl và jq trên macOS, Linux hoặc Windows với WSL.
- Hai cửa sổ terminal: Terminal A gửi yêu cầu; Terminal B theo dõi sự kiện thực thi.
- Trình xem bản trình chiếu để mở tệp PPTX được tạo.
Tạo tài khoản nền tảng Kimi và một khóa API trong khu vực quản lý API của bảng điều khiển. Dùng một terminal Bash, gọi là Terminal A, cho các lệnh thiết lập và tác vụ. Giữ nó mở để các bước sau tái sử dụng biến của nó. Cài đặt curl và jq trước khi tiếp tục. Ví dụ dùng phiên bản API beta 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
Quy trình làm theo hướng dẫn REST API quickstart của Kimi. Bạn sẽ dùng trợ lý PPT chính thức để biến một bản tóm tắt kinh doanh ngắn hư cấu thành bản trình chiếu. Mọi dữ liệu đầu vào được đưa vào yêu cầu, nên lần chạy đầu không cần tải tệp lên hoặc kết nối dữ liệu riêng.
Chạy từng khối theo thứ tự và kiểm tra đầu ra của nó trước khi tiếp tục. Các lệnh nối bằng && sẽ dừng khối đó khi một yêu cầu hoặc kiểm tra xác thực thất bại. Giải quyết lỗi được báo trước khi chuyển sang bước tiếp theo; giữ nguyên các biến môi trường và ID phiên khi thử lại một thiết lập hiện có.
Step 1: Select the official PPT assistant
Truy xuất danh sách agent sẵn có và kiểm tra tên cùng định nghĩa của chúng. Khi được nhắc, dán ID của trợ lý PPT chính thức đã cấu hình với kỹ năng PPT. Lệnh cuối kiểm tra lựa chọn của bạn có tồn tại trong danh sách trả về và in định nghĩa của nó.
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
Lệnh cuối cùng sẽ in định nghĩa của agent đã chọn. Nếu trợ lý không có trong dự án của bạn, dùng cấu hình agent PPT chính thức để chuẩn bị một agent tương đương trước khi tiếp tục.
Step 2: Create a cloud environment
Environment là cấu hình có thể tái sử dụng cho thiết lập thực thi của bạn, bao gồm gói cài đặt, quyền truy cập mạng và lệnh khởi động. Tái sử dụng giúp các phiên sau có cùng thiết lập; mỗi phiên trên đám mây vẫn nhận sandbox và workspace riêng. Xem hướng dẫn môi trường để biết tùy chọn cấu hình.
Tạo environment một lần và giữ ID của nó. Ảnh đám mây được build bất đồng bộ, nên hãy đợi đến khi trạng thái build là ready trước khi tạo phiên. Nếu API báo chưa sẵn sàng, hãy đợi và thử lại với cùng ENVIRONMENT_ID. Việc tạo environment khác không làm hoàn tất bản build đầu tiên.
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 cố định phiên bản Agent và phiên bản Environment sẵn có tại thời điểm tạo. Yêu cầu dưới đây cung cấp ID của chúng; nền tảng chọn và đóng băng phiên bản. Bạn cũng có thể đặt agent_version để chọn chính xác phiên bản Agent. Cập nhật Agent hoặc Environment sau đó sẽ không cập nhật phiên hiện có, và một phiên không thể đổi environment_id. Tạo phiên mới để dùng cấu hình đã sửa. Các quy tắc này được ghi trong tạo phiên.
Giữ ID phiên trả về cho cả luồng sự kiện và yêu cầu tác vụ. Một phiên mới bắt đầu ở trạng thái idle; gửi user.message sẽ bắt đầu tác vụ.
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
Mở Terminal B. Nhập cùng khóa API, rồi dán ID phiên in ở Terminal A. Luồng sự kiện do máy chủ gửi hiển thị cập nhật thực thi trong khi Terminal A gửi tác vụ. Giữ terminal này kết nối cho đến khi bạn đã kiểm tra kết quả.
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
Quay lại Terminal A và gửi sự kiện user.message. Ví dụ dùng số liệu hư cấu và yêu cầu một kết quả bàn giao cụ thể. Agent nên dùng các sự kiện thực tế được cung cấp thay vì tìm dữ liệu kinh doanh hỗ trợ.
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
Quan sát session.status trong Terminal B. Khi phiên trở lại idle, kiểm tra lý do dừng: end_turn chỉ ra lượt đã kết thúc, còn requires_action nghĩa là client của bạn phải cung cấp kết quả công cụ hoặc xử lý xác nhận. Kiểm tra cả sự kiện session.error. Sau khi lượt kết thúc mà không có lỗi chưa giải quyết, liệt kê các artifact và chọn tệp PPTX đã tạo.
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'
Mở northstar.pptx. Kết quả thành công có ba trang slide, nhận diện dữ liệu là hư cấu và tính hoạt động hàng tuần là 90 ÷ 120 = 75%. Điều này cho bạn một kiểm tra cụ thể về cả việc giao tệp và độ chính xác nội dung trước khi kết nối dữ liệu kinh doanh thực.
How to Upload and Attach Files to a Kimi Hosted Agents Session?
Sau khi bản trình chiếu đầu tiên hoạt động, đặt một report.pdf mẫu trong thư mục làm việc của Terminal A. File API tách việc tải tệp lên khỏi việc gắn nó vào một phiên. Chạy khối này với ID phiên hiện có sau khi tác vụ đầu tiên đã kết thúc.
Dùng purpose=file-extract để trích xuất văn bản từ PDF. File API cho phép tối đa 100 MiB mỗi tệp và mặc định 10 GiB dung lượng lưu trữ mỗi tổ chức. Tệp đã tải lên không thể cập nhật tại chỗ; hãy tải lên tệp đã sửa và gắn ID mới của nó. Loại bỏ các tệp không dùng khi cần giải phóng dung lượng.
Với kimi-api-version: 2026-09-01-beta, kiểm tra extract_status trong phản hồi tải lên. Ví dụ này chỉ tiếp tục khi trạng thái là ready. Nếu là error, hãy kiểm tra định dạng và nội dung PDF, rồi tải lên một tệp đã sửa. API có thể gắn một trích xuất thất bại như tệp thô, nhưng điều đó không cung cấp văn bản trích xuất mà hướng dẫn này mong đợi. Trạng thái thiếu hoặc bất ngờ cũng dừng khối; kiểm tra upload.json trước khi tiếp tục.
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
Gắn tệp không gửi một tác vụ mới. Giữ Terminal B kết nối và gửi một yêu cầu tiếp theo nêu tên tài liệu và đầu ra mong muốn.
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
Khi tác vụ này kết thúc, lặp lại bước liệt kê artifact và chọn tệp PPTX mới. So sánh các tuyên bố của nó với PDF, đặc biệt là những số liệu, ngày tháng và đề xuất hành động.
How Do You Connect Tools to Kimi Hosted Agents?
Custom tools executed by your application
Đối với một hành động kinh doanh như tra cứu trạng thái giao hàng của một dự án, dùng custom tool do ứng dụng của bạn triển khai. Khai báo công cụ làm cho nó khả dụng với Agent; mã của bạn vẫn thực hiện thao tác.
- Khai báo một mục
customtrong mảngtoolscủa Agent với tên, mô tả vàinput_schemadạng đối tượng. - Xử lý
agent.custom_tool_usetừ luồng sự kiện và xác thực đối số được cung cấp trước khi thực thi hàm của bạn. - Đăng một sự kiện
user.custom_tool_resultvào phiên, dùngidJSON của sự kiện gọi làmdata.event_id.
Bắt đầu bằng tra cứu chỉ đọc. Giữ ủy quyền và bảo vệ hành động trùng lặp trong ứng dụng khi một tích hợp có thể sửa đổi bản ghi kinh doanh.
MCP services and larger workflows
Đối với dịch vụ MCP từ xa, khai báo kết nối của nó trong mcp_servers. Lưu thông tin truy cập trong vault và gắn vault đó khi tạo phiên. Nền tảng khám phá và gọi công cụ của dịch vụ; định nghĩa server nên chứa chi tiết kết nối thay vì bí mật.
Optional multi-agent orchestration
Nền tảng hỗ trợ ủy thác từ điều phối viên sang tác nhân con. Điều phối viên có thể giao nhiệm vụ giới hạn cho các luồng con và kết hợp kết quả của chúng.
Cấu hình ủy thác chấp nhận 1–20 mục agent. Đây là giới hạn cấu hình, không phải bằng chứng về 20 worker đồng thời hoặc cải thiện tốc độ 20×. Luồng con không thể tạo thêm một lớp luồng con khác.
Thiết kế hữu ích có thể tách thu thập nguồn, phân tích định lượng và biên tập. Một tác vụ tóm tắt ngắn thường được xử lý tốt hơn bởi một agent.
How Should You Deploy a Kimi Hosted Agents Integration?
Đặt các lời gọi API Kimi sau backend của ứng dụng bạn. Trình duyệt có thể gửi tác vụ và hiển thị tiến trình qua các endpoint của riêng bạn, trong khi backend giữ khóa API và ánh xạ mỗi người dùng với các phiên họ được phép truy cập. Lưu ID phiên cùng yêu cầu kinh doanh để một lần tải lại trang có thể mở lại cùng tác vụ.
Hosted vs. Self-Hosted Execution
Dùng môi trường đám mây cho quy trình PPT trong hướng dẫn này: nó hỗ trợ save_artifact và quy trình tệp của phiên. Chọn môi trường tự lưu trữ khi thực thi sandbox phải chạy trên máy chủ do tổ chức của bạn quản lý. Kimi vẫn chạy suy luận mô hình, điều phối và quản lý phiên; đầu vào và kết quả công cụ đi qua nền tảng của nó. Đây là mô hình thực thi lai.
- Môi trường tự lưu trữ yêu cầu xác minh doanh nghiệp. Bạn vận hành máy chủ Worker, cài đặt phụ thuộc và quản lý cô lập cùng thông tin xác thực. Worker cần quyền truy cập HTTPS đi ra nền tảng.
- Chế độ tự lưu trữ hiện thiếu
save_artifact, IPython và công cụ tìm kiếm hình ảnh. Tệp tải lên, kỹ năng và bộ nhớ không được mount trên Worker, và các tệp đầu ra của nó không xuất hiện trong danh sách tệp phiên. Lên kế hoạch cách cung cấp đầu vào và truy xuất đầu ra trước khi chuyển hướng dẫn này sang chế độ đó.
Đối với tích hợp đầu tiên, hãy bắt đầu trên đám mây. Cân nhắc tự lưu trữ khi việc kiểm soát máy chủ thực thi biện minh cho thiết lập bổ sung và thay đổi cách giao tệp.
Choosing who operates the runtime
Dùng Hosted Agents khi bạn muốn nền tảng quản lý thực thi phiên. Nếu nhóm của bạn cần xây dựng và vận hành vòng lặp agent riêng, CometAPI cung cấp truy cập API mô hình hợp nhất cho stack tùy chỉnh đó. Các ví dụ Hosted Agents trong hướng dẫn này dùng endpoint và thông tin xác thực của chính Kimi.
Kimi Hosted Agents Pricing and Cost Optimization
Kimi Hosted Agents tính phí token mô hình, thời gian chạy sandbox đám mây và các cuộc gọi plugin trả phí. Bảng dưới đây cho thấy các khoản phí này ảnh hưởng thế nào đến quy trình bản trình chiếu. Giá bằng CNY, kiểm tra vào ngày 10 tháng 11, 2026 đối chiếu với giá Hosted Agents và giá suy luận mô hình. Một triệu token bằng 1 MTok.
| Cost component | Billing unit | Rate and what it means for your task |
|---|---|---|
| Model inference | Per 1 MTok | Với kimi-k3.1-pro: input cơ bản ¥13, output ¥68, cache hits ¥1.30, cache writes 5 phút ¥13 và cache writes 1 giờ ¥26. Áp dụng mức giá cho mỗi loại sử dụng trên tất cả các lần gọi mô hình. |
| Cloud sandbox | Runtime; billed by the second | ¥0.072/giờ cho một sandbox với 1 lõi CPU và 1 GB bộ nhớ. Mười phút tốn ¥0.012. |
| Plugins | Per billable call | Ví dụ: tìm kiếm web ¥0.03/cuộc gọi; tìm kiếm hình ảnh ¥0.045/cuộc gọi. Plugin khác có mức giá riêng. Nhân số cuộc gọi của mỗi plugin với giá niêm yết của nó. |
| Total task cost | Per completed task | Cộng phí mô hình, sandbox và plugin. Ví dụ bản trình chiếu dưới đây tổng cộng ¥0.544 nếu không có cuộc gọi plugin trả phí, hoặc ¥0.724 với ba tìm kiếm web và hai tìm kiếm hình ảnh với cùng mức sử dụng mô hình và thời gian chạy giả định. |
Mức giá mô hình là ví dụ lập ngân sách cho kimi-k3.1-pro, không phải khẳng định mọi Agent PPT chính thức dùng mô hình đó. Kiểm tra định nghĩa mô hình của Agent đã chọn trước khi áp dụng các mức này. Mức giá cho mô hình khác và biến thể tốc độ cao có thể khác.
How to count input and output tokens
Một Agent có thể gọi mô hình nhiều lần trong khi tạo một bản trình chiếu. Cộng tổng mức sử dụng tính phí từ mọi lần gọi, bao gồm các lượt tiếp theo và sửa đổi. Input có thể gồm lời nhắc, văn bản PDF trích xuất, kết quả công cụ và ngữ cảnh hội thoại; mức sử dụng output không giới hạn ở các từ hiển thị trên slide.
Với K3 caching, tách input không cache, cache writes và cache hits. Đây là các loại input riêng biệt: đừng tính toàn bộ tổng input theo mức giá cơ bản rồi cộng thêm phí cache cho cùng lượng token. Dùng mức giá ghi 5 phút hoặc 1 giờ áp dụng. Hướng dẫn tính phí cache giải thích cách đối chiếu các loại này với mức sử dụng được báo cáo.
Worked example: a three-slide presentation
Giả sử Agent của bạn dùng kimi-k3.1-pro và một lần chạy hoàn chỉnh cho bản trình chiếu ba slide tiêu thụ 20.000 token input, 4.000 token output tính phí và 10 phút runtime đám mây tính phí. Giả định không có cache hits, không có ghi cache 1 giờ và không có cuộc gọi plugin trả phí. Mọi input hoặc là chưa cache hoặc được ghi vào cache mặc định 5 phút, cùng giá ¥13/MTok. Đây là lượng sử dụng ước tính để lập kế hoạch, không phải đo đạc của hướng dẫn 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 (khoảng ¥0.54) |
Hướng dẫn dùng dữ kiện cung cấp yêu cầu Agent không duyệt web. Nếu sau đó bạn mở rộng thành bản trình chiếu nghiên cứu với ba tìm kiếm web và hai tìm kiếm hình ảnh, phí plugin sẽ là 3 × ¥0.03 + 2 × ¥0.045 = ¥0.180. Giữ các lượng khác không đổi sẽ cho ¥0.544 + ¥0.180 = ¥0.724. Nghiên cứu cũng có thể tăng token mô hình và thời gian chạy, nên dùng lượng đo được cho hóa đơn cuối cùng.
What changes when you use multiple agents?
Ủy thác có thể thêm lần gọi mô hình, ngữ cảnh lặp lại, gọi công cụ và công việc sửa đổi. Quy trình multi-agent của Kimi đặt điều phối viên và các luồng con trong một phiên. Số luồng con riêng nó không phải là hệ số nhân cho phí sandbox. Cộng mức sử dụng mô hình và plugin trên các luồng, và dùng thời gian chạy tính phí thực tế của phiên. Thời gian thực thi dài hơn hoặc thêm các phiên đám mây độc lập có thể tăng chi phí sandbox. FAQ giải thích rằng thời gian sandbox ngừng tích lũy khi tất cả luồng hoàn tất và phiên trở về idle.
Reduce cost per usable presentation
Bắt đầu với một Agent và một kết quả bàn giao nhỏ. Cung cấp đoạn nguồn liên quan, giới hạn số slide và chỉ bật tìm kiếm trả phí khi tác vụ cần. Kết nối lại luồng sự kiện bị rớt thay vì gửi lại cùng tác vụ. Với quy trình lặp lại, kiểm tra cache hits và giữ ngữ cảnh có thể tái sử dụng ổn định. So sánh tổng chi phí của mọi lần thử với số bản trình chiếu bạn thực sự chấp nhận; một bản nháp rẻ nhưng cần chạy lại nhiều lần có thể tốn nhiều hơn tổng thể.
Troubleshooting Common API Errors
- Sai xác thực: kiểm tra khóa API được đặt trong terminal gửi yêu cầu và thuộc về đúng tài khoản. Kiểm tra lỗi HTTP trước khi lặp lại cuộc gọi.
- curl từ chối một tùy chọn, hoặc thiếu jq: kiểm tra tiện ích đã cài. Ví dụ này yêu cầu phiên bản curl hỗ trợ
--fail-with-bodyvà jq hoạt động trong cùng môi trường Bash. - jq không trích xuất được ID: mở JSON phản hồi đã lưu. Nó có thể chứa lỗi API thay vì đối tượng tài nguyên thành công. Sửa yêu cầu trước thay vì chuyển một ID trống cho endpoint tiếp theo.
- Quy trình custom-tool ngừng tiến triển: kiểm tra các sự kiện công cụ đang chờ. Lý do dừng
requires_actionnghĩa là client cần trả về kết quả công cụ hoặc xử lý xác nhận trước khi luồng bị ảnh hưởng tiếp tục. - Slide tải xuống chứa tuyên bố không được hỗ trợ: so sánh với bản tóm tắt hoặc báo cáo đã cung cấp. Sửa yêu cầu bằng sai lệch cụ thể và kiểm tra kết quả bàn giao tiếp theo trước khi dùng.
Ghi lại endpoint, trạng thái HTTP, ID phiên và sự kiện liên quan khi chẩn đoán lỗi. Giữ khóa API ngoài nhật ký chẩn đoán.
Conclusion
Bắt đầu với một quy trình Kimi Hosted Agents hoàn chỉnh: chọn agent, chuẩn bị môi trường, tạo phiên, gửi tác vụ và kiểm tra tệp được giao. Khi đường đi đó hoạt động, thêm một tài liệu nguồn rồi các công cụ kinh doanh mà ứng dụng của bạn cần. Giữ tiến trình hiển thị và đánh giá mỗi lần chạy theo tính hữu ích của đầu ra, không chỉ theo việc yêu cầu có thành công hay không.
FAQ
Do I need to resend a Kimi Hosted Agents task after a disconnect?
Không. Một luồng sự kiện bị ngắt kết nối không yêu cầu gửi lại tác vụ. Kết nối lại với giá trị id: của khung SSE cuối cùng trong Last-Event-ID header để tiếp tục đọc. Giá trị này là con trỏ luồng, không phải ID JSON của đối tượng sự kiện. Kết nối lại tránh vô tình gửi cùng công việc hai lần.
What if a Kimi Hosted Agents output is missing from artifacts?
Một tệp sandbox có thể tồn tại mà không được đăng ký như artifact. Kiểm tra liệu agent đã hoàn tất bản trình chiếu và gọi save_artifact. Nếu thiếu đăng ký, dùng session file APIs để kiểm tra thư mục đầu ra: GET /v1/sessions/{session_id}/filesystem?prefix=output. Việc liệt kê bao phủ từng thư mục một; cập nhật prefix để kiểm tra thư mục con. Tải tệp đã chọn bằng GET /v1/sessions/{session_id}/filesystem/raw?path=output/northstar.pptx, thay thế đường dẫn ví dụ bằng đường dẫn chính xác trả về từ danh sách. Mã hóa URL giá trị truy vấn nếu đường dẫn chứa khoảng trắng hoặc ký tự dành riêng khác. Bao gồm cùng header ủy quyền và phiên bản API như trong hướng dẫn.
Will updating a Kimi Hosted Agents configuration change an active session?
Không. Một phiên dùng phiên bản Agent cố định tại thời điểm tạo. Cập nhật agent sẽ tạo phiên bản mới cho các phiên tiếp theo trong khi phiên hiện có giữ cấu hình ban đầu. Để thử chỉ dẫn hoặc công cụ sửa đổi, hãy bắt đầu một phiên mới và so sánh đầu ra của nó với lần chạy trước.

