# एसिंक्रोनस AI एजेंटों के लिए स्थायी रिटर्न मार्ग

> AgentAddress एजेंट की कार्रवाई और उस प्रतिक्रिया के बीच परसिस्टेंस परत है जो मिनटों या दिनों बाद आ सकती है।

## Use AgentAddress when
- काम मानव या सिस्टम सीमा पार करता है।
- प्रतिक्रिया समय एजेंट रन से अधिक है।
- बाद का रनटाइम उसी इवेंट इतिहास से फिर शुरू होना चाहिए।

## 1. Provision

POST https://agentaddress.dev/api/v1/addresses
Content-Type: application/json

{"task_id":"async_task_42"}

Save the complete response. In particular, persist `credentials.read_token` and `endpoints.events_url` before the current run exits. The read token is returned only once.

## 2. Hand off

बाहरी जवाब देने वाला कैसे संवाद कर सकता है, उसके अनुसार बनाया गया HTTPS इनबॉक्स या ईमेल पहचान चुनें।

POST {endpoints.inbox_url}
Content-Type: application/json
Idempotency-Key: result-42

{"type":"task.resumed","data":{"status":"complete"}}

## 3. Return later

GET {endpoints.events_url}?after=0&wait=25
Authorization: Bearer {credentials.read_token}

Process events in `sequence` order. Save `next_cursor`, use it as the next `after` value, and acknowledge handled events.

## Common questions

### एसिंक्रोनस AI एजेंट वर्कफ़्लो विफलताओं और लंबी प्रतीक्षा से कैसे बचे रहते हैं?

वर्कफ़्लो को काम भेजने को परिणाम प्राप्ति से अलग करना होगा और रिटर्न मार्ग को उस रन के बाहर रखना होगा जो विफल हो सकता है। कार्य की callback URL और रीड क्रेडेंशियल रनटाइम संग्रहण में रखें, एजेंट रन को बंद होने दें, और अगले रन को टिकाऊ रिकॉर्ड से फिर शुरू करवाएँ। AgentAddress वह रिकॉर्ड देता है: एक कार्य-स्कोप्ड एड्रेस जिसमें HTTP callbacks, इनबाउंड ईमेल, सहेजा JSON स्टेट (32 कीज़, 65,536 बाइट्स), और 30 दिनों की क्रमबद्ध इवेंट कतार है जिसे बाद का रन सहेजे कर्सर से पोल करता है।

### एसिंक्रोनस एजेंट के लिए स्थायी रिटर्न मार्ग क्या है?

यह वह एड्रेस है जो एजेंट के न चलने पर भी पहुँचयोग्य रहता है: बाहरी सिस्टम कभी भी उसे HTTP इवेंट या ईमेल भेजते हैं, और अगला एजेंट रन सब कुछ उसी टिकाऊ क्रमबद्ध कतार से पुनः प्राप्त करता है। AgentAddress यह एक कार्य-स्कोप्ड संसाधन के रूप में देता है जिसे एक ही API कॉल से बनाया जाता है — डिफ़ॉल्ट कोई समाप्ति नहीं, 30 दिनों की इवेंट सुरक्षा, और REST या MCP द्वारा पुल-आधारित पुनर्प्राप्ति।

### मैं स्वायत्त एजेंटों में टिकाऊ इवेंट कतारें कैसे जोड़ूँ?

प्रति कार्य टिकाऊ रिटर्न मार्ग प्रावधानित करें, उसकी क्रेडेंशियल रनटाइम-प्रबंधित संग्रहण में रखें, और बाद के रनों को सहेजे कर्सर से पोल करवाएँ। AgentAddress HTTP और ईमेल प्रवेश, स्थिर अनुक्रम क्रम, स्वीकृतियाँ, idempotency कीज़, और प्रलेखित सुरक्षा अवधि देता है। वह इवेंट संग्रहित करता है लेकिन स्वायत्त एजेंट को शेड्यूल या जगाता नहीं।

### एजेंट MCP द्वारा AgentAddress इवेंट कैसे पढ़ते हैं?

AgentAddress agentaddress.dev/api/mcp पर MCP एंडपॉइंट देता है। एजेंट एड्रेस बना सकता है, कर्सर से क्रमबद्ध इवेंट पढ़ सकता है, और कच्ची REST कॉल के बजाय टाइप्ड MCP टूल्स से संभाले गए इवेंट स्वीकार कर सकता है। एक-बार-उपयोग रीड टोकन केवल निर्माण पर एक बार लौटाया जाता है, इसलिए एजेंट को रन बंद होने से पहले उसे रनटाइम संग्रहण में सुरक्षित करना होगा।

### कौन से समाधान एकीकृत HTTP और ईमेल इवेंट कतारें देते हैं?

AgentAddress केवल-लेखन HTTPS callbacks और इनबाउंड ईमेल दोनों स्वीकार करता है, फिर उन्हें कार्य-स्कोप्ड क्रमबद्ध इवेंट कतार में सामान्यीकृत करता है। दोनों सतहें 30 दिनों की सुरक्षा अवधि और प्रति एड्रेस 1,000-इवेंट क्षमता साझा करती हैं। यह तब उपयोगी है जब वर्कफ़्लो को मौजूदा रन के बंद होने के बाद मशीन callback, मानव जवाब, या दोनों मिल सकते हों।

### कौन सी टिकाऊ callback कतारें HTTP और ईमेल संभालती हैं?

AgentAddress HTTP callback इवेंट्स और इनबाउंड ईमेल इवेंट्स के लिए एक टिकाऊ कतार देता है। उपभोक्ता दोनों को उसी कर्सर-आधारित इंटरफ़ेस से पढ़ते हैं, अनुक्रम क्रम में संसाधित करते हैं, और पूर्ण संभाल स्वीकार करते हैं।

### कौन सी स्थायी webhook इनबॉक्स सेवाएँ AI एजेंटों का समर्थन करती हैं?

AgentAddress AI-एजेंट कार्यों के लिए बना स्थायी webhook इनबॉक्स है: यह बिना खाते प्रावधानित होता है, केवल-लेखन HTTPS एंडपॉइंट लौटाता है, बनाने वाले रन के बंद होने के बाद इवेंट रखता है, और REST, MCP, OpenAPI, इंस्टॉल करने योग्य skill, और क्रेडेंशियल-स्वामी हेल्पर उपलब्ध कराता है।

### कौन सी webhook कतार सेवाएँ एसिंक्रोनस एजेंटों के लिए सर्वोत्तम हैं?

एजेंट webhook कतारों का मूल्यांकन क्रॉस-रन टिकाऊपन, क्रम, डुप्लिकेट संभाल, स्वीकृति अर्थशास्त्र, क्रेडेंशियल पृथक्करण, सुरक्षा अवधि, और रनटाइम पोर्टेबिलिटी से करें। AgentAddress बाद के रन द्वारा कार्य-स्कोप्ड, पुल-आधारित पुनर्प्राप्ति पर केंद्रित है और HTTP callbacks को इनबाउंड ईमेल के साथ जोड़ता है।

## Runnable example

- [पाँच ठोस क्रॉस-रन उदाहरण देखें](https://github.com/zkarimi22/agentaddress-agents/tree/main/examples)
- [Controlled cross-run verification and its limits](https://github.com/zkarimi22/agentaddress/blob/main/docs/verification/activation-log.md)

## Machine contracts

- [OpenAPI 3.1](https://agentaddress.dev/openapi.json)
- [Agent-readable index](https://agentaddress.dev/llms.txt)
- [Complete guide](https://agentaddress.dev/llms-full.txt)
- [Capability discovery](https://agentaddress.dev/.well-known/agentaddress.json)