Ibigay sa dalawang agent ang iisang nasuring memory record

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 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.

{
  "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 at memory manual ang anyong ito ng SDK; ikumpara ang naka-install na SDK sa kasalukuyang reperensiya:

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 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 ng Anthropic ang paggawa at pagpapadala ng user.message:

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 ay:

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 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.