> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Bộ nhớ workspace

> Xem, sửa và nhập những gì CloudThinker ghi nhớ về workspace để agent không phải hỏi lại cùng một ngữ cảnh

Bộ nhớ workspace là tập ghi chú mà CloudThinker lưu giữa các cuộc hội thoại: thông tin về môi trường, sở thích của nhóm, quyết định và các chỉnh sửa. Mỗi cuộc hội thoại mới đều bắt đầu với bộ nhớ đã được nạp, nên bạn chỉ cần giải thích thiết lập một lần và mọi thành viên đều được hưởng lợi.

> [!NOTE]
>
> [Dreaming](https://docs.cloudthinker.io/vi/guide/memory-dreaming.md) được bật mặc định. Tính năng này chạy hằng đêm, gộp và xóa các mục bộ nhớ và skill tùy chỉnh, đồng thời dùng credit của workspace vào mỗi đêm có hội thoại để đọc. [Tắt tính năng này](https://docs.cloudthinker.io/vi/guide/memory-dreaming.md#bật-hoặc-tắt-dreaming) nếu bạn muốn tự quản lý bộ nhớ.

## CloudThinker ghi nhớ những gì

[Agent](https://docs.cloudthinker.io/vi/guide/agents/overview.md) tự ghi bộ nhớ trong khi làm việc. Bạn không cần gắn thẻ gì, và bản ghi hội thoại thô không bao giờ được sao chép vào bộ nhớ.

| Bộ nhớ | Nội dung | Ví dụ |
| - | - | - |
| Mục bộ nhớ | Thông tin lâu dài, quyết định và chỉnh sửa, thuộc loại **Workspace**, **Feedback**, **Project** hoặc **Reference**. Hiển thị trong **More → Workspace settings → Memory** | "Production chạy ở eu-west-1; khôi phục thảm họa chạy ở eu-central-1" |
| Ghi chú kết nối | Những gì agent học được khi làm việc với một [kết nối](https://docs.cloudthinker.io/vi/guide/connections/overview.md) cụ thể. Không hiển thị trong **More → Workspace settings → Memory**. Hỏi trong chat để xem hoặc thay đổi | Log group nào chứa log của dịch vụ thanh toán |
| Sở thích cá nhân | Cách mỗi thành viên muốn làm việc: định dạng báo cáo, giọng văn, ưu tiên. Không hiển thị trong **More → Workspace settings → Memory**. Hỏi trong chat để xem hoặc thay đổi sở thích của bạn, ví dụ "Change my report preference to bullet points" | "Trả lời ngắn gọn và nêu kết quả trước" |

Mỗi mục bộ nhớ có một loại. Chọn loại theo bản chất của mục:

| Loại | Nội dung | Ví dụ |
| - | - | - |
| **Workspace** | Quy ước, thuật ngữ, thông tin hạ tầng, quyền sở hữu | "Nhóm payments sở hữu các RDS instance `pay-*`" |
| **Feedback** | Chỉnh sửa cách agent làm việc, cách khắc phục hiệu quả, cách tiếp cận cần tránh | "Không đề xuất rightsizing cho cluster staging. Lý do: cluster được định cỡ cho kiểm thử tải" |
| **Project** | Sáng kiến, quyết định, hạn chót | "Chuyển sang Graviton hoàn tất trước 2026-12-15" |
| **Reference** | Liên kết tới hệ thống, tài liệu hoặc dashboard bên ngoài | "Bất thường chi phí được phân loại trên dashboard Grafana của FinOps" |

Công việc đang diễn ra cũng được theo dõi dưới dạng task: một mục bộ nhớ chứa trạng thái của task (active, blocked hoặc done), quyết định, vướng mắc và bước tiếp theo. Task hiển thị trong **More → Workspace settings → Memory** như mọi mục khác, và mỗi task có một dòng trong chỉ mục bộ nhớ (xem [Giới hạn](#giới-hạn)).

Hai sản phẩm có bộ nhớ chuyên biệt riêng trên cùng nền tảng: [Incident Memory](https://docs.cloudthinker.io/vi/guide/incident/incident-memory.md) cho các cuộc điều tra Resolve và [Learnings](https://docs.cloudthinker.io/vi/guide/code-review/convention-rules.md) cho Review. Để chọn giữa bộ nhớ, knowledge base, skill và nguồn runbook, xem [Dạy CloudThinker](https://docs.cloudthinker.io/vi/guide/teach-cloudthinker.md).

> [!WARNING]
>
> Bộ nhớ được chia sẻ cho mọi thành viên trong workspace, không riêng tư với bạn. Agent cũng có thể tìm kiếm các cuộc hội thoại trước đây của mọi thành viên trong workspace, và không có cách nào đánh dấu một cuộc hội thoại là riêng tư. Đừng dán secret hoặc dữ liệu cá nhân vào chat. Hãy lưu secret dưới dạng [credential](https://docs.cloudthinker.io/vi/guide/credentials.md).

## Ai được làm gì

| Hành động | Ai |
| - | - |
| Xem và tìm kiếm bộ nhớ | Mọi thành viên workspace |
| Thêm bộ nhớ qua chat, **Tell memory something…** hoặc **Import** | Thành viên có quyền chat (không phải Viewer) |
| **Edit** hoặc **Delete** trực tiếp một mục | Workspace Admin |

Khóa Admin chỉ áp dụng cho chỉnh sửa trực tiếp. Bất kỳ thành viên nào có thể chat đều có thể yêu cầu CloudThinker thay đổi, xóa hoặc khôi phục một mục, và không có cài đặt nào hạn chế điều đó ngoài việc gán vai trò Viewer cho thành viên. Mỗi lần lưu được ghi vào lịch sử phiên bản của mục, kèm thành viên, agent và cuộc hội thoại liên quan. Để xem ai đã thay đổi một mục, hỏi trong chat: "Who changed the on-call handover item, and what did it say before?"

Xem [vai trò](https://docs.cloudthinker.io/vi/guide/security/roles.md) để biết cách gán vai trò.

## Xem bộ nhớ

**1. Mở tab Memory**

Vào **More → Workspace settings → Memory**.

**2. Tìm một mục**

Cuộn danh sách **Memory**, được nhóm theo loại và sắp xếp mới nhất trước, hoặc nhập vào **Search memory**. Mỗi dòng hiển thị tên mục (ví dụ `cost-report-routing`) do agent tạo mục đặt, cùng bản tóm tắt một dòng. Tìm kiếm khớp theo tên và tóm tắt, không theo toàn bộ chi tiết.

![Phần Memory trong Settings với ô tìm kiếm, nút Import và các mục bộ nhớ được nhóm theo Workspace, Feedback và Project](https://mintcdn.com/cloudthinker/kDOnb6IbyYQOYKZj/images/memory/01-memory-settings.jpg?fit=max\&auto=format\&n=kDOnb6IbyYQOYKZj\&q=85\&s=9d0e9e774da24e7bbc4d82f4d4b4c3ba)

**3. Mở mục**

Nhấn vào một dòng để xem **Last updated**, **Summary** một dòng và **Details** dạng Markdown.

![Một mục bộ nhớ mở trong Settings với tóm tắt, chi tiết Markdown, nút Edit và Delete và ô Ask CloudThinker to change this](https://mintcdn.com/cloudthinker/kDOnb6IbyYQOYKZj/images/memory/02-memory-item.jpg?fit=max\&auto=format\&n=kDOnb6IbyYQOYKZj\&q=85\&s=6a23193492d4770e31e6f044433371be)

**Trạng thái thành công:** bạn thấy từng thông tin CloudThinker dùng về workspace và thời điểm thay đổi gần nhất. Trang này cũng chứa các điều khiển [Dreaming](https://docs.cloudthinker.io/vi/guide/memory-dreaming.md) và **Run history**.

## Dạy hoặc sửa bộ nhớ

Cách nhanh nhất để thay đổi bộ nhớ là nói với CloudThinker, trong bất kỳ chat nào hoặc từ tab Memory. Mỗi chỉnh sửa áp dụng cho mọi cuộc hội thoại sau đó trong workspace.

| Ở đâu | Làm gì | Kết quả |
| - | - | - |
| Bất kỳ chat nào | Nêu thông tin hoặc chỉnh sửa bằng ngôn ngữ thông thường | CloudThinker cập nhật mục khớp, hoặc tạo mục mới nếu không có. Câu trả lời hiển thị bước **Saved to memory** hoặc **Updated memory** |
| **Tell memory something…** (cuối tab Memory) | Nhập ghi chú và gửi | Một Memory chat mở ra, lưu ghi chú vào đúng mục và liệt kê những gì đã thay đổi |
| **Ask CloudThinker to change this…** (trong một mục) | Mô tả thay đổi | Một Memory chat mở ra, sửa mục đó và liệt kê những gì đã thay đổi |

```text theme={null}
Forget that we exempt the staging cluster from rightsizing.
Cost reports go to #finops now, not email.
Our on-call handover is Fridays at 16:00 UTC.
```

Nếu câu trả lời không có bước **Saved to memory** hoặc **Updated memory**, mở **More → Workspace settings → Memory** và kiểm tra thời gian **Last updated** của mục.

## Sửa hoặc xóa một mục

Workspace Admin có thể thay đổi trực tiếp một mục mà không cần chat. Các thành viên khác thấy **Edit** và **Delete** bị khóa và dùng **Ask CloudThinker to change this…** thay thế.

**1. Mở mục**

Trong **More → Workspace settings → Memory**, nhấn vào mục.

**2. Sửa mục**

Nhấn **Edit**. Thay đổi **Summary** (một dòng, tối đa 200 ký tự), **Type** hoặc **Details (Markdown)**, rồi nhấn **Save**. Tên do agent tạo mục đặt và không sửa được ở đây. Để đổi tên mục, hỏi CloudThinker trong chat.

![Trình sửa mục bộ nhớ với các trường Summary, Type và Details cùng nút Cancel và Save](https://mintcdn.com/cloudthinker/kDOnb6IbyYQOYKZj/images/memory/03-memory-edit.jpg?fit=max\&auto=format\&n=kDOnb6IbyYQOYKZj\&q=85\&s=92b01e3bfc0753d19e6cbd7fda1b1321)

**3. Hoặc xóa mục**

Nhấn **Delete** và xác nhận **Delete this memory item?**. CloudThinker quên mục này với mọi thành viên. Một bản sao vẫn nằm trong lịch sử phiên bản.

**Trạng thái thành công:** mục hiển thị tóm tắt mới và thời gian **Last updated** đã cập nhật, hoặc biến mất khỏi danh sách.

Không có nút khôi phục cho mục đã xóa hoặc sửa sai. Thay vào đó, hỏi trong chat và nêu tên mục: "Restore the cost-report-routing memory item from its history." Bất kỳ thành viên nào có thể chat đều làm được điều này. Lịch sử mặc định giữ tối đa 20 phiên bản cho mỗi mục và loại bỏ phiên bản cũ nhất khi có thay đổi mới, nên hãy khôi phục sớm. Không có hết hạn theo thời gian và không có chức năng xuất. Với bản cài đặt self-hosted, instance admin có thể thay đổi số phiên bản.

### Nếu secret lọt vào bộ nhớ

Import và agent được hướng dẫn bỏ qua secret, nhưng agent tự quyết định thế nào là secret, nên secret vẫn có thể lọt vào.

1. Xóa mục, hoặc yêu cầu CloudThinker xóa secret khỏi mục.
2. Xoay vòng secret trong hệ thống sở hữu nó. Xóa mục không loại bỏ các bản sao đã có trong lịch sử phiên bản, và ứng dụng không có chức năng xóa sạch chúng, nên hãy coi secret đã bị lộ. Để hỏi về việc xóa khỏi lịch sử, gửi email tới [support@cloudthinker.io](mailto:support@cloudthinker.io) kèm tên mục.
3. Lưu giá trị mới dưới dạng [credential](https://docs.cloudthinker.io/vi/guide/credentials.md).

## Nhập bộ nhớ từ công cụ AI khác

Mang theo những gì một trợ lý khác đã biết về nhóm bạn, để không phải bắt đầu từ đầu.

**1. Mở Import**

Trong **More → Workspace settings → Memory**, nhấn **Import** (hoặc dấu **+** trong ô **Tell memory something…**). Hộp thoại **Import memory to CloudThinker** mở ra.

**2. Sao chép prompt**

Nhấn **Copy** và dán prompt vào chat với công cụ AI khác. Prompt yêu cầu công cụ đó xuất mọi thứ công cụ đó biết về nhóm, hạ tầng, dự án và quy ước của bạn dưới dạng Markdown.

**3. Dán hoặc tải lên câu trả lời**

Dán câu trả lời vào ô văn bản, hoặc kéo tệp vào vùng thả. Văn bản dán giới hạn 200.000 ký tự; tải nội dung dài hơn lên dưới dạng tệp. Bạn có thể thêm tối đa 5 tệp mỗi lần nhập ở định dạng **.md**, **.txt**, **.json**, **.csv** hoặc **.pdf**.

![Hộp thoại Import memory to CloudThinker với prompt để sao chép, ô dán và vùng thả tệp](https://mintcdn.com/cloudthinker/fFtvN0qrQ7D6xwRz/images/memory/04-import-memory.jpg?fit=max\&auto=format\&n=fFtvN0qrQ7D6xwRz\&q=85\&s=043e85c95aae09bd794685ff94b8eeaa)

**4. Thêm vào**

Nhấn **Add to memory**. Một Memory chat mở ra và CloudThinker chia nội dung thành các mục, gộp với những gì đã có và bỏ qua secret và credential. Memory chat (từ **Import**, **Tell memory something…** hoặc **Ask CloudThinker to change this…**) là chat thông thường và dùng credit như chat thông thường. Xem [Mức sử dụng](https://docs.cloudthinker.io/vi/guide/billing/usage.md).

**Trạng thái thành công:** Memory chat kết thúc với danh sách các mục đã tạo hoặc thay đổi, và chúng xuất hiện trong **More → Workspace settings → Memory**.

## Giới hạn

| Mục | Giá trị |
| - | - |
| **Summary** | Một dòng, tối đa 200 ký tự |
| **Details** | Tối đa 20.000 ký tự Markdown |
| Nội dung nạp vào mỗi cuộc hội thoại | Chỉ mục bộ nhớ (mỗi mục một dòng, 200 dòng đầu) và sở thích cá nhân. Các dòng sau dòng 200 không được nạp, nhưng agent vẫn có thể tìm kiếm các mục đó. Agent chỉ mở toàn bộ chi tiết của mục khi công việc cần |
| Mục task trong chỉ mục | Tối đa 20. Khi đạt 20, agent bỏ dòng của một task đã xong hoặc ít liên quan hơn để nhường chỗ. Bản thân mục task vẫn còn và vẫn tìm kiếm được |
| Số mục hiển thị trong **More → Workspace settings → Memory** | 150 mục được cập nhật gần nhất |

## Hỏi về các cuộc hội thoại trước

Agent có thể tìm kiếm và đọc các cuộc hội thoại trước đó trong cùng workspace và dùng chúng làm bằng chứng. Hỏi "Which chats last week mentioned the payments RDS instance?", hoặc dán link chat CloudThinker và yêu cầu agent tiếp tục từ đó.

Tìm kiếm bao gồm hội thoại của mọi thành viên trong workspace, không chỉ của bạn, nên hãy xem như cả nhóm đều đọc được chat trong workspace. Tìm kiếm không bao giờ đi tới workspace khác, hội thoại đã xóa hoặc cuộc hội thoại hiện tại của bạn. Không thể đánh dấu hội thoại là riêng tư hoặc loại trừ, nên xóa là cách duy nhất để giữ hội thoại khỏi kết quả tìm kiếm. Hướng dẫn cũ tìm thấy theo cách này được coi là thông tin nền, nên yêu cầu hiện tại của bạn luôn được ưu tiên.

## Gợi ý prompt trong ô soạn thảo

Khi các cuộc hội thoại gần đây còn bước tiếp theo chưa làm, ô soạn chat trống hiển thị tối đa ba prompt gợi ý, mỗi prompt gắn với cuộc hội thoại nguồn. Gợi ý dựa trên khoảng một tuần hoạt động gần nhất của workspace. Gõ chữ sẽ lọc các gợi ý.

| Hành động | Kết quả |
| - | - |
| Nhấn một gợi ý | Prompt được chèn kèm một dòng ngữ cảnh trỏ tới cuộc hội thoại nguồn. Giữ dòng đó để agent có thể đọc |
| Nhấn **x** trên một gợi ý | Gợi ý không bao giờ xuất hiện lại với bạn. Đồng đội vẫn thấy, và bộ nhớ không thay đổi |

Không có cài đặt workspace để tắt gợi ý. Instance admin (người vận hành bản cài đặt CloudThinker self-hosted; với CloudThinker cloud, gửi email tới [support@cloudthinker.io](mailto:support@cloudthinker.io)) có thể tắt gợi ý cho toàn bộ instance.

## Khắc phục sự cố

> **Tab hiển thị Memory is not ready yet**
>
> Không đọc được bộ nhớ workspace vào lúc đó. Các mục của bạn vẫn an toàn. Nhấn **Retry** sau vài giây.

> **Memory is updating. Showing the last saved copy.**
>
> Một chat hoặc lượt chạy Dreaming gần đây đã ghi vào bộ nhớ và danh sách chưa cập nhật kịp. Trang tự làm mới vài giây một lần cho đến khi phiên bản mới hiển thị.

> **Khi lưu hiển thị This item changed since you opened it**
>
> Dreaming hoặc một chat đã sửa mục trong khi bạn đang mở. Nhấn **Reload** để xem phiên bản mới, rồi thực hiện lại thay đổi. Các chỉnh sửa chưa lưu của bạn sẽ bị thay thế.

> **Edit, Delete hoặc Import bị khóa**
>
> **Edit** và **Delete** cần vai trò workspace Admin. **Import** và **Tell memory something…** cần quyền chat, mà Viewer không có. Hãy nhờ một workspace Admin.

> **Agent vẫn dùng thông tin cũ sau khi tôi đã sửa**
>
> Có thể một mục khác vẫn chứa thông tin cũ. Nhập một từ khóa của thông tin đó vào **Search memory**, rồi sửa hoặc xóa mục mâu thuẫn (hoặc yêu cầu CloudThinker làm). Nếu thông tin cũ quay lại vào sáng hôm sau, mở lượt chạy gần nhất trong **Run history** của [Dreaming](https://docs.cloudthinker.io/vi/guide/memory-dreaming.md): bản tóm tắt liệt kê các mục lượt chạy đó đã ghi. Thêm một hướng dẫn trọng tâm nêu rõ thông tin đúng.

> **Danh sách hiển thị No memory yet**
>
> CloudThinker chưa lưu gì cho workspace này. Chat với CloudThinker về môi trường của bạn, gửi ghi chú qua **Tell memory something…**, hoặc nhập từ công cụ khác.

## Câu hỏi thường gặp

> **Bộ nhớ theo người dùng hay theo workspace?**
>
> Theo workspace. Hội thoại của mọi thành viên đều đọc và ghi cùng một bộ nhớ. Chỉ việc ẩn gợi ý prompt là riêng của từng người.

> **Tôi có thể tắt, xóa sạch hoặc xuất bộ nhớ không?**
>
> Không theo từng workspace. Workspace có thể tắt [Dreaming](https://docs.cloudthinker.io/vi/guide/memory-dreaming.md), nhưng không tắt được bản thân bộ nhớ. Instance admin có thể tắt bộ nhớ workspace cho toàn bộ instance. Không có chức năng xóa hàng loạt hoặc xuất: xóa từng mục trong **More → Workspace settings → Memory**, hoặc yêu cầu CloudThinker xóa trong chat.

> **Bộ nhớ khác knowledge base thế nào?**
>
> Bạn tải tài liệu lên [knowledge base](https://docs.cloudthinker.io/vi/guide/knowledge.md) và agent tìm kiếm khi cần. Bộ nhớ do agent ghi từ những gì học được khi làm việc, và tự động nạp vào mọi cuộc hội thoại.

## Bước tiếp theo

> **[Dreaming](https://docs.cloudthinker.io/vi/guide/memory-dreaming.md)**
>
> Điều khiển lượt chạy hằng đêm gộp và tinh gọn bộ nhớ

> **[Knowledge Base](https://docs.cloudthinker.io/vi/guide/knowledge.md)**
>
> Tải lên runbook và tài liệu để agent tìm kiếm

> **[Incident Memory](https://docs.cloudthinker.io/vi/guide/incident/incident-memory.md)**
>
> Tái sử dụng bài học từ các cuộc điều tra trước trong Resolve

> **[Agent](https://docs.cloudthinker.io/vi/guide/agents/overview.md)**
>
> Xem cách CloudThinker và agent tùy chỉnh dùng bộ nhớ


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