Thẻ kết quả

Một công cụ của máy chủ MCP hoặc connector cục bộ có thể đính kèm một thẻ vào kết quả của nó. Trợ lý vẫn đọc phần văn bản của kết quả để trả lời, còn người dùng thấy thẻ ngay dưới bước gọi công cụ: ví dụ một đơn hàng với trạng thái, tổng tiền và nút theo dõi.

Người dùng thấy gìSao chép liên kết đến mục này

Nút mở liên kết mở trang trong tab mới. Nút gửi tin nhắn gửi một câu có sẵn thành tin nhắn tiếp theo của người dùng, ví dụ "Huỷ đơn 1042", để trợ lý xử lý tiếp. Khi có thẻ, trợ lý được nhắc không lặp lại nội dung thẻ trong câu trả lời.

Khai báo thẻSao chép liên kết đến mục này

Thêm _meta.assistant_platform.card vào kết quả tools/call:

{
  "content": [{ "type": "text", "text": "Đơn 1042 đã giao cho đơn vị vận chuyển, dự kiến đến thứ Sáu." }],
  "_meta": {
    "assistant_platform": {
      "card": {
        "v": 1,
        "title": "Đơn hàng #1042",
        "subtitle": "Đang giao",
        "text": "Dự kiến đến thứ Sáu.",
        "icon_url": "https://shop.example.com/icon.png",
        "image_url": "https://shop.example.com/o/1042.jpg",
        "fields": [
          { "label": "Tổng", "value": "1.250.000 ₫" },
          { "label": "Vận chuyển", "value": "GHN" }
        ],
        "actions": [
          { "kind": "url", "label": "Theo dõi", "url": "https://shop.example.com/o/1042" },
          { "kind": "message", "label": "Huỷ đơn", "text": "Huỷ đơn 1042" }
        ],
        "fallback_text": "Đơn #1042 đang giao, dự kiến đến thứ Sáu. Tổng 1.250.000 ₫."
      }
    }
  }
}

Mọi trường đều là văn bản thuần, không có Markdown hay HTML. Nút đầu tiên là nút chính. Trường lạ bị bỏ qua, nên thẻ cũ vẫn hiển thị khi có phiên bản mới.

Khi thẻ không hợp lệSao chép liên kết đến mục này

Thẻ sai giới hạn, thiếu fallback_text hoặc dùng URL không phải https bị bỏ qua hoàn toàn, còn phần văn bản của kết quả vẫn đến trợ lý nên câu trả lời không bị ảnh hưởng. Thẻ không cần duyệt lại khi thay đổi, vì nó là một phần của kết quả chứ không phải định nghĩa công cụ.