Chương · Kết nối AI agent
Tra cứu công cụ MCP
Tìm hiểu các công cụ MCP, theo dõi trạng thái công việc và tránh gửi trùng khi yêu cầu bị gián đoạn giữa chừng.
Trước khi bắt đầu
1Kiểm tra máy chủ và khả năng hỗ trợ
Mở Cài đặt › API & agent, rồi gọi muse_status để xem tài khoản sẵn sàng, hạn mức và các khả năng được hỗ trợ.
2Chọn đúng công cụ
Công cụ — công dụng:
muse_status— xem trạng thái và khả năng hỗ trợ.muse_generate— đưa việc tạo ảnh hoặc video vào hàng chờ.muse_chat— hỏi Muse; nhận nguyên văn câu trả lời, tệp và conversation_id.muse_get_job— xem hoặc chờ một việc.muse_list_jobs— liệt kê việc được tạo bằng khoá này.muse_cancel_job— yêu cầu huỷ việc của bạn.muse_extend_video— bắt đầu chuỗi nối video khi được hỗ trợ.muse_get_extend— xem hoặc chờ chuỗi nối video.
3Gửi một lần rồi theo dõi
Gọi muse_generate với request_id riêng cho mỗi thao tác mới. Sau đó gọi muse_get_job với wait_seconds đến khi succeeded, failed, cancelled hoặc needs_review. Khi thành công, dùng download_url. Chỉ dùng lại request_id cùng dữ liệu không đổi khi thử lại chính lần gửi bị gián đoạn.
json { "kind": "image", "prompt": "A ceramic cup on a wooden desk", "request_id": "muse4ai-image-example-001" }4Tuân theo quy tắc thử lại
Không gửi lại việc đang running hoặc needs_review. Chỉ thử lại việc thất bại với PRE_SUBMIT_TRANSIENT hoặc PROXY_FAILED, hoặc thử một lần sau vài phút với PROVIDER_ERROR. Việc needs_review cần người kiểm tra trong app.
5Xử lý hội thoại và nối video
Giữ conversation_id để tiếp tục hội thoại. Khi nhận conversation_busy, hãy chờ, không gửi lặp. Chỉ dùng muse_extend_video khi muse_status báo có khả năng nối video, rồi theo dõi bằng muse_get_extend. Không đảm bảo độ dài tăng thêm hoặc chuyển cảnh liền mạch.
Kiểm tra thành công
Ứng dụng của bạn theo dõi việc đã có, giữ request ID và dừng để người dùng kiểm tra khi cần.
Nếu không chạy
Yêu cầu hết thời gian chờ. Có nên tạo lại?
Kiểm tra việc hiện có trước. Nếu thử lại lần gửi bị gián đoạn, giữ nguyên request_id và dữ liệu để tránh tạo trùng.
Vì sao không thấy việc của agent khác?
Công cụ liệt kê trả về các việc được tạo bằng khoá API hiện tại.
Chat có kiểm chứng câu trả lời Muse không?
Không. Câu trả lời được trả nguyên văn. Bạn cần tự kiểm tra thông tin nghiên cứu và tệp đính kèm.