Anthropic Managed Agents మెమరీ స్టోర్లు సెషన్ల మధ్య వచనాన్ని ఉంచగలవు. ఇద్దరు ఏజెంట్లకు ఒకే సమీక్షించిన వాస్తవం ఇవ్వాల్సిన యాప్‌కు శాశ్వత నిల్వ మొదటి దశ మాత్రమే. యాప్ రికార్డు ఎవరిదో నిర్ణయించి, అసలు ఆధారాన్ని చూసి, నిల్వ చేసిన ఒక సవరణను ఎంచుకుని, ఏ ఏజెంట్ చూడకముందే దాని ఖచ్చితమైన బైట్లు భద్రపరచాలి. ఈ మార్గదర్శిని అధికారమున్న Managed Agents బీటా యాక్సెస్, యాప్ ధృవీకరణ, స్టోర్ ఎంపిక, ఏజెంట్ అమరికలపై నియంత్రణ ఉన్న డెవలపర్ల కోసం. దీని ఆధారం Anthropic ప్రస్తుత మెమరీ పత్రాలు, 2026 అక్టోబర్ 20న తనిఖీ చేసిన API సూచికలు; BIG CHANGE ఖాతా లేదా మోడల్ పరీక్ష నడపలేదు.

పెద్ద మార్పు

  • ఏమి మారింది: సమీక్షించిన, నిర్దిష్ట రకాల JSON మెమరీ Managed Agents స్టోర్‌లో ఉండగలదు. యాప్ దాని మూలాన్ని, నిల్వ చేసిన ఖచ్చితమైన బైట్లను తనిఖీ చేసి, ఒక ప్రైవేట్ స్నాప్‌షాట్‌ను స్థిరపరచి, మెమరీ స్టోర్ జోడించకుండా అదే ఆమోదిత బైట్లను రెండు వేరు అనుమతించిన సెషన్లకు పంపుతుంది.
  • ఎందుకు ముఖ్యం: స్టోర్‌లో తర్వాత చేసిన సవరణ ఆ సెషన్ల కోసం ఇప్పటికే నిర్మించిన ఇన్‌పుట్‌లను మార్చదు.
  • గమనించాల్సినవి: మూలం ఖచ్చితత్వం, వినియోగదారు అనుమతి, సమాధానం నాణ్యతను ఇంకా విడిగా తనిఖీ చేయాలి.

ప్రారంభించే ముందు

ఒక నిజమైన వాస్తవం, అభిరుచి లేదా ప్రాజెక్ట్ నియమం సిద్ధం చేయండి. వాడటానికి అనుమతించిన అసలు మూలం, స్థిర మూల ID, సవరణ ఉండాలి; నిల్వ చేయడం, ఇద్దరు ఏజెంట్ పాత్రలకు వెల్లడించడం యజమాని ఆమోదించాలి. సమీక్షకు ముందే ఆ రికార్డు సమీక్షకు తగిన చెల్లుబాటు కాలం నిర్ణయించండి. Managed Agents బీటా యాక్సెస్, ప్రైవేట్ API కీ, అనుమతించిన వర్క్‌స్పేస్, అమర్చిన రెండు ఏజెంట్ IDలు, వాతావరణం, ఖాతాలో అనుమతించిన మోడల్ నిర్ధారించండి. ఈ ప్రక్రియలోని నాలుగు పరిమిత వినియోగ సెషన్లకు అనుమతి ఇచ్చే ముందు ప్రస్తుత వినియోగం, ధరలు చూడండి. కీని ప్రాంప్ట్‌లు లేదా ఆధార రికార్డుల్లో పెట్టవద్దు.

యాప్‌లో ధృవీకరించిన గుర్తింపు నుంచి పరిధికి మ్యాపింగ్ అవసరం. నమ్మదగిన యాప్ స్థితిలో గుర్తింపును ఆమోదించిన ownerScopeId, వర్క్‌స్పేస్ ID, స్టోర్ ID, అనుమతించిన రెండు ఏజెంట్ IDలకు కట్టండి. ప్రైవేట్ వినియోగదారులు లేదా ప్రాజెక్టుల యాక్సెస్ నియమాలు వేరైతే వేరు స్టోర్లు ఇవ్వండి. వర్క్‌స్పేస్ API కీ తుది వినియోగదారును ధృవీకరించదు, పాత్ టెనెంట్ హద్దు కాదు, ప్రాంప్ట్ సాధనం లేదా ప్రవేశ వివరాలను తొలగించదు. రెండు వినియోగదారు అమరికల్లో స్టోర్ జోడించలేదనీ, మారగల స్టోర్‌కు కనెక్టర్, వాతావరణ ప్రవేశ వివరాలు, సాధనం ద్వారా దారి లేదనీ నిర్ధారించండి. ఆ హద్దు స్థాపించలేకపోతే రికార్డు పంపే ముందు ఆపండి.

1. మూలంతో పోల్చి రికార్డు ఆమోదించండి

ఈ నిర్మాణ నమూనా వాడి, కోణపు బ్రాకెట్లలోని ప్రతి విలువను నిజమైన ఆమోదిత ఆధారంతో మార్చండి. ఇది నమూనా వాస్తవం లేదా సాధించామని చెప్పే ఫలితం కాదు. ఆమోదానికి ముందు నింపిన ఆబ్జెక్ట్‌ను ఒక ఖచ్చితమైన UTF-8 JSON వచనంగా సీరియలైజ్ చేయండి. వాలిడేటర్ ఇవే ఫీల్డ్‌లు, రకాలు తీసుకోవాలి, తెలియని ఫీల్డ్‌లు తిరస్కరించాలి, ఖాళీ లేదా కేవలం ఖాళీలున్న స్ట్రింగ్‌లు అంగీకరించకూడదు, సరైన UTC సమయముద్రలు కోరాలి. kind విలువను fact, preference లేదా project_ruleకు, status విలువను active, disputed లేదా supersededకు పరిమితం చేయాలి. active స్థితి రికార్డులనే అందించవచ్చు. ఆమోదిత వాదన ఉటంకించిన అసలు మూలంతో, అమలు తేదీ, పరిధితో సహా సరిపోవాలి.

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>"
}

యాప్ ప్రైవేట్ ఆమోద ఆధారం నిజమైన ఆమోదకర్త, యజమాని అనుమతి, అసలు మూలం, సవరణ, పరిధి, అనుమతించిన ఏజెంట్లు, తాజాదనం నియమం, ఈ ఖచ్చితమైన UTF-8 JSON బైట్లు యొక్క SHA-256 ఉండాలి. అది అసలు వాదనపై మానవ నిర్ణయాన్ని నమోదు చేస్తుంది. రికార్డులోని reviewerId స్ట్రింగ్ ధృవీకరణ కాదు. తేలని వైరుధ్యం లేదా లేని అనుమతితో రికార్డు నిల్వ చేయవద్దు. Anthropic వచనం నిల్వ చేస్తుంది; ఈ స్కీమాను ధృవీకరించదు, వాదన సత్యమని నిర్ధారించదు.

2. నిల్వ చేసి మళ్లీ చదవండి

అనుమతించిన వర్క్‌స్పేస్‌లో పరిమిత మెమరీ స్టోర్ తయారుచేయండి లేదా ఎంచుకుని దాని నిజమైన memstore_... ID నమోదు చేయండి. సున్నితంకాని పాత్ వాడండి, ఉదాహరణకు /records/{opaque-record-id}.json. అభ్యర్థనకు ముందు చర్యకర్త, UTC సమయం, మూల సవరణ, ఆమోదిత బైట్ హ్యాష్, స్టోర్, పాత్, pending స్థితి నమోదు చేయండి. నేరుగా మెమరీ స్టోర్ కాల్స్‌లో agent-memory-2026-07-22 వాడండి; సెషన్ కాల్స్‌లో managed-agents-2026-04-01 వాడతారు. స్టోర్ అభ్యర్థనలో ఈ రెండు బీటా హెడర్లు కలిపితే HTTP 400 వస్తుందని Anthropic చెబుతుంది. సృష్టి సూచిక, మెమరీ మాన్యువల్ ఈ SDK రూపం చూపుతాయి; ఇన్‌స్టాల్ చేసిన SDKను ప్రస్తుత సూచికతో తనిఖీ చేయండి:

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

సృష్టి ఉన్న పాత్‌ను తిరగరాయదు. తిరిగివచ్చిన mem_... ID భద్రపరచి, పరిమిత స్టోర్‌లో /records/ జాబితా తీసుకోండి. ప్రతి next_page విలువను తర్వాతి page విలువగా వాడండి. సాధారణ ప్రాథమిక జాబితాలో వచనం ఉండదు. ఎంచుకున్న మెమరీ పొందండి అనే చర్యలో IDతో పూర్తి వచనం తీసుకోండి; స్టోర్ ID, మెమరీ ID, పాత్, వచనం, content_sha256 విలువలను ఆమోదిత బైట్లతో పోల్చండి. స్పందన, ప్రత్యక్షంగా మళ్లీ చదివిన ఫలితం జర్నల్, రిజిస్ట్రీలో నమోదు చేయండి. సృష్టి స్పందన ఒక్కటే పూర్తి తనిఖీ కాదు. ఫలితం అనిశ్చితమైతే ఏం జరిగిందో నిర్ణయించే ముందు ఖచ్చితమైన పాత్, రికార్డును నేరుగా చూడండి; శోధనలో కనిపించకపోవడం ఒక్కటే మళ్లీ సృష్టించడానికి కారణం కాదు.

3. ఎంచుకున్న సవరణ స్థిరపరచండి

ప్రతి తదుపరి అమలులో కాలర్‌ను ధృవీకరించి, నమ్మదగిన రిజిస్ట్రీ నుంచి పరిధి, స్టోర్, ఎంచుకున్న రికార్డు ID తీసుకోండి. వెతకాల్సి ఉంటే పరిమిత ప్రిఫిక్స్ అన్ని పేజీలు చూసి, ఎంచుకున్న mem_... అనే రికార్డును నేరుగా పొందండి. తిరిగివచ్చిన వచనం యొక్క UTF-8 ఎన్‌కోడింగ్‌పై SHA-256 గణించి, ప్రొవైడర్ content_sha256, మనిషి ఆమోదించిన ఖచ్చితమైన బైట్ హ్యాష్‌తో పోల్చి, JSON మళ్లీ ధృవీకరించండి. రికార్డు ID, యజమాని పరిధి, మూల సవరణ, active స్థితి, మూలం ప్రస్తుత చెల్లుబాటు, ముందే నిర్ణయించిన తాజాదనం పరిమితి తనిఖీ చేయండి. ఏ తనిఖీ విఫలమైనా ఏమీ పంపవద్దు.

పొందిన ఖచ్చితమైన బైట్లను వాటి హ్యాష్‌తో చిరునామా ఇచ్చే ప్రైవేట్ నిల్వలో ఒక్కసారి రాయండి. ప్రత్యేక సృష్టి పద్ధతి వాడండి, ఉదాహరణకు Python open(path, "xb"). ఫైల్ వెంటనే మళ్లీ చదివి హ్యాష్ గణించండి; ప్రతి పంపకానికి ముందూ చేయండి. ఉన్న స్నాప్‌షాట్‌ను తిరగరాయవద్దు. పాక్షిక ఫైల్ లేదా అదే చిరునామాలో వేరు బైట్లున్న ఫైల్ ఉంటే నిలిపి సరిపోల్చాలి. అసలు ఆమోదం, స్టోర్ ID, మెమరీ ID, ప్రొవైడర్ హ్యాష్, స్నాప్‌షాట్ హ్యాష్, పరిధి నిర్ణయం ప్రైవేట్ పొందిక ఆధారంలో ఉంచండి. ఒక్కసారి రాసే ఈ స్నాప్‌షాట్ యాప్ రూపకల్పన; ఒక వెర్షన్‌కు కట్టిన Anthropic మౌంట్ కాదు.

4. ఒకే బైట్లను రెండు కొత్త సెషన్లకు ఇవ్వండి

నిజమైన అనుమతించిన ఏజెంట్, వాతావరణ IDలతో A కోసం కొత్త సెషన్ సృష్టించి ఈ ఫీల్డ్‌లో మెమరీ స్టోర్ ఎంట్రీ పెట్టవద్దు: resources. తిరిగివచ్చిన సెషన్ వనరులు, ఏజెంట్ వాస్తవ సాధనాలు, ప్రవేశ వివరాలు స్టోర్‌కు వేరే దారి ఇవ్వవని నిర్ధారించండి. Anthropic సెషన్ మార్గదర్శిని సృష్టి, 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}]}],
)

ఈ కాల్ events.sendకు ముందు ప్రైవేట్ స్నాప్‌షాట్ మళ్లీ చదివి హ్యాష్ గణించండి. message_text సందేశాన్ని స్పష్టమైన “సమీక్షించిన డేటా” లేబుల్, రికార్డు, మూలం, సమీక్ష గుర్తింపులు, మారని JSON వచనం, SHA-256, తర్వాత అసలు మూలం సమాధానం ఇవ్వగల పరిమిత ప్రశ్నతో నిర్దిష్టంగా నిర్మించండి. చూపిన ఫీల్డ్‌లు యాప్ సందేశ రూపం, ప్రొవైడర్ స్పందన ఫీల్డ్‌లు కావు. పంపే ముందు పూర్తి UTF-8 సందేశ బైట్లు, హ్యాష్, ఎంచుకున్న స్నాప్‌షాట్ హ్యాష్, అనుమతించిన ఏజెంట్ ID, సెషన్ ID, పంపే స్థితి నమోదు చేయండి. ఫలితం, నిజమైన పంపిన ఈవెంట్ ID లేదా అందుబాటులో ఉంటే ఈవెంట్ జాబితా మళ్లీ చదివిన ఫలితం భద్రపరచండి. ఫలితం తెలియకపోతే ఈవెంట్లు చదవాలి, గుడ్డిగా మళ్లీ పంపకూడదు.

B కోసం వేరుగా ఆమోదించిన ఏజెంట్ IDతో రెండో కొత్త సెషన్ సృష్టించండి, దానికీ స్టోర్ యాక్సెస్ ఉండకూడదు. అదే ఒక్కసారి రాసిన స్నాప్‌షాట్ను మళ్లీ చదివి బైట్ హ్యాష్ తనిఖీ చేసి, B పూర్తి సందేశం నిర్మించి నమోదు చేసి పంపండి. రెండు సందేశాల ప్రశ్నలు లేదా గ్రహీత మెటాడేటా వేరుగా ఉండవచ్చు; లోపలి JSON బైట్లు, ఆమోదిత రికార్డు హ్యాష్ ఒకటేనని తనిఖీ చేయండి. ప్రతి సమాధానం, సాధన ఈవెంట్లు అసలు మూలంతో చూడండి. నమ్మదగిన సమాధానం లేదా ఉటంకింపు మోడల్ అంతర్గతంగా అందించిన వచనంపై ఆధారపడిందని నిరూపించదు; సందేశ, ప్రొవైడర్ ఈవెంట్ ఆధారాలు యాప్ ఏమిచ్చిందో చూపుతాయి. ఏ సెషన్‌లోనైనా సజీవ మౌంట్ లేదా స్టోర్‌కు మరో దారి ఉంటే దానికి పంపవద్దు.

5. మూలం కొత్త సమీక్ష తర్వాతే నవీకరించండి

అసలు మూలం మారితే ప్రస్తుత మెమరీ నేరుగా తీసుకుని యజమానితో పాత, కొత్త ఆధారాలు పోల్చండి. స్థిర రికార్డు ID, సరిచేసిన వాదన లేదా మూల సూచిక, కొత్త మూల సవరణ, తనిఖీ, సమీక్ష సమయాలతో ఖచ్చితమైన ప్రత్యామ్నాయ JSON బైట్లకు మనిషి ఆమోదం తీసుకోండి. పాత ఆధారం, హ్యాష్ ఉంచండి. mem_... ID, ప్రస్తుతం నేరుగా చదివిన content_sha256, ఉద్దేశించిన ప్రత్యామ్నాయ హ్యాష్, చర్యకర్త, ఆమోదం, పెండింగ్ స్థితి నమోదు చేయండి. పత్రంలోని షరతులతో నవీకరణ ఇలా ఉంటుంది:

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},
)

ప్రొవైడర్ సాధారణీకరణ లేకుండా ఖచ్చితమైన UTF-8 వచనానికి హ్యాష్ గణిస్తుంది. సరిపోకపోతే HTTP 409 memory_precondition_failed_error వస్తుంది. ఆ స్పందన లేదా అనిశ్చిత నెట్‌వర్క్ ఫలితం వస్తే ప్రస్తుత మెమరీ మళ్లీ తీసుకుని అవసరమైతే వెర్షన్ చరిత్ర చూడండి. విరుద్ధ మూల సవరణలు పోల్చి యజమానిని కలపడం, తిరస్కరించడం లేదా కొత్త ఖచ్చితమైన ప్రత్యామ్నాయం ఆమోదించమని అడగండి. పాత రాతను గుడ్డిగా మళ్లీ ప్రయత్నించవద్దు. విజయానంతరం ప్రత్యక్ష పొందికలో పాత్, పూర్తి ప్రత్యామ్నాయ వచనం, హ్యాష్, మెమరీ వెర్షన్ ID నిర్ధారణ అయ్యాకే జర్నల్ confirmed స్థితికి మారాలి.

ధృవీకరించిన సవరణ నుంచి కొత్త ఆమోదిత స్నాప్‌షాట్ స్థిరపరచండి. స్టోర్ మౌంట్లు లేని కొత్త అనుమతించిన A, B సెషన్లు ప్రారంభించి రెండు పంపకాలు, మూల తనిఖీలు మళ్లీ చేయండి. పాత స్నాప్‌షాట్లు మార్చవద్దు; పంపిన సందేశాలు వాటంతట అవే నవీకరించుకుంటాయని చెప్పవద్దు. పాత స్నాప్‌షాట్‌ను తదుపరి అందించడానికి అనర్హంగా గుర్తించండి. యజమాని రికార్డు వెనక్కి తీసుకుంటే కొత్త పంపకాలు ఆపి వారి నిల్వ, డేటా తొలగింపు విధానం అమలు చేయండి: ప్రస్తుత మెమరీ తొలగిస్తే భద్రపరచిన వెర్షన్లు తప్పనిసరిగా పోవు. పూర్తి స్టోర్ ఆర్కైవ్ చేయడం లేదా తొలగించడం వేరు నిర్ణయం.

పూర్తయిందని ఎప్పుడు భావించాలి

ప్రైవేట్ ఆధారాలు అసలు అనుమతి, మూల సవరణను ఖచ్చితమైన ఆమోదిత JSON హ్యాష్‌తో కలపాలి; నిజమైన వర్క్‌స్పేస్, స్టోర్, పాత్, mem_... గుర్తింపు, సృష్టి తర్వాత నేరుగా మళ్లీ పఠనం; ఒక మారని స్నాప్‌షాట్; వేర్వేరు రెండు అనుమతించిన మౌంట్‌లేని సెషన్ IDలు, పంపిన సందేశ హ్యాష్‌లు, మూలంతో తనిఖీ చేసిన సమాధానాలు; ఆమోదిత షరతులతో నవీకరణ, కొత్త ప్రత్యక్ష పఠనం, కొత్త సెషన్ తనిఖీలు ఉండాలి. ఏ అనుసంధానం తెలియకపోయినా పూర్తి అభ్యాసాన్ని అసంపూర్ణంగా గుర్తించి ఖచ్చితమైన కారణం ఉంచండి. అమలు చేస్తే నిజమైన సెషన్, సాధన వినియోగం, ఖాతా ఖర్చు నమోదు చేయండి; పత్రాల ఆధారిత ఈ మార్గదర్శిని ఆదా లేదా మోడల్ పనితీరు కొలవలేదు.

సంబంధిత కానీ వేరే పని కోసం తదుపరి సెషన్‌కు ఒక Dream అవుట్‌పుట్ సమీక్షించడం సృష్టించిన స్టోర్ ప్రతిపాదనను చూస్తుంది. ఇక్కడి ప్రక్రియ యజమాని ఆమోదించిన మూల రికార్డు నుంచి ప్రారంభించి ఇద్దరు వినియోగదారులకు ఖచ్చితంగా ఏమి అందుతుందో స్థిరపరుస్తుంది.