Markdown edition

AI-translated from English; not yet reviewed by a fluent editor.

# Ibigay sa dalawang agent ang iisang nasuring memory record

> Mag-imbak ng isang typed memory record na aprubado batay sa pinagmulan, ibigay ang eksaktong nasuring byte nito sa dalawang awtorisadong session, saka tiyakin ang conditional update at lutasin ang salungatan.

By BIG CHANGE Editorial

Published: 2026-10-20T13:57:38.593Z
Updated: 2026-10-20T13:57:38.593Z
Canonical: https://bigchange.ai/blog/managed-agents-reviewed-memory-snapshot-guide

![Conceptual charcoal illustration of two separate laptops on a round table, each displaying the same five abstract text strokes with the third row orange.](https://bigchange.ai/api/media/file/reviewed-memory-two-sessions-hero-v3.png)
AI-generated conceptual illustration by BIG CHANGE.

Maaaring magpanatili ng teksto sa magkakaibang session ang mga memory store ng Managed Agents ng Anthropic. Para sa app na kailangang magbigay ng parehong nasuring katotohanan sa dalawang agent, unang hakbang lamang ang pag-iimbak. Dapat tukuyin ng app kung kanino ang record, suriin ang orihinal na ebidensiya, pumili ng isang nakaimbak na bersiyon at panatilihin ang eksaktong mga byte nito bago makita ng alinmang agent. Para ito sa mga developer na may awtorisadong Managed Agents beta access at kontrol sa authentication ng app, pagpili ng store at configuration ng agent. Batay ito sa [kasalukuyang dokumentasyon ng memory ng Anthropic](https://platform.claude.com/docs/en/managed-agents/memory) at mga API reference na sinuri noong 20 Oktubre 2026; hindi nagsagawa ang BIG CHANGE ng account o model test.

## Ang malaking pagbabago

- **Ano ang nagbago:** Maaaring manatili sa Managed Agents store ang isang nasuri at typed na JSON memory. Sinusuri ng app ang pinagmulan at eksaktong nakaimbak na byte, pinipirmi ang isang pribadong snapshot, saka ipinapadala ang parehong aprubadong byte sa dalawang hiwalay na awtorisadong session na walang nakakabit na memory store.
- **Bakit mahalaga:** Hindi mababago ng susunod na pag-edit sa store ang mga input na nabuo na para sa mga session na iyon.
- **Ano ang dapat bantayan:** Kailangan pa rin ng magkahiwalay na pagsusuri sa katumpakan ng pinagmulan, awtorisasyon ng gumagamit at kalidad ng sagot.

## Bago magsimula

Maghanda ng isang tunay na katotohanan, kagustuhan o tuntunin ng proyekto na may orihinal na pinahihintulutang gamitin, matatag na source ID at bersiyon, at may-aring pumapayag sa pag-iimbak at pagbabahagi sa dalawang papel ng agent. Magtakda muna ng angkop na hangganan ng bisa ng pagsusuri bago suriin ang record. Tiyakin ang Managed Agents beta access, pribadong API key, awtorisadong workspace, dalawang nakatalagang agent ID, environment at pinapayagang modelo sa account. Suriin ang kasalukuyang paggamit at presyo bago payagan ang apat na limitadong session ng mga tagatanggap sa prosesong ito. Huwag isama ang key sa mga mensahe o katibayan.

Kailangan ng app ng pagtutugma mula sa napatunayang identidad patungo sa saklaw. Sa pinagkakatiwalaang estado ng app, itali ang identidad sa aprubadong `ownerScopeId`, workspace ID, store ID at dalawang pinapayagang agent ID. Maghiwalay ng store para sa pribadong gumagamit o proyekto kung magkaiba ang tuntunin ng access. Hindi pinapatunayan ng workspace API key ang end user, hindi hangganan ng tenant ang path, at hindi kayang mag-alis ng tool o kredensiyal ang prompt. Tiyaking walang nakakabit na store ang dalawang configuration ng tagatanggap at walang connector, kredensiyal ng environment o daan sa tool patungo sa nababagong store. Kung hindi maitatatag ang hangganang iyon, huminto bago ipadala ang record.

## 1. Aprubahan ang record laban sa pinagmulan

Gamitin ang **istrukturang template** na ito at palitan ang bawat halaga sa angle bracket ng tunay na aprubadong ebidensiya. Hindi ito halimbawang katotohanan o inaangking resulta. Gawing iisang eksaktong UTF-8 JSON text ang kumpletong object bago aprubahan. Dapat tanggapin lamang ng validator ang mga field at uri na ito, tanggihan ang hindi kilalang field, mangailangan ng mga string na hindi puro puwang at wastong UTC timestamp, limitahan ang `kind` sa `fact`, `preference` o `project_rule`, at limitahan ang `status` sa `active`, `disputed` o `superseded`. Tanging mga record na `active` ang maaaring ipasok. Dapat tumugma ang aprubadong pahayag sa siniping orihinal, kasama ang petsa ng bisa at saklaw nito.

```json
{
  "schemaVersion": "memory-record/v1",
  "recordId": "<opaque stable record ID>",
  "ownerScopeId": "<trusted mapped scope ID>",
  "kind": "<fact | preference | project_rule>",
  "claim": "<precise source-supported claim>",
  "sourceId": "<private original-source ID>",
  "sourceRevision": "<original revision or exact source hash>",
  "sourceQuoteOrPointer": "<minimal permitted quote or stable pointer>",
  "validFrom": "<UTC timestamp>",
  "checkedAt": "<UTC timestamp>",
  "status": "active",
  "reviewerId": "<approved human reviewer ID>",
  "reviewedAt": "<UTC timestamp>"
}
```

Dapat tukuyin ng pribadong katibayan ng pag-apruba ng app ang tunay na nag-apruba, pahintulot ng may-ari, orihinal na pinagmulan at bersiyon, saklaw at pinapayagang agent, tuntunin ng pagiging napapanahon, at SHA-256 ng mga **eksaktong UTF-8 JSON byte** na iyon. Itinatala nito ang pasya ng tao sa aktuwal na pahayag. Hindi authentication ang isang `reviewerId` na string sa record. Huwag mag-imbak ng record na may hindi pa nalulutas na salungatan o kulang na pahintulot. Iniimbak ng Anthropic ang teksto; hindi nito pinapatunayan ang schema o katotohanan ng pahayag.

## 2. Iimbak at basahin muli

Gumawa o pumili ng makitid na memory store sa awtorisadong workspace at itala ang tunay nitong `memstore_...` ID. Gumamit ng path na hindi sensitibo, gaya ng `/records/{opaque-record-id}.json`. Bago ang request, itala ang gumagawa, oras sa UTC, bersiyon ng pinagmulan, hash ng aprubadong byte, store at path, at `pending` na estado. Sa direktang tawag sa memory store, gamitin ang `agent-memory-2026-07-22`; ang tawag sa session ay gumagamit ng `managed-agents-2026-04-01`. Ayon sa Anthropic, ang pagsasama ng dalawang beta header sa request sa store ay nagbabalik ng HTTP 400. Ipinapakita ng [reperensiya sa paggawa](https://platform.claude.com/docs/en/api/beta/memory_stores/memories/create) at memory manual ang anyong ito ng SDK; ikumpara ang naka-install na SDK sa kasalukuyang reperensiya:

```python
mem = client.beta.memory_stores.memories.create(
    store.id,
    path="/records/<opaque-record-id>.json",
    content=approved_json_text,
)
```

Hindi pinapatungan ng paggawa ang umiiral na path. Itabi ang ibinalik na `mem_...` ID, saka ilista ang `/records/` sa store na nasa saklaw, gamit ang bawat `next_page` bilang susunod na `page`. Hindi kasama ang nilalaman sa karaniwang pangunahing listahan. [Kunin ang napiling memory](https://platform.claude.com/docs/en/api/beta/memory_stores/memories/retrieve) ayon sa ID upang makuha ang buong teksto; ikumpara ang store ID, memory ID, path, nilalaman at `content_sha256` sa aprubadong byte. Itala ang tugon at direktang pagbasa muli sa journal at registry. Hindi sapat na katibayan ng pagkumpleto ang tugon sa paggawa lamang. Kung hindi tiyak ang tugon, suriin ang eksaktong path at direktang record bago magpasya; hindi dahilan para ulitin ang paggawa ang kawalan lamang ng resulta sa paghahanap.

## 3. Ipirmi ang napiling bersiyon

Sa bawat susunod na pagpapatakbo, patunayan ang tumatawag at kunin ang saklaw, store at ID ng napiling record mula sa pinagkakatiwalaang registry. Kung kailangang maghanap, ilista ang prefix na nasa saklaw sa lahat ng pahina, saka direktang kunin ang napiling `mem_...`. Kalkulahin ang SHA-256 sa UTF-8 encoding ng **ibinalik na nilalaman**, ikumpara ito sa `content_sha256` ng provider at sa eksaktong hash ng byte na inaprubahan ng tao, at patunayan muli ang JSON. Suriin ang record ID, saklaw ng may-ari, bersiyon ng pinagmulan, `active` na status, pagiging kasalukuyan ng pinagmulan at itinakdang limitasyon ng bisa. Kung may bumagsak na pagsusuri, huwag magpadala.

Isulat nang minsan lamang ang eksaktong nakuhang byte sa pribadong imbakan na tinutukoy ng hash nito, gamit ang eksklusibong paggawa gaya ng `open(path, "xb")` sa Python. Basahin at i-hash muli ang file agad at bago ang **bawat** pagpapadala. Huwag patungan ang umiiral na snapshot. Ang bahagyang file o umiiral na file na may ibang byte sa address na iyon ay nangangailangan ng paghinto at paglutas. Panatilihin ang orihinal na pag-apruba, store ID, memory ID, hash ng provider, hash ng snapshot at pasya sa saklaw sa pribadong katibayan ng pagkuha. Disenyo ito ng app para sa snapshot na minsan lamang isinusulat, hindi Anthropic mount na nakapirmi sa isang bersiyon.

## 4. Ibigay ang parehong byte sa dalawang bagong session

Gumawa ng bagong session para sa agent A gamit ang tunay na awtorisadong agent at environment ID nito at **walang entry ng memory store sa `resources`**. Tiyaking walang ibang daan sa store ang mga resource ng ibinalik na session at aktuwal na mga tool at kredensiyal ng agent. Hiwalay na inilalarawan ng [gabay sa session](https://platform.claude.com/docs/en/managed-agents/sessions) ng Anthropic ang paggawa at pagpapadala ng `user.message`:

```python
session = client.beta.sessions.create(
    agent=approved_agent_id,
    environment_id=approved_environment_id,
)
client.beta.sessions.events.send(
    session.id,
    events=[{"type": "user.message", "content": [{"type": "text", "text": message_text}]}],
)
```

Bago ang `events.send`, basahin at i-hash muli ang pribadong snapshot. Buuin ang `message_text` sa paraang deterministiko mula sa malinaw na label na “nasuring datos”, mga identifier ng record, pinagmulan at review, hindi binagong JSON text at SHA-256 nito, kasunod ang isang tiyak na tanong na masasagot ng orihinal na pinagmulan. Ang ipinakitang mga field ay **pormat ng mensahe ng app**, hindi mga field ng tugon ng provider. Bago magpadala, itala ang buong UTF-8 byte at hash ng mensahe, hash ng napiling snapshot, awtorisadong agent ID, session ID at estado ng pagpapadala. Panatilihin ang kinalabasan at tunay na ID ng naipadalang event o pagbasa muli ng event list kung mayroon. Kung hindi alam ang kinalabasan, basahin muli ang event, huwag basta magpadala ulit.

Gumawa ng ikalawang bagong session para sa agent B gamit ang hiwalay na aprubadong agent ID nito at kaparehong kawalan ng access sa store. Basahin muli ang **parehong snapshot na minsan lamang isinulat**, tiyakin ang hash ng byte, buuin at itala ang buong mensahe ni B, saka ipadala. Maaaring magkaiba ang tanong o metadata ng tatanggap sa dalawang mensahe; tiyaking pareho ang nakapaloob na JSON byte at aprubadong hash ng record. Suriin ang bawat sagot at anumang tool event laban sa orihinal na pinagmulan. Hindi patunay ng panloob na pag-asa ng modelo sa ipinasok na teksto ang kapani-paniwalang sagot o sipi; ang katibayan ng mensahe at event ng provider ang nagpapatunay kung ano ang ibinigay ng app. Kung may live mount o ibang daan sa store ang alinman, huwag padalhan ang session na iyon.

## 5. Mag-update lamang matapos ang bagong pagsusuri sa pinagmulan

Kapag nagbago ang orihinal, direktang kunin ang kasalukuyang memory at ikumpara ang luma at bagong ebidensiya kasama ng may-ari. Ipaapruba sa tao ang eksaktong kapalit na JSON byte na may matatag na record ID, itinamang pahayag o source pointer, bagong bersiyon ng pinagmulan at oras ng pagtiyak at review. Panatilihin ang lumang katibayan at hash. Itala ang `mem_...` ID, kasalukuyang direktang nabasang `content_sha256`, nilalayong hash ng kapalit, gumagawa, pag-apruba at nakabinbing estado. Ang nakadokumentong [pag-update na may kondisyon](https://platform.claude.com/docs/en/api/beta/memory_stores/memories/update) ay:

```python
client.beta.memory_stores.memories.update(
    memory_id=memory_id,
    memory_store_id=store_id,
    content=approved_replacement_json_text,
    precondition={"type": "content_sha256", "content_sha256": fresh_old_hash},
)
```

Hina-hash ng provider ang eksaktong UTF-8 na nilalaman nang walang normalization. Ang hindi pagtugma ay nagbabalik ng HTTP 409 `memory_precondition_failed_error`. Kapag iyon ang tugon o hindi tiyak ang resulta ng network, kunin muli ang kasalukuyang memory at suriin ang kasaysayan ng bersiyon kung kailangan. Ikumpara ang magkakatunggaling bersiyon ng pinagmulan at hilingin sa may-ari na pagsamahin, tanggihan o aprubahan ang bagong eksaktong kapalit; huwag basta ulitin ang lumang pagsulat. Kapag matagumpay, dapat tiyakin ng direktang pagkuha ang path, buong kapalit na teksto, hash at memory version ID bago maging `confirmed` ang journal.

Ipirmi ang isang **bagong** aprubadong snapshot mula sa natiyak na bersiyong iyon. Gumawa ng bagong awtorisadong session nina A at B na walang store mount at ulitin ang dalawang pagpapadala at pagsusuri sa pinagmulan. Huwag baguhin ang lumang snapshot o sabihing kusang nagbabago ang mga naipadalang mensahe. Markahang hindi na maaaring ipasok sa hinaharap ang naunang snapshot. Kung bawiin ng may-ari ang record, ihinto ang bagong pagpapadala at sundin ang patakaran niya sa pagpapanatili at pagtatakip ng datos: ang pagbura sa kasalukuyang memory ay hindi palaging nag-aalis ng mga naiwang bersiyon. Hiwalay na pasya ang pag-archive o pagbura sa buong store.

## Ano ang ituturing na tapos

Dapat pagdugtungin ng mga pribadong katibayan ang orihinal na pahintulot at bersiyon ng pinagmulan sa eksaktong aprubadong JSON hash; tunay na pagkakakilanlan ng workspace, store, path at `mem_...` at direktang pagbasa muli pagkatapos gumawa; isang hindi nababagong snapshot; dalawang magkaibang awtorisadong session ID na walang mount, kasama ang hash ng naipadalang mensahe at sagot na nasuri laban sa pinagmulan; at ang aprubadong conditional update na may bagong direktang pagbasa at pagsusuri sa mga bagong session. Kung may ugnayang hindi alam, markahang hindi kumpleto ang buong gawain at panatilihin ang eksaktong dahilan. Itala ang aktuwal na paggamit ng session at tool at gastos na partikular sa account kung isasagawa mo ito; hindi sinukat ng dokumentaryong gabay na ito ang pagtitipid o performance ng modelo.

Para sa kaugnay ngunit ibang gawain, ang [pagsusuri sa isang Dream output para sa susunod na session](https://bigchange.ai/blog/claude-managed-agents-reviewed-dream-memory-guide) ay tungkol sa nabuong panukala sa store. Ang prosesong narito ay nagsisimula sa source record na aprubado ng may-ari at ipinipirmi ang eksaktong matatanggap ng dalawang tagatanggap.

## Sources

- [Anthropic Managed Agents, manwal ng memory](https://platform.claude.com/docs/en/managed-agents/memory) — Inilalarawan ang beta header, mga text store ng workspace, nababagong mount, mga bersiyon at limitasyon. Hindi nito pinapatunayan ang end user, katotohanan ng pahayag o pagkakapirmi ng naka-mount na store sa aprubadong bersiyon.
- [Anthropic, API sa paggawa ng memory](https://platform.claude.com/docs/en/api/beta/memory_stores/memories/create) — Inilalarawan ang paggawa gamit ang path at nilalaman at ibinalik na pagkakakilanlan. Walang ginawang memory para sa gabay; hiwalay ang validation at pag-apruba ng app.
- [Anthropic, API sa paglilista ng memory](https://platform.claude.com/docs/en/api/beta/memory_stores/memories/list) — Inilalarawan ang path_prefix, paglipat ng pahina gamit ang next_page at pangunahing resultang walang nilalaman. Kailangan pa rin ang buong direktang pagbasa sa napiling record.
- [Anthropic, API sa pagkuha ng memory](https://platform.claude.com/docs/en/api/beta/memory_stores/memories/retrieve) — Inilalarawan ang buong pagkuha sa napiling memory para basahin muli ang nilalaman at hash; sa app sinusuri ang katumpakan ng pinagmulan at saklaw.
- [Anthropic, API sa pag-update ng memory](https://platform.claude.com/docs/en/api/beta/memory_stores/memories/update) — Inilalarawan ang eksaktong UTF-8 content_sha256 na paunang kondisyon at HTTP 409 memory_precondition_failed_error. Iminungkahing patakaran ng app sa gabay ang paglutas ng tao sa salungatan.
- [Anthropic, pagsisimula ng session](https://platform.claude.com/docs/en/managed-agents/sessions) — Inilalarawan ang paggawa ng agent/environment session at user.message sa pamamagitan ng events.send. Walang session na pinatakbo para sa gabay; kontrol ng app ang pribadong snapshot na walang mount at journal ng mensahe.
- [BIG CHANGE: suriin ang Claude Managed Agent memory store gamit ang isang Dream](https://bigchange.ai/blog/claude-managed-agents-reviewed-dream-memory-guide) — Kaugnay na gabay sa pagsusuri ng isang output. Hindi nito ipinapakita ang typed na siklo ng eksaktong snapshot para sa dalawang agent sa artikulong ito.