# 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.

Source: https://muse4ai.lovable.app/vi/docs/mcp-tools · Cập nhật 2026-11-02

## Trước khi bắt đầu

- Kết nối ứng dụng MCP bằng khoá API còn hiệu lực.
- Tạo nội dung sử dụng hạn mức tài khoản Muse. Không lặp yêu cầu để vượt hạn mức.

## 1. Kiể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ợ.

## 2. Chọ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.

## 3. Gử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"
}
```

## 4. Tuâ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.

## 5. Xử 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.