04 / Agent và pack
Agent, nhóm, pack và Soot Forge
Một Soot nằm trong file thế nào; pack và cấp quyền; nhóm, Lead, Đầu mối; Soot Forge, source và bundle.
Trang này nói về những thứ người ta tạo ra và phân phối trên Soot: một Soot là gì khi nằm trong file, pack đưa skills và tools vào Soot ra sao, nhiều Soot làm chung thành nhóm thế nào, và Soot Forge giữ pack, mẫu nhóm cùng bản phát hành ở đâu. Vấn đề cần giải: một agent phải đọc được, review được, chép sang máy khác được, mà quyền của nó vẫn do chủ máy quyết.
Mô hình
Soot Forge (catalog + release, SHA-256) repo của bạn (source)
│ pack, mẫu nhóm, General │ Soot, pack riêng, nhóm, lịch
▼ ▼
packs_dir/<id>/ ─ chọn ─► soots/<id>/soot.json ◄─ deploy theo source
(cài, chưa cấp gì) (soul, mission, packs)
│ needs │ nhóm: entries + members
▼ ▼
grants.packs ◄── host cấp groups.<id> ── Đầu mối nhận việc đầu tiên
(deployment.json) │
▼
spawn_subagent (AgentCore) ─► đồng đội trong cùng runtime
Lead: trợ lý riêng của người dùng, một cái mỗi server, không thuộc nhóm nào.Ba nguyên tắc: cấu hình là file (Soot, pack, nhóm là thư mục JSON và Markdown, để trong Git được); ghép phẳng lúc nạp (Soot liệt kê pack, loader gộp thành một danh sách, không kế thừa); cài không phải cấp (có file trong packs_dir không làm Soot nào làm được thêm gì, Soot phải chọn và host phải cấp).
Khái niệm
| Khái niệm | Là gì |
|---|---|
| Soot | Một agent nhỏ có việc rõ: soul (danh tính), mission (nhiệm vụ), pack nó chọn, model tier. Thư mục soots/<id>/. |
| Pack | Gói skills và tools dùng lại được, kèm needs (cần gì từ máy). Thư mục packs/<id>/ có pack.json. |
| Tool | Thao tác thực thi được (executable) hoặc native tool của host. Operation ID là <pack>_<tool>. |
| General | Soot mặc định của mọi workspace và Nest, tạo từ preset do Soot Forge phát hành. |
| Nhóm (group, team) | Danh sách Soot làm chung kèm giới hạn phối hợp. Là ranh giới thực thi, không phải danh tính agent khác. |
| Đầu mối | Soot đầu tiên trong entries của nhóm; nhận việc đầu tiên, không có quyền quản trị. |
| Lead | Trợ lý riêng của người dùng trong Nest. Một cái mỗi server, tên cố định, không thuộc nhóm nào. |
| Mẫu nhóm | Công thức dựng một nhóm. Trong Nest gọi là Mẫu Soot. |
| Soot Forge | Repo 2found/soot-forge: catalog pack, catalog mẫu nhóm, preset General, bản phát hành có SHA-256. |
| Source | Lát cấu hình (Soot, pack riêng, nhóm, lịch) do một repo sở hữu, deploy lên runtime dùng chung. |
Ba loại cấu hình, ba người sở hữu
Câu hỏi nào thì sửa chỗ đó:
| Câu hỏi | Nơi | Chủ |
|---|---|---|
| Tôi là ai, làm gì, dùng pack nào? | Thư mục Soot (soots/<id>/: soot.json, SOUL.md, MISSION.md) | Tác giả agent |
| Tôi cung cấp skills, tools gì, cần gì từ máy? | Pack (packs/<id>/pack.json) | Tác giả pack |
| Chạy ở đâu, kết nối bằng gì, ai được cấp gì, nhận việc khi nào? | Deployment (deployment.json, AI settings, vault) | Host (operator) |
Soot không chứa secret, listener, route, lịch hay quyền với tài khoản ngoài. Pack không chứa danh tính, soul, mission, route hay giá trị credential. Nhờ vậy cùng một pack dùng cho nhiều Soot, cùng một Soot chạy được trên máy khác, và quyền luôn nằm ở một chỗ để người ta xem.
Một Soot là code
Một Soot là một thư mục, tên thư mục là ID:
soots/support/
soot.json cài đặt: tên, model, pack, chat, giới hạn chạy
SOUL.md danh tính và cách cư xử ({{name}} là tên hiển thị)
MISSION.md việc phải làm
skills/**/SKILL.md skill của riêng Soot, theo chuẩn Agent Skills (cả skill Soot tự lưu bằng save_skill)
packs/<pack>/ pack riêng chỉ Soot này thấy (chỉ skills)
evals/ case kiểm tra hành vi của riêng Soot này
adapter/ phần đã học (soot improve, soot train), phủ lên định nghĩaMỗi file có thì dùng, không có thì thôi; không field nào trỏ tới chúng. soot.json chỉ còn phần chọn:
{
"name": "Hỗ trợ",
"description": "Trả lời khách từ kho tài liệu",
"avatar": "fox",
"model": "pro",
"packs": ["office:read", "crm:tools=find,update", "knowledge", "feedback:to=pm"],
"chat": {"handoff": "members"},
"execution": {"max_turns": 16}
}| Field | Nghĩa |
|---|---|
avatar | tên mascot, URL https, hoặc data URL PNG/JPEG/WebP |
model | tier (flash, lite, pro, max), provider do host quyết; hoặc object {tier, compact_at, effort, …} để đè riêng cho Soot này. Không ghi effort thì DeepSeek suy nghĩ ở high, Claude 4+ ở medium; "none" tắt suy nghĩ |
packs | mọi thứ Soot làm được, kể cả hai pack có sẵn: knowledge (mọi pool tri thức của host, hoặc knowledge:pools=docs,faq) và feedback:to=<soot> (tool record_feedback, ghi chú chuyển cho Soot đó) |
chat | có thì Soot nhận hội thoại: publish (final mặc định, hoặc reply), mode, handoff, release_after_hours, memory_write, channels |
execution, improve, archived | giới hạn chạy, lịch tự cải thiện, lưu trữ |
Không có field cho ID, soul, mission, skill, adapter, tool hay project: ID là tên thư mục, prose là file, tool đến từ pack, project đến từ nhóm. evals/ đi cùng Soot nên review code là review luôn cách kiểm tra; soot improve và soot train đọc đúng kho đó và ghi cái học được vào adapter/ (evolution.md). Field đầy đủ có ở soot schema soot.
skills/**/SKILL.md theo chuẩn Agent Skills: tên lấy từ frontmatter name:, thiếu thì lấy tên thư mục; tên sai hay trùng là lỗi soot check, không bị bỏ qua lặng lẽ. Pack cũng quét skills/**/SKILL.md của riêng nó, và một thư mục chỉ có skills/ dưới packs_dir là pack không cần pack.json. packs/<pack>/ trong thư mục Soot là pack riêng (chỉ skills, grants vẫn ở deployment). Frontmatter requires-tools: (ví dụ [writing_export]) kê các tool mà thiếu thì không làm theo skill được: Soot không giữ đủ các tool đó thì skill không vào danh sách của nó, như skill chỉ dẫn tool ghi của một pack được chọn :read.
Soot cố ý không đọc AGENTS.md hay .agents/. Theo agentsstandard.com và Codex, đó là luật cho coding agent: chúng nạp mọi AGENTS.md từ gốc repo xuống thư mục đang làm việc, và .agents/skills. Nếu Soot cũng đọc chúng thì nhiệm vụ của Soot thành luật của coding agent, còn hướng dẫn đóng góp của repo thành nhiệm vụ của Soot.
Chuyển một agent Codex sang Soot:
| Codex / agentsstandard | Soot (soots/<id>/) |
|---|---|
AGENTS.md (luật cho agent) | đổi tên thành MISSION.md |
.agents/skills/<tên>/ | copy vào skills/<tên>/, giữ nguyên SKILL.md |
| skill dùng chung nhiều agent | copy vào packs_dir/<pack>/skills/, không cần pack.json |
| MCP server, lệnh shell | tool trong pack có pack.json, rồi soot grant <pack> |
Ghép phẳng lúc nạp
deployment.json là điểm vào và chỉ liệt kê đường dẫn tới định nghĩa Soot, không chứa agent inline. Loader (internal/core/config, loadConfig) đọc deployment và AI settings, đọc các Soot và source, chọn pack cho từng Soot, kiểm grants.packs, nạp packs_dir, rồi gắn credential binding cho từng operation. Kết quả là một danh sách phẳng: mỗi Soot có đúng skills và tools của pack nó chọn.
Một Soot chọn pack theo ba cách:
| Tham chiếu | Soot nhận |
|---|---|
"office" | Mọi skill và mọi tool của pack |
"office:read" | Mọi skill và chỉ tool đọc |
"office:tools=plan,draft" | Mọi skill và chỉ các tool được liệt kê |
Pack là đơn vị bật tắt, nên ranh giới quan trọng (shell, quản trị, đăng bài, ghi dữ liệu) là một pack riêng, và pack ghi nên để phần đọc dùng độc lập được. tools= chỉ để Soot khỏi mang hết schema của pack lớn, không cấp thêm quyền.
Không có use hay capabilities (recipe lồng trong pack): loader từ chối chúng. Muốn tách quyền thì tách pack.
Pack và quyền
pack.json needs: {credentials: {API_KEY: {from: "env:STATUS_API_KEY"}}, env: ["HOME"]}
│ khai báo
deployment grants.packs: {"status": {credentials: {API_KEY: "env:STATUS_API_KEY"}, env: ["HOME"]}}
│ host cấp (soot add, soot grant, Nest "Cấp quyền")
runtime tool nhận đúng biến đó, không hơn"Cài không phải cấp" có mấy hệ quả:
soot addchép file vàopacks_dir, ghi nguồn, in thứ pack cần và cấp phần phía host vàogrants.packs(--no-grantđể cấp sau). Nó không chạy script, không build, không khởi động adapter, không chọn pack cho Soot nào.- Soot chỉ có pack khi tự liệt kê nó. Đầu mối hay Soot khác chỉ yêu cầu được cấp; việc cấp luôn qua người duyệt. Credential kiểu
operatordo người dùng nhập ở Nest. - Cập nhật pack không mở rộng quyền: bản cần nhiều hơn quyền đang có bị giữ tới khi người xem bản xem trước và cấp.
Pack chia theo đơn vị người dùng muốn bật hoặc tắt cùng nhau: tách khi integration, dependency, vòng đời phát hành hoặc mức rủi ro cần độc lập. Hợp đồng thực thi (tool là process, envelope soot/v1, approval, effect chưa rõ), giao diện, page và storage của pack là phần mở rộng, xem extensions.md.
General
General là Soot mà soot spawn và Nest tạo sẵn. Nó không nằm cứng trong binary: mỗi release Soot Forge phát hành general-release_<v>.tar.gz (định nghĩa) và general-preset_<v>.json. Preset nói pack nào cần tải (install), lấy từ đâu (sources), General chọn pack nào (packs), và Nest cộng thêm gì (nest.packs: soot-nest, nest-lead). Pack toolbox (file, tìm kiếm, web, shell) do runtime cung cấp sẵn trong binary: preset chỉ liệt kê nó trong packs, không bao giờ trong install, nên không có gì để tải, cập nhật hay gỡ, và workspace không cần thư mục packs/toolbox (thư mục cũ còn sót thì bị bỏ qua, pack dựng sẵn thắng). Soot chọn toolbox, toolbox:read hay toolbox:tools=a,b như mọi pack.
Thứ giải thích hay vận hành một tính năng của runtime thì đi kèm runtime (builtin/corepacks/), để không lệch khỏi binary; kiến thức nghiệp vụ ở lại Forge. Theo cách đó soot (tool configure và save_skill), nest-lead (tool và skill của Lead) và soot-nest (side-bar, nest-pieces, nest-links) cũng có sẵn như toolbox. Preset vẫn liệt kê ba pack này trong install và nest.packs cho runtime cũ; runtime này không tải chúng, và Soot chọn chúng như trước. Hai skill gắn theo vai, không cần chọn và không có cấu hình: soot-domain cho mọi Soot, coordinator-mail cho mọi Soot trong một đội (Đầu mối và thành viên, nơi việc gửi tới đội đến). Skill chỉ tốn một dòng trong danh mục skill, nội dung đọc khi cần, và không cấp quyền gì.
Tạo workspace tải archive, kiểm SHA-256, cài pack rồi ghi một cấu hình phẳng. Từ đó workspace không phụ thuộc preset: mở Nest lại không khôi phục quyền đã thu hồi, pack mới chỉ vào qua cập nhật. Thiếu release asset thì tạo thất bại hẳn, không lùi sang checkout cạnh bên hay tải không kiểm. Nest tạo mới ghi lead: "general", nên General là Lead của Nest đó. soot spawn --empty tạo Soot trống không pack; --project và --source không tải gì (xem Bundle và Source).
Nhóm
Người dùng chọn một Soot và giao việc. Khi Soot có nhóm được cấp, nó tự chọn nhóm hợp cho từng việc như chọn một tool; việc đơn giản thì trả lời thẳng.
Người dùng ─► Soot đã chọn (root, chat tự động)
│ spawn_subagent group/<id> (AgentCore)
▼
nhóm A: Đầu mối ─► đồng đội (named delegate)
│ kết quả + bằng chứng
▼
câu trả lời tổng hợpChỉ có một đường thực thi. AgentCore sở hữu vòng lặp model, job, ngân sách, retry, hủy và subagent; Soot chỉ gắn cấu hình, quyền, storage và công cụ. Không có dispatcher nhóm thứ hai hay "orchestrator" riêng; hướng dẫn phối hợp chung nằm trong schema của spawn_subagent, pack skill chỉ mang chuyên môn.
Một nhóm khai entries (ai nhận chat, phần tử đầu là Đầu mối), members (roster), description (để delegation biết khi nào chọn), limits (số delegation, độ sâu, concurrency, model call) và tùy chọn brief, projects, contract (workspace.md). Field đầy đủ: soot schema deployment.
Nhóm không cấp quyền
Quy tắc quan trọng nhất: nhóm không mở rộng hay thu hẹp quyền của thành viên. Mỗi thành viên chạy với chính Soot của nó (packs, credentials...). Các field cũ group_operations, members.<id>.operations, members.<id>.credentials bị loader từ chối (retired_field) thay vì bị bỏ qua, để deployment cũ không vô tình rộng quyền. Nhóm chỉ quyết ba thứ: ai nhận chat và ai được gọi, giới hạn phối hợp chung (giao với ngân sách gốc của Soot đầu vào), và phạm vi dữ liệu (group_id trong envelope tool do host điền, model không chọn được; backend của credential phải tự giới hạn dữ liệu).
Một lượt chạy nhóm còn theo các quy tắc sau:
- Nhóm nhận yêu cầu gốc của người dùng, không nhận
taskhaycontextdo Soot gốc tự viết, nên văn bản do model sinh không mang dữ liệu nhóm này sang nhóm khác. - Lịch sử native, memory và artifact tách theo hội thoại, nhóm và Soot; không chuyển giữa nhóm. Hội thoại ghi mọi nhóm đã đóng góp; muốn đọc lại phải có quyền với tất cả, mất quyền một nhóm thì cả hội thoại trộn bị ẩn.
- Mỗi lượt đóng băng đích đến và fingerprint cấu hình; cấu hình đổi giữa chừng thì việc xếp hàng bị chặn, không tự mở rộng. Effect chưa rõ không tự chạy lại.
- Host shell không phải sandbox: thành viên có shell vẫn có shell trong nhóm.
Đồng đội mà delegation gọi phải ở cùng runtime với Soot gốc, vì định danh, grants, store và receipt là của một runtime. Ngoại lệ hẹp là nhóm remote (runtime khác phục vụ): nó nhận hợp đồng dữ liệu và việc gửi tới (send, contracts/team-mail.md), không phải đích chat hay delegation (workspace.md).
Chat có hai chế độ, không đổi sau khi tạo: tự động (group_id: "auto", Soot chọn nhóm cho từng việc, vẫn một chat) và ghim (nhóm cố định). Thư mục sidebar không cấp quyền. Cấu hình cũ collaboration.<soot>.members vẫn chạy cho chat cũ, không tự chuyển vào nhóm.
Trong Nest, Đội Soot → Tạo nhóm dựng nhóm; lưu là revision nháp, Áp dụng đợi việc đang chạy xong. Chỉ operator sửa được quyền nhóm (surfaces.md).
Lead và Đầu mối
Lead là trợ lý riêng của người dùng trong Nest: một cái mỗi server, không bao giờ thuộc nhóm, có quyền quản trị (nest-lead_manage; việc cần tiền, ngân sách hay đổi quyền chờ người ở Cần bạn). Đầu mối là Soot đầu tiên trong entries của một nhóm: nhận việc đầu tiên, chạy lịch và bot của nhóm, giao task cho đồng đội, và không có quyền quản trị. Lead cấu hình bằng lead trong deployment; Đầu mối chỉ là thứ tự entries.
Việc gửi tới đội (send, workspace.md) do host định tuyến, không tốn lượt model: việc cho team:<id> chạy bằng Đầu mối; việc cho soot:<thành viên> chạy bằng chính thành viên, trong đội, với công cụ và quyền của nó, ngân sách của đội và daily_tokens, max_run_tokens của nó. Lịch chỉ-tool của một thành viên, khi wake_when đúng, đánh thức thành viên đó; chuỗi tool lỗi mới đánh thức Đầu mối. Đội đặt inbox: "hold" thì việc từ đội khác chờ người bắt đầu.
Lead nhận ra qua pack nest-lead, không qua tên. Roster có liệt kê Lead thì vẫn nạp nhưng bỏ Lead ra; lịch, bot và task của nhóm không bao giờ chạy bằng Lead. Nest mở mà chưa có Lead thì thêm một Soot lead: pack nest-lead và lời dặn của Lead đi kèm runtime; các pack còn lại theo General của workspace, hoặc theo preset General của release Forge (kiểm SHA-256) khi workspace chưa từng có chúng. Hợp đồng đầy đủ: contracts/lead.md.
Mẫu nhóm
Mẫu nhóm (soot/group-template/v1 đến v3) là cách phân phối "một đội dựng sẵn": thành viên với soul và mission, pack họ cần (archive kèm SHA-256), credential cần nối. Từ v2 có inputs (câu hỏi cần xác nhận), profiles (ngân sách token mỗi thành viên) và schedules chạy dưới tên Đầu mối; mẫu có thể để root: "" để người dùng chọn Đầu mối lúc cài. v3 thêm hợp đồng nhóm và lịch chạy chuỗi tool không cần model.
Mẫu không chứa deployment đang chạy, provider, credential, lịch sử hay DB, và không cấp gì ngoài pack nó nêu tên. Có hai đường cài, cùng ra một thay đổi cấu hình:
- Hỏi Lead trong chat. Lead đọc catalog Forge đã xác thực (offline thì chỉ mẫu trên máy), hỏi
inputs, đề xuất profile, rồi gọigroup.create. Thẻ Cần bạn liệt kê nhóm, Đầu mối, thành viên, trần token, chu kỳ và brief. Duyệt thì cài archive nếu thiếu và lưu mọi thứ trong một revision; Hoàn tác lưu trữ các Soot đó và gỡ nhóm. - Tạo nhóm trong Nest, hoặc CLI
soot group add|inspect|create.
Credential của mẫu gắn theo tham chiếu vào kho credential công cụ của host; người dùng nhập giá trị sau. soot group save và export lưu nhóm đã chỉnh thành mẫu mới (không đọc credential hay transcript). Đưa lên Forge là PR.
Soot Forge
Soot Forge là nơi công khai để tìm, cài và chia sẻ thứ Soot dùng được; trang trysoot.com/forge dựng từ catalog.json của repo.
Repo gồm catalog.json (catalog pack, viết tay), groups.json (catalog mẫu nhóm, tách riêng), packs/, groups/ và general/ (preset).
- Đóng góp bằng PR: pack nằm trong repo, hoặc một mục catalog trỏ tới repo công khai, thư mục và full commit đã review. Pin commit để đổi branch không đổi pack đã review.
- Mỗi release dựng một archive cho từng mục, kèm
SHA256SUMS; tag và asset đã phát hành không đổi. Runtime lấy release ổn định mới nhất và kiểm SHA-256 trước khi ghi. Pack cài từ URL asset của Forge để lại receipt trỏ về đó, nhờ vậy cập nhật tự động biết nó là pack Forge. - Catalog là metadata, không phải quyền: đọc entry hay cài pack không cấp gì cho Soot nào. CI của Forge kiểm quy tắc (mỗi tool khai
run.mode, mọi{{cred:NAME}}có trongneeds). Checksum cho biết byte nhận được, không xác thực người phát hành. toolboxkhông có trên Forge: runtime cung cấp nó (manifest nhúng ởbuiltin/toolbox/pack.json). Nest liệt kê nó là "có sẵn trong runtime";soot addvàsoot pack addtừ chối cài nó.soot,nest-lead,soot-nestcũng vậy (builtin/corepacks/); Forge còn giữ bản của chúng và skillcoordinator-mailtrongteam-rhythm, đánh dấu deprecated, cho runtime 0.21 trở về trước. Thư mụcpacks/<id>mà runtime cũ đã cài thì bị bỏ qua, skill cùng tên của một pack Forge nhường cho bản của runtime, vàsoot checkghi mỗi chỗ một note (không phải cảnh báo).- Cài ngoài Forge vẫn được (
soot addtừ Git hay archive), nhưng không được cập nhật tự động. Forge không phải marketplace trả tiền hay registry runtime.
Cập nhật
Một dịch vụ cập nhật duy nhất giữ bốn loại đồ cài tự mới: pack Forge, General, nhóm tạo từ mẫu Forge, và chính phần mềm Soot. Client (Nest, soot updates) chỉ hiển thị một tài liệu do dịch vụ trả; không client nào tự so version. Ba quy tắc:
- Chỉ bản không MAJOR tự áp dụng. MAJOR, kind đặt manual, mục bị chặn thì chỉ liệt kê và chờ
soot updates apply. - Không bao giờ ghi đè tay chỉnh. Nhóm được trộn từng field: field người dùng đã sửa được giữ, phần còn lại lấy bản mới. Đổi thành phần nhóm thì chờ.
- Cài không phải cấp. Bản làm một Soot hay nhóm rộng quyền hơn (pack mới, nhu cầu mới) không tự áp dụng mà chờ người đồng ý. Pack cài từ Git hay file không thuộc Forge nên đứng yên.
Lệnh: soot updates.
Source: nhiều repo, một runtime
Một runtime nhận Soot từ nhiều repo. Mỗi repo sở hữu một source và deploy độc lập; host giữ phần còn lại.
Mỗi repo chỉ ghi dưới sources.d/<id>/; deployment.json, AI settings, vault và Soot tạo trong Nest thuộc host.
| Của host | Của source |
|---|---|
| Listener, provider AI, tier, vault, data pool | Soot (chỉ chọn tier trong model), pack riêng |
default_soot, lead, routes, grants.sources | Nhóm, client website, lịch gắn Soot hoặc nhóm của source |
| Soot tạo trong Nest | Soot của source sửa trong Nest để thử nhanh, nhưng hiện drift tới khi repo deploy lại |
Lý do chia: thêm hay đổi provider không bao giờ cần deploy lại một source, và deploy một source không bao giờ chạm provider hay source khác. Quy tắc giữ ranh giới đó: source chỉ chọn tier chứ không chọn provider; ID là toàn runtime; source không mang secret. Soot của source liệt kê pack trong packs như mọi Soot; pack nào source không mang theo (ví dụ trình duyệt của máy) là lời xin host, và host cho hay không trong grants.sources. Xin chưa phải được.
soot spawn --source <id> tạo source, soot bundle kiểm, soot source deploy đưa lên Nest trên máy này, hoặc 2srv deploy cho runtime do 2server quản lý. Deploy là prepare rồi commit, chỉ ghi dưới sources.d/<id>/, không có rollback riêng (deploy lại commit cũ). Gỡ source là deploy source rỗng; hội thoại và lịch sử còn. Cải thiện Soot của source không tạo drift: bản đã học ở .soot/adapters/ ngoài lát, kéo về repo bằng soot improve <soot> --pull --into <repo>.
Project bundle
soot spawn --project <root> tạo một project ở dạng file: deployment, AI scripted để kiểm cục bộ, một Soot support không có grant, schema, hướng dẫn cho coding agent, .env.example chỉ có placeholder, và soot.bundle.json. Nó không cài gì, không chạy runtime.
soot.bundle.json (C1 v1) là bản kê có digest của phần authored. Mỗi pack ghim ba giá trị khác nhau, không thay cho nhau: archive_sha256 (byte archive), tree_digest (cây file sau giải nén, tính cả bit thực thi) và nguồn (archive local hay Git với full commit). selected_executables phải đúng bằng các operation host thực sự cấp, nên cài một pack không thêm mục nào. source_digest bao cả manifest lẫn mọi file. Symlink, file đặc biệt và trạng thái riêng tư (.git, .env, *.db, *.pem...) bị từ chối.
soot bundle kiểm, --refresh ghi lại digest sau khi review sửa đổi có chủ đích, và soot bundle-admit là phía nhận: băm lại offline, không tin receipt, lệch thì từ chối chứ không sửa. Bundle không cấp quyền. Fixture: internal/compose/scaffold/testdata/c1-v1.json.
Ranh giới
AgentCore sở hữu vòng lặp model, job, ngân sách, hủy, subagent (runtime.md). Core (internal/core/config, internal/core/conversation) chọn pack, giao điểm quyền và đóng băng cấu hình mỗi lượt. Pack mang skill, tool, needs, giao diện, storage (extensions.md). Host giữ credential, listener, provider, grants.packs và quyền của nhóm. Nest vẽ roster, chat nhóm, thẻ Cần bạn (surfaces.md).
Cố ý không làm: dispatcher nhóm riêng (delegation là tool của AgentCore), để nhóm cấp quyền (dễ rộng quyền ngầm), để pack mang danh tính hay lịch (một pack phải dùng cho nhiều Soot), tin catalog (đọc, cài, cập nhật đều không cấp), viết agent mới vào core (thêm agent là thêm config, pack và skill).
Chưa có
Nhóm có thành viên ở runtime khác (hiện chỉ nhóm remote cho hợp đồng dữ liệu và việc gửi tới); rollback cho source (deploy lại commit cũ); đẩy mẫu nhóm từ Nest lên Forge (hiện là PR thủ công); pack tích hợp nền tảng ngoài (Telegram, Facebook, X, YouTube, TikTok) mới là dự kiến.
Nội dung được xem lại: 12.11.2026