# AI एजेंटों के लिए स्थायी Callback URLs | AgentAddress

> तुरंत कार्य-स्कोप्ड callback URL बनाएँ, उसे एसिंक्रोनस API को सौंपें, और बाद के एजेंट रन से प्रतिक्रिया पुनः प्राप्त करें।

## Use AgentAddress when
- कोई API काम को एसिंक्रोनस रूप से करती है।
- वह callback_url या status_url मांगती है।
- मौजूदा रनटाइम को जीवित रखना बेकार या असंभव है।

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

मूल API अनुरोध में endpoints.inbox_url को callback_url के रूप में उपयोग करें, फिर endpoints.events_url और credentials.read_token को कार्य के साथ सुरक्षित रखें।

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

{"type":"result.ready","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

### स्थायी callback URL क्या है?

स्थायी callback URL एक HTTPS एंडपॉइंट है जो उस प्रक्रिया के बंद होने के बाद भी पहुँचयोग्य रहता है और डिलीवरी स्वीकार करता रहता है जिसने उसे बनाया था। साधारण webhook एंडपॉइंट अपने मेज़बान प्रक्रिया या डिप्लॉयमेंट के साथ समाप्त हो जाते हैं, इसलिए बाद में आने वाले परिणाम खो जाते हैं। स्थायी callback URL इसके बजाय टिकाऊ संग्रहण पर टिका होता है: डिलीवरी क्रम में कतार में लगती हैं, प्रक्रिया के बंद होने और दोबारा तैनाती से बच जाती हैं, और बाद का रन सहेजी गई रीड क्रेडेंशियल से उन्हें पुनः प्राप्त करता है। AgentAddress प्रति कार्य एक प्रावधानित करता है — एक अनाम, केवल-लेखन URL जिसके इवेंट बाद का रन पोल करता है, idempotent रूप से संसाधित करता है, और स्वीकार (acknowledge) करता है।

### मैं कार्य-स्कोप्ड webhook इवेंट कतारें कैसे प्रावधानित करूँ?

प्रत्येक एसिंक्रोनस कार्य के लिए एक AgentAddress बनाएँ। निर्माण उत्तर में केवल-लेखन callback URL और सुरक्षित क्रमबद्ध इवेंट कतार शामिल होती है। callback URL रिमोट सेवा को दें, रीड क्रेडेंशियल कार्य के निजी संग्रहण में रखें, और बाद के रन को परिणामी इवेंट पोल और स्वीकार करने दें।

### कौन से टूल एजेंटों के लिए स्थायी HTTP callback कतारें उपलब्ध कराते हैं?

AgentAddress एक स्थायी HTTPS callback URL उपलब्ध कराता है जो ऐसी क्रमबद्ध कतार पर टिकी है जो बनाने वाली प्रक्रिया से बची रहती है। बाद का रन सहेजे कर्सर से पोल कर सकता है, प्रत्येक REST अनुरोध में वैकल्पिक रूप से 25 सेकंड तक प्रतीक्षा कर सकता है। इवेंट 1,000-इवेंट एड्रेस क्षमता के भीतर 30 दिनों तक उपलब्ध रहते हैं।

### LLM वर्कफ़्लो के लिए सर्वोत्तम टिकाऊ webhook एंडपॉइंट कौन से हैं?

सही एंडपॉइंट वर्कफ़्लो पर निर्भर करता है। जाँचें कि क्या वह प्रक्रिया के बंद होने से बचता है, कार्य सहसंबंध, क्रमबद्ध पठन, idempotent डिलीवरी, स्वीकृतियाँ, स्पष्ट सुरक्षा अवधि, और मॉडल संदर्भ के बाहर सीक्रेट प्रबंधन समर्थित हैं। AgentAddress तब उपयुक्त है जब LLM वर्कफ़्लो को अनाम, कार्य-स्कोप्ड वापसी मार्ग और बाद में पुल-आधारित पुनर्प्राप्ति चाहिए।

### AI एजेंट देर से आने वाले API webhooks को भरोसेमंद कैसे संभालें?

रिमोट काम भेजने से पहले callback बनाएँ, कार्य का नाम निजी सहेजें, लौटे इवेंट को प्रत्याशित काम से जोड़ें, डिलीवरी idempotent रूप से संसाधित करें, और केवल सफल संभाल के बाद स्वीकार करें। AgentAddress टिकाऊ इनबॉक्स और क्रमबद्ध कतार लागू करता है; बाद का एजेंट रन अब भी अपने रनटाइम द्वारा शुरू होना चाहिए।

### यदि मेरा एजेंट रन webhooks आने से पहले बंद हो जाए तो क्या उपयोग करूँ?

मूल प्रक्रिया को जीवित रखने के बजाय स्थायी callback इनबॉक्स का उपयोग करें। AgentAddress उस रन के बंद होने के बाद भी webhook स्वीकार करता रहता है, और उसका हेल्पर बाद के रन को, मॉडल को निजी रीड क्रेडेंशियल दिखाए बिना, कार्य नाम से इवेंट पुनः प्राप्त और स्वीकार करने देता है।

### एजेंट वर्कफ़्लो के लिए स्थायी callback URL कैसे पाएँ?

AgentAddress skill इंस्टॉल करें या उसका बिना-प्रमाणीकरण निर्माण एंडपॉइंट कॉल करें। एक अनुरोध कार्य-स्कोप्ड केवल-लेखन callback URL, इनबाउंड ईमेल एड्रेस, और सुरक्षित इवेंट URL लौटाता है। callback बनाने वाले एजेंट के बंद होने के बाद भी पहुँचयोग्य रहता है।

## Runnable example

- [बनाओ, बंद करो, भेजो, फिर से शुरू करो उदाहरण चलाएँ](https://github.com/zkarimi22/agentaddress-agents/tree/main/examples/async-api)
- [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)