> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Tra cứu tác vụ Phím tắt của Craft

> Tham số, giá trị mặc định, cách hoạt động và giá trị trả về của các tác vụ Craft trong Apple Shortcuts.

Tra cứu các tác vụ Craft trong ứng dụng Phím tắt của Apple trên iPhone, iPad và Mac. Các tác vụ được nhóm theo danh mục bạn thấy trong Phím tắt. Mở rộng một tác vụ để xem tham số và giá trị trả về của nó.

Với các tác vụ Tài liệu và Thư mục, hãy chọn **Không gian** trước khi mở bộ chọn tài liệu hoặc thư mục. Bộ chọn sẽ trống cho đến khi bạn chọn Không gian. Một số tác vụ có thể suy ra Không gian từ tài liệu được chuyển từ tác vụ trước; nơi lưu là ghi chú hàng ngày vẫn cần chọn Không gian cụ thể. Tài liệu hoặc thư mục phải thuộc Không gian đó. Để dùng kết quả trước đó, hãy chèn kết quả bằng bộ chọn biến.

Khi một tác vụ yêu cầu **Tài liệu**, **Thư mục** hoặc **Nhiệm vụ**, hãy chọn một mục trong danh sách hoặc chuyển kết quả của một tác vụ Craft trước đó. Gõ tiêu đề hoặc dán liên kết sẽ không hoạt động. Thao tác Siri dùng tên của Apple: **Ghi chú** là tài liệu Craft và **Lời nhắc** là nhiệm vụ Craft.

## Tài liệu

<AccordionGroup>
  <Accordion title="Tạo tài liệu" id="create-document">
    Tạo tài liệu mới trong một Không gian, có thể đặt trong một thư mục. Mỗi lần chạy tạo một tài liệu mới, kể cả khi đã có tài liệu cùng tiêu đề.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Có | Không có | Không gian nơi tài liệu được tạo. |
    | **Thư mục** | Thư mục Craft | Không | Chưa phân loại | Thư mục đích trong Không gian đã chọn. Bạn có thể chuyển một thư mục từ Tạo thư mục. |
    | **Tiêu đề** | Văn bản | Không | Trống | Tiêu đề tài liệu. |
    | **Nội dung** | Văn bản | Không | Trống | Nội dung chính. Markdown được chuyển thành các khối Craft đã định dạng. |
    | **Hình ảnh** | Danh sách tệp hình ảnh | Không | Trống | Hình ảnh được thêm vào phần nội dung, sau Nội dung. Không đặt ảnh bìa tài liệu. |
    | **Mở ứng dụng** | Boolean | Không | Tắt | Mở tài liệu mới sau khi tạo. |

    #### Giá trị trả về

    **Tài liệu Craft:** tài liệu mới. Chuyển cho Thêm vào tài liệu, Đổi tên tài liệu hoặc Mở tài liệu.

    Được dùng trong [Nhập tệp văn bản với tiêu đề được tạo tự động](/vi/integrate/apple-shortcuts/examples#nhập-tệp-văn-bản-với-tiêu-đề-được-tạo-tự-động).
  </Accordion>

  <Accordion title="Thêm vào tài liệu" id="add-to-document">
    Thêm nội dung vào đầu hoặc cuối một tài liệu hoặc trang. Nội dung và tiêu đề hiện có được giữ nguyên. Mỗi lần chạy sẽ thêm nội dung một lần nữa, kể cả khi nội dung đó đã có.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Không | Không gian của tài liệu đã chọn | Không gian đích. Hãy chọn khi nơi lưu là ghi chú hàng ngày. |
    | **Tài liệu** | Tài liệu Craft hoặc trang | Có | Không có | Tài liệu hoặc trang đích. Bạn có thể chuyển kết quả của một tác vụ trước đó. |
    | **Nội dung** | Văn bản | Không | Trống | Văn bản cần thêm. Markdown được chuyển thành các khối Craft đã định dạng. |
    | **Hình ảnh** | Danh sách tệp hình ảnh | Không | Trống | Hình ảnh được thêm sau Nội dung. |
    | **Vị trí** | Thêm vào cuối hoặc Thêm vào đầu | Không | Thêm vào cuối | Thêm nội dung vào cuối hoặc đầu nơi lưu. |
    | **Mở ứng dụng** | Boolean | Không | Tắt | Mở nơi lưu sau đó. |

    **Ghi chú hằng ngày (Hôm nay)**, **Ghi chú hằng ngày (Hôm qua)** và **Ghi chú hằng ngày (Ngày mai)** luôn trỏ đến đúng ngày khi phím tắt chạy. Nếu ghi chú hàng ngày đó chưa có, Craft sẽ tạo nó. Để thêm vào một trang bên trong tài liệu, hãy chuyển kết quả của Tìm trang làm Tài liệu.

    Nếu cả Nội dung và Hình ảnh đều trống, sẽ không có gì được thêm.

    #### Giá trị trả về

    **Tài liệu Craft:** tài liệu đã nhận nội dung. Nếu bạn thêm vào một trang, bạn nhận được tài liệu cha của trang đó, không phải trang hay các khối mới.

    Được dùng trong [Ghi nhanh bằng giọng nói](/vi/integrate/apple-shortcuts/examples#ghi-nhanh-bằng-giọng-nói).
  </Accordion>

  <Accordion title="Đổi tên tài liệu" id="rename-document">
    Thay đổi tiêu đề của tài liệu. Nội dung và thư mục của tài liệu được giữ nguyên. Tác vụ đổi tên toàn bộ tài liệu, không phải một trang hay đề mục bên trong.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Có | Không có | Không gian chứa tài liệu. |
    | **Tài liệu** | Tài liệu Craft | Có | Không có | Tài liệu cần đổi tên. Chọn một tài liệu hoặc chèn kết quả của một tác vụ trước đó. |
    | **Tiêu đề** | Văn bản | Có | Không có | Tiêu đề mới. Được dùng đúng như đã nhập, kể cả dấu ngoặc kép hay định dạng. |
    | **Mở ứng dụng** | Boolean | Không | Tắt | Mở tài liệu sau đó. |

    Ghi chú hàng ngày bị ẩn khỏi bộ chọn của Đổi tên tài liệu.

    Chuyển một trang con thay vì toàn bộ tài liệu sẽ khiến tác vụ thất bại.

    #### Giá trị trả về

    **Tài liệu Craft:** tài liệu đã đổi tên.

    Được dùng trong [Nhập tệp văn bản với tiêu đề được tạo tự động](/vi/integrate/apple-shortcuts/examples#nhập-tệp-văn-bản-với-tiêu-đề-được-tạo-tự-động).
  </Accordion>

  <Accordion title="Mở tài liệu" id="open-document">
    Mở một tài liệu hoặc trang trong Craft.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Không | Không gian của tài liệu đã chọn | Không gian chứa tài liệu. |
    | **Tài liệu** | Tài liệu Craft hoặc trang | Có | Không có | Tài liệu hoặc trang cần mở. |

    #### Giá trị trả về

    Không có.
  </Accordion>

  <Accordion title="Mở ghi chú hằng ngày" id="open-daily-note">
    Mở ghi chú hàng ngày của hôm nay, ngày mai, hôm qua hoặc một ngày cụ thể.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Có | Không có | Không gian chứa ghi chú hàng ngày. |
    | **Ngày** | Lựa chọn | Không | Hôm nay | Hôm nay, Ngày mai, Hôm qua hoặc Ngày tùy chỉnh. |
    | **Ngày (yyyy-MM-dd)** | Văn bản | Khi Ngày là Ngày tùy chỉnh | Không có | Ngày cần mở, ví dụ 2026-10-13. |

    #### Giá trị trả về

    Không có.
  </Accordion>

  <Accordion title="Di chuyển tài liệu" id="move-document">
    Di chuyển tài liệu sang thư mục khác trong cùng Không gian. Tiêu đề và nội dung của tài liệu được giữ nguyên.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Có | Không có | Không gian chứa tài liệu. |
    | **Tài liệu** | Tài liệu Craft | Có | Không có | Tài liệu cần di chuyển. |
    | **Thư mục** | Thư mục Craft | Không | Chưa phân loại | Thư mục đích. Để trống để chuyển tài liệu vào Chưa phân loại. |
    | **Mở ứng dụng** | Boolean | Không | Tắt | Mở tài liệu đã di chuyển sau đó. |

    Chuyển một trang con thay vì toàn bộ tài liệu sẽ khiến tác vụ thất bại.

    #### Giá trị trả về

    **Tài liệu Craft:** tài liệu đã di chuyển.
  </Accordion>

  <Accordion title="Xóa tài liệu" id="delete-document">
    Chuyển tài liệu vào Thùng rác, hoặc xóa vĩnh viễn nếu bạn bật Xóa vĩnh viễn.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Có | Không có | Không gian chứa tài liệu. |
    | **Tài liệu** | Tài liệu Craft | Có | Không có | Tài liệu cần xóa. |
    | **Xóa vĩnh viễn** | Boolean | Không | Tắt | Khi tắt, tài liệu được chuyển vào Thùng rác. Khi bật, tài liệu bị xóa vĩnh viễn. |
    | **Mở ứng dụng** | Boolean | Không | Tắt | Mở Craft sau đó. |

    Chuyển một trang con thay vì toàn bộ tài liệu sẽ khiến tác vụ thất bại.

    #### Giá trị trả về

    Không có.
  </Accordion>

  <Accordion title="Tìm trang" id="find-page">
    Tìm tiêu đề bạn nhập bên trong một tài liệu hoặc trang, kể cả nội dung lồng nhau. Việc so khớp so sánh toàn bộ tiêu đề, không phân biệt chữ hoa chữ thường, và kiểm tra các trang trước các khối khác. Trong mỗi lượt tìm, tác vụ trả về kết quả khớp đầu tiên tính từ trên xuống.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Có | Không có | Không gian chứa tài liệu. |
    | **Tài liệu** | Tài liệu Craft hoặc trang | Có | Không có | Tài liệu hoặc trang cần tìm. Bạn có thể chuyển kết quả của một tác vụ trước đó. |
    | **Tiêu đề** | Văn bản | Có | Không có | Toàn bộ tiêu đề cần khớp, không phân biệt chữ hoa chữ thường. Tiêu đề không đầy đủ sẽ không khớp. |
    | **Mở ứng dụng** | Boolean | Không | Tắt | Mở trang hoặc khối khớp sau đó. |

    Nếu không có trang nào khớp, Tìm trang sẽ tìm văn bản khớp trong các khối khác. Tác vụ chỉ tìm trong tài liệu hoặc trang đã chọn và nội dung lồng bên trong, không tìm trong toàn bộ Không gian. Nếu không có gì khớp, tác vụ thất bại với lỗi “Không tìm thấy trang con”.

    #### Giá trị trả về

    **Tài liệu Craft hoặc trang:** khối khớp. Chuyển cho Thêm vào tài liệu hoặc Mở tài liệu.
  </Accordion>

  <Accordion title="Thêm trang con vào tài liệu" id="add-subpage-to-document">
    Tạo một trang mới bên trong tài liệu hoặc trang.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Không | Không gian của tài liệu đã chọn | Hãy chọn khi nơi lưu là ghi chú hàng ngày. |
    | **Tài liệu** | Tài liệu Craft hoặc trang | Có | Không có | Tài liệu hoặc trang để thêm trang mới vào. Bạn có thể chuyển kết quả của một tác vụ trước đó. |
    | **Tiêu đề** | Văn bản | Có | Không có | Tiêu đề của trang mới. |
    | **Nội dung** | Văn bản | Không | Trống | Nội dung của trang mới. Markdown được chuyển thành các khối Craft đã định dạng. |
    | **Hình ảnh** | Danh sách tệp hình ảnh | Không | Trống | Hình ảnh được thêm sau Nội dung. |
    | **Vị trí** | Thêm vào cuối hoặc Thêm vào đầu | Không | Thêm vào cuối | Thêm trang vào cuối hoặc đầu nơi lưu. |
    | **Mở ứng dụng** | Boolean | Không | Tắt | Mở trang con mới sau đó. |

    Nơi lưu là ghi chú hàng ngày luôn trỏ đến đúng ngày khi phím tắt chạy, và Craft sẽ tạo ghi chú hàng ngày nếu chưa có.

    #### Giá trị trả về

    **Tài liệu Craft:** một giá trị Tài liệu trỏ đến trang con mới, không phải tài liệu cha. Chuyển cho các tác vụ nhận tài liệu hoặc trang.
  </Accordion>

  <Accordion title="Lấy các khối cấp đầu tiên" id="get-first-level-blocks">
    Trả về văn bản của các khối cấp đầu tiên trong một tài liệu hoặc trang. Không bao gồm các khối lồng nhau.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Có | Không có | Không gian chứa tài liệu. |
    | **Tài liệu** | Tài liệu Craft hoặc trang | Có | Không có | Tài liệu hoặc trang cần đọc. Bạn có thể chuyển kết quả của một tác vụ trước đó. |
    | **Số lượng** | Số nguyên | Không | Tất cả khối cấp đầu tiên | Số khối cần đọc, tính từ trên xuống. 0 trả về văn bản trống. |

    Chỉ các khối văn bản được trả về. Mã, bảng, liên kết, hình ảnh và tệp bị bỏ qua nhưng vẫn được tính vào Số lượng. Tiêu đề tài liệu không được bao gồm.

    #### Giá trị trả về

    **Văn bản:** văn bản của từng khối, mỗi khối một dòng.
  </Accordion>
</AccordionGroup>

## Thư mục

<AccordionGroup>
  <Accordion title="Tạo thư mục" id="create-folder">
    Tạo thư mục trong một Không gian, có thể đặt bên trong một thư mục khác.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Có | Không có | Không gian nơi thư mục được tạo. |
    | **Tên** | Văn bản | Có | Không có | Tên thư mục. Không được để trống. |
    | **Thư mục cha** | Thư mục Craft | Không | Không có (cấp cao nhất) | Thư mục sẽ chứa thư mục mới. |
    | **Mở ứng dụng** | Boolean | Không | Tắt | Mở thư mục mới sau đó. |

    #### Giá trị trả về

    **Thư mục Craft:** thư mục mới.
  </Accordion>

  <Accordion title="Mở thư mục" id="open-folder">
    Mở một thư mục trong Craft.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Có | Không có | Không gian chứa thư mục. |
    | **Thư mục** | Thư mục Craft | Có | Không có | Thư mục cần mở. |

    #### Giá trị trả về

    Không có.
  </Accordion>

  <Accordion title="Đổi tên thư mục" id="rename-folder">
    Thay đổi tên của thư mục.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Có | Không có | Không gian chứa thư mục. |
    | **Thư mục** | Thư mục Craft | Có | Không có | Thư mục cần đổi tên. |
    | **Tên** | Văn bản | Có | Không có | Tên mới. Không được để trống. |
    | **Mở ứng dụng** | Boolean | Không | Tắt | Mở thư mục đã đổi tên sau đó. |

    #### Giá trị trả về

    **Thư mục Craft:** thư mục đã đổi tên.
  </Accordion>

  <Accordion title="Di chuyển thư mục" id="move-folder">
    Di chuyển thư mục vào một thư mục khác trong cùng Không gian, hoặc lên cấp cao nhất.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Có | Không có | Không gian chứa thư mục. |
    | **Thư mục** | Thư mục Craft | Có | Không có | Thư mục cần di chuyển. |
    | **Thư mục cha** | Thư mục Craft | Không | Không có (cấp cao nhất) | Thư mục đích. Để trống để chuyển thư mục lên cấp cao nhất. |
    | **Mở ứng dụng** | Boolean | Không | Tắt | Mở thư mục đã di chuyển sau đó. |

    #### Giá trị trả về

    **Thư mục Craft:** thư mục đã di chuyển.
  </Accordion>

  <Accordion title="Xóa thư mục" id="delete-folder">
    Xóa một thư mục và các thư mục con của nó. Các tài liệu bên trong không bị xóa: chúng được chuyển vào thư mục cha, hoặc vào Chưa phân loại nếu thư mục nằm ở cấp cao nhất.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Có | Không có | Không gian chứa thư mục. |
    | **Thư mục** | Thư mục Craft | Có | Không có | Thư mục cần xóa. |
    | **Mở ứng dụng** | Boolean | Không | Tắt | Mở Craft sau đó. |

    Không thể xóa các thư mục có sẵn.

    #### Giá trị trả về

    Không có.
  </Accordion>
</AccordionGroup>

## Điều hướng

<AccordionGroup>
  <Accordion title="Mở Craft" id="open-craft">
    Mở Craft, có thể mở tại một Không gian và chế độ xem cụ thể.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Không | Không gian dùng gần nhất | Không gian cần mở. |
    | **Vị trí** | Lựa chọn | Không | Không có | Tất cả tài liệu, Thẻ, Đã gắn sao, Nhiệm vụ hoặc Lịch. |

    Nếu cả hai đều trống, Craft mở tại nơi bạn rời đi lần trước.

    #### Giá trị trả về

    Không có.
  </Accordion>

  <Accordion title="Mở và tìm kiếm" id="open-and-search">
    Mở tìm kiếm trong một Không gian, có thể điền sẵn từ khóa tìm kiếm.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Có | Không có | Không gian cần tìm kiếm. |
    | **Truy vấn** | Văn bản | Không | Trống | Từ khóa tìm kiếm. Để trống để mở tìm kiếm mà không có từ khóa. |

    #### Giá trị trả về

    Không có.
  </Accordion>

  <Accordion title="Mở Quick Entry" id="open-quick-entry">
    Mở Quick Entry ở chế độ bạn chọn, có thể điền sẵn văn bản. Bạn tự hoàn tất mục nhập.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Có | Không có | Không gian để thêm mục nhập. |
    | **Chế độ** | Lựa chọn | Không | Tài liệu mới | Tài liệu mới, Nhiệm vụ mới, Thêm vào ghi chú hằng ngày hoặc Thêm vào cuối tài liệu. |
    | **Thư mục** | Thư mục Craft | Không | Chưa phân loại | Thư mục cho tài liệu mới. Chỉ dùng với Tài liệu mới. |
    | **Tài liệu** | Tài liệu Craft | Với Thêm vào cuối tài liệu | Tùy nền tảng với Nhiệm vụ mới | Nơi lưu cho Thêm vào cuối tài liệu hoặc Nhiệm vụ mới. Với Nhiệm vụ mới và không có Tài liệu, Mac dùng Hộp thư; iPhone và iPad dùng vị trí nhiệm vụ Quick Entry gần nhất, hoặc Hộp thư nếu chưa lưu vị trí nào. |
    | **Lịch trình (yyyy-MM-dd)** | Văn bản | Không | Không có | Ngày lên lịch cho Nhiệm vụ mới. |
    | **Ngày** | Lựa chọn | Không | Hôm nay | Ghi chú hàng ngày cho Thêm vào ghi chú hằng ngày: Hôm nay, Ngày mai, Hôm qua hoặc Ngày tùy chỉnh. |
    | **Ngày (yyyy-MM-dd)** | Văn bản | Khi Ngày là Ngày tùy chỉnh | Không có | Ngày của ghi chú hàng ngày cho Thêm vào ghi chú hằng ngày. |
    | **Nội dung** | Văn bản | Không | Trống | Văn bản cần điền sẵn. |

    Trên Mac, tác vụ này mở cửa sổ Quick Entry. Trên iPhone và iPad, tác vụ mở Quick Entry trong Craft. Phím tắt không nhận lại mục bạn tạo.

    #### Giá trị trả về

    Không có.
  </Accordion>
</AccordionGroup>

## Thẻ

<AccordionGroup>
  <Accordion title="Mở thẻ" id="open-tag">
    Hiển thị các tài liệu có một thẻ trong Không gian.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Có | Không có | Không gian chứa thẻ. |
    | **Thẻ** | Thẻ Craft | Có | Không có | Thẻ cần mở. Chọn thẻ từ danh sách. |

    #### Giá trị trả về

    Không có.
  </Accordion>
</AccordionGroup>

## Nhiệm vụ

<AccordionGroup>
  <Accordion title="Tạo nhiệm vụ" id="create-task">
    Tạo nhiệm vụ ở đầu một tài liệu hoặc trang con, hoặc trong Inbox nhiệm vụ của Không gian. Nội dung và hình ảnh được thêm vào bên trong nhiệm vụ.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Có | Không có | Không gian của nhiệm vụ. |
    | **Tài liệu** | Tài liệu Craft hoặc trang | Có | Không có | Tài liệu hoặc trang con cho nhiệm vụ, hoặc Hộp thư. Chuyển một trang con từ Tìm trang hoặc Thêm trang con vào tài liệu để tạo nhiệm vụ ở đó. Các tùy chọn ghi chú hàng ngày luôn trỏ đến đúng ngày khi phím tắt chạy. |
    | **Tiêu đề** | Văn bản | Có | Không có | Nội dung chữ của nhiệm vụ. |
    | **Nội dung** | Văn bản | Không | Trống | Nội dung bên trong nhiệm vụ. Markdown được chuyển thành các khối Craft đã định dạng. |
    | **Hình ảnh** | Danh sách tệp hình ảnh | Không | Trống | Hình ảnh được thêm sau Nội dung. |
    | **Lên lịch** | Lựa chọn | Không | Không có | Không có, Hôm nay, Ngày mai hoặc Tùy chỉnh. |
    | **Lịch trình tùy chỉnh (yyyy-MM-dd)** | Văn bản | Khi Lên lịch là Tùy chỉnh | Không có | Ngày lên lịch. |
    | **Hạn chót** | Lựa chọn | Không | Không có | Không có, Hôm nay, Ngày mai hoặc Tùy chỉnh. |
    | **Hạn chót tùy chỉnh (yyyy-MM-dd)** | Văn bản | Khi Hạn chót là Tùy chỉnh | Không có | Ngày hạn chót. |
    | **Lời nhắc** | Lựa chọn | Không | Không có | Không có, Hôm nay, Ngày mai hoặc Tùy chỉnh. |
    | **Lời nhắc tùy chỉnh (yyyy-MM-dd HH:mm)** | Văn bản | Khi Lời nhắc là Tùy chỉnh | Không có | Ngày và giờ nhắc. |
    | **Giờ nhắc** | Văn bản | Khi Lời nhắc là Hôm nay hoặc Ngày mai | Không có | Thời gian theo định dạng 24 giờ, ví dụ 09:30. |
    | **Mở ứng dụng** | Boolean | Không | Tắt | Mở nhiệm vụ mới sau đó. |

    Lên lịch và Hạn chót chỉ là ngày. Lời nhắc gửi thông báo, nên cũng cần giờ.

    #### Giá trị trả về

    **Nhiệm vụ Craft:** nhiệm vụ mới. Chuyển cho Đặt trạng thái nhiệm vụ.
  </Accordion>

  <Accordion title="Đặt trạng thái nhiệm vụ" id="set-task-status">
    Đánh dấu nhiệm vụ là Đang chờ, Đã hoàn thành hoặc Đã hủy.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Có | Không có | Không gian chứa nhiệm vụ. |
    | **Tài liệu** | Tài liệu Craft | Có | Không có | Tài liệu chứa nhiệm vụ, hoặc Hộp thư nếu đó là nhiệm vụ trong Inbox. Chọn một tài liệu khác sẽ khiến tác vụ thất bại. |
    | **Nhiệm vụ** | Nhiệm vụ Craft | Có | Không có | Nhiệm vụ cần cập nhật. Chọn một nhiệm vụ hoặc chèn kết quả của một tác vụ trước đó. |
    | **Trạng thái** | Lựa chọn | Không | Đã hoàn thành | Đang chờ, Đã hoàn thành hoặc Đã hủy. |
    | **Mở ứng dụng** | Boolean | Không | Tắt | Mở nhiệm vụ đã cập nhật sau đó. |

    #### Giá trị trả về

    **Nhiệm vụ Craft:** nhiệm vụ đã cập nhật.
  </Accordion>

  <Accordion title="Mở danh sách nhiệm vụ" id="open-tasks-list">
    Mở một trong các danh sách nhiệm vụ của bạn trong Craft.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Không gian** | Không gian Craft | Không | Không gian dùng gần nhất | Không gian có nhiệm vụ được hiển thị. |
    | **Loại nhiệm vụ** | Lựa chọn | Không | Tất cả | Hộp thư, Hôm nay, Sắp tới hoặc Tất cả. |

    #### Giá trị trả về

    Không có.
  </Accordion>
</AccordionGroup>

## Nhắc nhở

<AccordionGroup>
  <Accordion title="Tạo lời nhắc" id="create-reminder">
    Tạo lời nhắc Craft không gắn với tài liệu. Tác vụ này khác với Tạo lời nhắc trong Thao tác Siri, vốn tạo nhiệm vụ.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Người dùng** | Người dùng Craft | Có | Không có | Tài khoản nhận lời nhắc. |
    | **Ngày đến hạn** | Lựa chọn | Có | Không có | Sau 20 phút, Sau 1 giờ, Sau 3 giờ, Ngày mai, Tuần sau, Tùy chỉnh hoặc Lưu để sau. |
    | **Ngày tùy chỉnh (yyyy-MM-dd HH:mm)** | Văn bản | Khi Ngày đến hạn là Tùy chỉnh | Không có | Ngày và giờ nhắc. |
    | **Văn bản** | Văn bản | Có | Không có | Nội dung lời nhắc. |
    | **Mở ứng dụng** | Boolean | Không | Tắt | Mở Craft sau đó. |

    Lưu để sau tạo lời nhắc không có ngày đến hạn.

    #### Giá trị trả về

    Không có.
  </Accordion>
</AccordionGroup>

## Thao tác Siri

Các tác vụ này tuân theo định dạng riêng của Apple cho ghi chú, lời nhắc và tìm kiếm trong ứng dụng, để Siri và Apple Intelligence có thể làm việc với chúng. Bạn cũng có thể thêm chúng vào phím tắt như mọi tác vụ khác. Các tác vụ này cần iOS, iPadOS hoặc macOS 27 trở lên.

Trong các tác vụ này, **ghi chú** là tài liệu Craft và **lời nhắc** là nhiệm vụ Craft. Văn bản được thêm dưới dạng văn bản thuần: Markdown không được chuyển đổi. Tài liệu trong thư mục Templates và các thư mục con của nó bị loại khỏi Find Note và các bộ chọn Ghi chú. Thư mục Templates và các thư mục con của nó cũng bị loại khỏi các bộ chọn Thư mục trong Thao tác Siri.

<AccordionGroup>
  <Accordion title="Tạo ghi chú" id="create-note">
    Tạo một tài liệu Craft. Mỗi dòng không trống trong Nội dung trở thành một khối riêng.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Tiêu đề** | Văn bản | Có | Không có | Tiêu đề tài liệu. |
    | **Nội dung** | Văn bản | Không | Trống | Văn bản nội dung. |
    | **Tệp đính kèm** | Danh sách tệp | Không | Trống | Các tệp được thêm sau văn bản. |
    | **Đã gắn sao** | Boolean | Không | Tắt | Gắn sao cho tài liệu mới. |
    | **Thư mục** | Thư mục ghi chú Craft | Không | Chưa phân loại trong Không gian dùng gần nhất | Thư mục đích. Thư mục cũng quyết định Không gian. |

    #### Giá trị trả về

    **Ghi chú Craft:** tài liệu mới. Chuyển cho Mở ghi chú, Cập nhật ghi chú hoặc Thêm văn bản vào ghi chú.
  </Accordion>

  <Accordion title="Find Note" id="find-note">
    Tìm tài liệu Craft trên các Không gian của bạn. Không bao gồm tài liệu trong Thùng rác, tài liệu bị ẩn và tài liệu trong thư mục Templates hoặc các thư mục con của nó.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Search text** | Văn bản | Không | Không có | Khớp một phần của tiêu đề. Không phân biệt chữ hoa chữ thường. |
    | **Folder filter** | Thư mục ghi chú Craft | Không | Không có | Chỉ tìm tài liệu trong thư mục này. |
    | **Space filter** | Tài khoản ghi chú Craft | Không | Không có | Chỉ tìm tài liệu trong Không gian này. |
    | **Match mode** | All hoặc Any | Không | Do Phím tắt đặt | Cách kết hợp nhiều bộ lọc. |
    | **Sort by** | Ngày tạo hoặc ngày sửa đổi | Không | Không có | Sắp xếp kết quả theo ngày tạo hoặc ngày sửa đổi. |
    | **Sort order** | Tăng dần hoặc Giảm dần | Không | Không có | Chiều sắp xếp. |
    | **Limit** | Số nguyên | Không | Tất cả kết quả khớp | Số kết quả tối đa. |

    Phím tắt tạo các tùy chọn tìm kiếm, lọc và sắp xếp cho tác vụ này, nên nhãn của chúng có thể khác nhau giữa các phiên bản hệ điều hành. Chỉ tiêu đề được tìm kiếm, không tìm trong nội dung tài liệu.

    #### Giá trị trả về

    **Danh sách ghi chú Craft:** các tài liệu khớp.
  </Accordion>

  <Accordion title="Mở ghi chú" id="open-note">
    Mở một tài liệu Craft.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Ghi chú** | Ghi chú Craft | Có | Không có | Tài liệu cần mở, chẳng hạn kết quả của Tạo ghi chú hoặc Find Note. |

    #### Giá trị trả về

    Không có.
  </Accordion>

  <Accordion title="Cập nhật ghi chú" id="update-note">
    Thay đổi tiêu đề, tệp đính kèm, dấu sao hoặc thư mục của tài liệu. Mọi trường bạn để trống sẽ giữ nguyên.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Ghi chú** | Ghi chú Craft | Có | Không có | Tài liệu cần cập nhật. |
    | **Tiêu đề** | Văn bản | Không | Không đổi | Tiêu đề mới. Để trống để giữ tiêu đề hiện tại. |
    | **Tệp đính kèm** | Danh sách tệp | Không | Không đổi | Các tệp được thêm vào cuối tài liệu. Tệp đính kèm hiện có được giữ lại. |
    | **Đã gắn sao** | Boolean | Không | Không đổi | Bật để gắn sao cho tài liệu. Tắt để bỏ dấu sao. |
    | **Thư mục** | Thư mục ghi chú Craft | Không | Không đổi | Thư mục đích trong Không gian hiện tại của tài liệu. Chọn Chưa phân loại để đưa tài liệu ra khỏi thư mục. |

    Bộ chọn Thư mục liệt kê thư mục trên các Không gian, được gắn nhãn bằng tên Không gian và tên thư mục. Hãy chọn một thư mục trong Không gian hiện tại của tài liệu. Thư mục ở Không gian khác sẽ khiến tác vụ thất bại với lỗi “Mục đã chọn thuộc về một không gian khác”.

    Nếu việc di chuyển thư mục thất bại, tác vụ sẽ báo lỗi. Mọi thay đổi về tiêu đề, dấu sao hoặc tệp đính kèm đã được áp dụng vẫn được lưu.

    Để thêm văn bản vào tài liệu, hãy dùng Thêm văn bản vào ghi chú.

    #### Giá trị trả về

    **Ghi chú Craft:** tài liệu đã cập nhật.
  </Accordion>

  <Accordion title="Thêm văn bản vào ghi chú" id="append-text-to-note">
    Thêm văn bản vào cuối một tài liệu Craft. Mỗi dòng không trống trở thành một khối riêng.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Ghi chú** | Ghi chú Craft | Có | Không có | Tài liệu cần thêm văn bản. |
    | **Nội dung** | Văn bản | Có | Không có | Văn bản cần thêm. Các dòng trống bị bỏ qua. |

    #### Giá trị trả về

    **Ghi chú Craft:** tài liệu đã cập nhật.
  </Accordion>

  <Accordion title="Tạo lời nhắc (Thao tác Siri)" id="create-reminder-siri-actions">
    Tạo một nhiệm vụ Craft trong Inbox nhiệm vụ của một Không gian. Tác vụ này khác với Tạo lời nhắc trong danh mục Nhắc nhở.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Tiêu đề** | Văn bản | Có | Không có | Nội dung chữ của nhiệm vụ. |
    | **Không gian** | Danh sách lời nhắc Craft | Không | Không gian duy nhất của bạn, nếu bạn chỉ có một | Không gian đích. Nếu bạn có nhiều Không gian, Craft sẽ hỏi bạn muốn dùng Không gian nào. |
    | **Nội dung** | Văn bản | Không | Trống | Văn bản được thêm bên trong nhiệm vụ. |
    | **Ngày lên lịch** | Ngày | Không | Không có | Ngày lên lịch. Không đặt hạn chót hay thông báo. |

    Để trống **Phần**. Nếu đặt giá trị cho trường này, tác vụ sẽ thất bại với lỗi “Không hỗ trợ các phần”. Định dạng của Apple cũng hiển thị Đã gắn cờ, Hình ảnh, Thẻ, URL, Lặp lại và Kích hoạt theo vị trí. Craft bỏ qua các trường này. Để thêm hình ảnh, hạn chót hoặc thông báo, hãy dùng [Tạo nhiệm vụ](#create-task).

    #### Giá trị trả về

    **Lời nhắc Craft:** nhiệm vụ mới. Chuyển cho Mở lời nhắc, Cập nhật lời nhắc hoặc Xóa lời nhắc.
  </Accordion>

  <Accordion title="Mở lời nhắc" id="open-reminder">
    Mở một nhiệm vụ Craft. Nhiệm vụ trong Inbox sẽ mở trong Inbox; các nhiệm vụ khác mở trong tài liệu của chúng.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Lời nhắc** | Lời nhắc Craft | Có | Không có | Nhiệm vụ cần mở. |

    #### Giá trị trả về

    Không có.
  </Accordion>

  <Accordion title="Cập nhật lời nhắc" id="update-reminder">
    Cập nhật một nhiệm vụ Craft. Mọi trường bạn để trống sẽ giữ nguyên.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Lời nhắc** | Lời nhắc Craft | Có | Không có | Nhiệm vụ cần cập nhật. |
    | **Tiêu đề** | Văn bản | Không | Không đổi | Nội dung chữ mới của nhiệm vụ. |
    | **Nội dung** | Văn bản | Không | Không đổi | Văn bản được thêm bên trong nhiệm vụ. Nội dung hiện có được giữ lại. |
    | **Ngày lên lịch** | Ngày | Không | Không đổi | Ngày lên lịch mới. Không đặt thông báo. |
    | **Đã hoàn thành** | Boolean | Không | Không đổi | Bật để hoàn thành nhiệm vụ. Tắt để đánh dấu là chưa xong. |
    | **Không gian** | Danh sách lời nhắc Craft | Không | Trống (giữ nhiệm vụ trong Không gian của nó) | Nếu đặt, phải là Không gian hiện tại của nhiệm vụ. Chọn Không gian khác sẽ thất bại với lỗi “Không hỗ trợ di chuyển nhiệm vụ giữa các không gian”. |

    Để trống Tiêu đề, Nội dung hoặc Ngày lên lịch sẽ giữ giá trị hiện tại; giá trị đó không bị xóa. Định dạng của Apple cũng hiển thị Thẻ, URL, Lặp lại, Đã gắn cờ và Kích hoạt theo vị trí. Craft bỏ qua các trường này.

    #### Giá trị trả về

    **Lời nhắc Craft:** nhiệm vụ đã cập nhật.
  </Accordion>

  <Accordion title="Xóa lời nhắc" id="delete-reminders">
    Xóa một hoặc nhiều nhiệm vụ Craft.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Nhắc nhở** | Nhiều lời nhắc Craft | Có | Không có | Các nhiệm vụ cần xóa. Chúng có thể nằm ở các Không gian khác nhau. |

    #### Giá trị trả về

    Không có.
  </Accordion>

  <Accordion title="Tìm kiếm tài liệu" id="search-documents">
    Mở tìm kiếm của Craft với từ khóa của bạn.

    #### Tham số

    | Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
    | - | - | - | - | - |
    | **Tìm kiếm** | Văn bản | Có | Không có | Từ khóa tìm kiếm. |

    Tìm trong Không gian bạn đang mở trong Craft, hoặc Không gian bạn dùng gần nhất. Kết quả mở trong Craft; phím tắt không nhận lại danh sách tài liệu. Để chọn Không gian, hãy dùng [Mở và tìm kiếm](#open-and-search).

    #### Giá trị trả về

    Không có.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.