Bots
تحدث إلى Bots لديك.
وهي تدير الوكلاء
Bot مساعد طويل الأمد بمحادثة واحدة تحتفظ بالمحادثة كاملة. اطلب منه أي شيء: يطلق وكلاء على أجهزة الكمبيوتر لديك، ويتابع عملهم، ثم يعود إليك بتقرير عما أنجزوه. امنحه عنوان URL على .hoody.bot وشاركه مع من تثق بهم من أشخاص وأدوات ذكاء اصطناعي عبر مفاتيح تحمل أسماء.
أول Bot لديك، chief، موجود منذ البداية. خدمة Hoody AI (مجانية) مدمجة فيه. أو سجّل الدخول عبر ChatGPT. ويستطيع مساعدو Bot استخدام Claude Pro أو Max عبر Claude Code عندما تسمح لهم بذلك.
صحح الخطأ المطبعي في موقعي وسعر المتجر، ثم رتب الصور الجديدة.
chiefمحادثة واحدة · الأجزاء الأقدم ملخّصة · حدودك
تمتصحيح الخطأ المطبعي في موقعي
يسألكتصحيح سعر المتجر
يعملترتيب الصور الجديدة
كل وكيل جلسة Hoody Agent كاملة على أحد أجهزة الكمبيوتر لديك.
عمليًا
- أول Bot لديك
GET /api/ v1/ agent/ bots/ chief chiefينشأ عند أول استخدام، فلا تكون قائمة Bots فارغة.- مكان التشغيل
https://تعمل Bots على Hoody Agent ({p}-{c}-agent-1.{node}.computers.hoody.com/ api/ v1/ agent/ bots agent-1)، وليس على خدمة تطبيق الدردشة في/api/bot/.
رسالة واحدة تصل بالعمل إلى نهايته. ثم يعود تقرير
أنت
من أي من هذه الوسائل
تقريراكتمل العمل. تم إصلاح المتجر.
أجهزة الكمبيوتر لديك
Bot لديك
يستلم رسالتك فورًا، ويعود إليك بتقرير عند الانتهاء
Agent
مساعدوه
Agent
مساعدوه
- موقعيتحديث
- المتجرإصلاح
- الصورنسخ احتياطي
مثالكل هذا يعمل على أجهزة الكمبيوتر لديك. ويعرف Bot لديك كل جهاز منها.
عمليًا
- وكلاؤه
GET /كل وكيل مفوض جلسة عادية، يمكن قراءتها أو إرفاقها عبر مساراتapi/ v1/ agent/ bots/ chief/ delegates ?state=open /sessions. وتحمل الجلسات المفتوحةcapabilityوcurrent_step.- دوره المباشر
GET /نص الرد والتفكير أثناء كتابتهما، واستدعاءات الأدوات، ونهاية كل دور. يأتيapi/ v1/ agent/ sessions/ {session_id}/ stream session_idمنGET /bots/{id}بعد أن يتلقى Bot أول رسالة له.
المزيد: شاهد دورا كاملا لكل Bot على حدة
تطلب مرة واحدة. ويتولى توزيع العمل
يرد، ويفتح وكلاء للأجزاء الطويلة، ثم يعود إليك بأسئلتهم ونتائجهم.
أنت، 09:12
صحح خطأ السعر المطبعي في موقعي. واكتشف سبب بطء إتمام الشراء في المتجر.
Chief، 09:12
أبدأ الآن. أفتح وكيلين: أحدهما على موقعي للإصلاح، والآخر على المتجر لقياس زمن إتمام الشراء. سأعود إليك بتقرير.
Chief، 09:19
أصلح وكيل موقعي الخطأ المطبعي ويريد تشغيل هذا. هل تسمح بذلك؟
bash: ./publish.sh
أنت، 09:20
نعم، تابع.
Chief، 09:31
اكتمل العمل على موقعي: الإصلاح منشور. يتوقف إتمام الشراء عند استعلام واحد بطيء، ولدى وكيل المتجر إصلاح جاهز للتجربة.
أنت، 09:12
صحح خطأ السعر المطبعي في موقعي. واكتشف سبب بطء إتمام الشراء في المتجر.
Chief، 09:12
أبدأ الآن. أفتح وكيلين: أحدهما على موقعي للإصلاح، والآخر على المتجر لقياس زمن إتمام الشراء. سأعود إليك بتقرير.
Chief، 09:19
أصلح وكيل موقعي الخطأ المطبعي ويريد تشغيل هذا. هل تسمح بذلك؟
bash: ./publish.sh
أنت، 09:20
نعم، تابع.
Chief، 09:31
اكتمل العمل على موقعي: الإصلاح منشور. يتوقف إتمام الشراء عند استعلام واحد بطيء، ولدى وكيل المتجر إصلاح جاهز للتجربة.
تصحيح الخطأ المطبعي في السعر
يعمليسألكتمعلى موقعيالنموذج: Hoody AI (مجاني)
الآن: تعديل صفحة الأسعارينتظر: bash: ./publish.shعاد بتقرير
قياس زمن إتمام الشراء
يعمليسألكتمعلى المتجرالنموذج: Hoody AI (مجاني)
الآن: قياس زمن إتمام الشراءعاد بتقرير
أنت، 10:02
أضف قائمة الطعام الخريفية الجديدة إلى المتجر، وتأكد أن اختبارات الطلبات ما زالت تنجح.
مسؤول المتجر، 10:02
أبدأ الآن. يضيف وكيل واحد القائمة، ويشغّل آخر اختبارات الطلبات. وسأخبرك عند انتهاء الاثنين.
مسؤول المتجر، 10:14
وكيل القائمة جاهز لنشر قائمة الطعام الخريفية. هل تسمح بذلك؟
bash: ./menu.sh
أنت، 10:15
نعم، انشرها.
مسؤول المتجر، 10:21
اكتمل العمل: قائمة الطعام الخريفية منشورة في المتجر، ونجحت جميع اختبارات الطلبات وعددها 48.
إضافة قائمة الطعام الخريفية
يعمليسألكتمعلى المتجرالنموذج: Hoody AI (مجاني)
الآن: إضافة أطباق جديدة (12)ينتظر: bash: ./menu.shعاد بتقرير
تشغيل اختبارات الطلبات
يعمليسألكتمعلى المتجرالنموذج: Hoody AI (مجاني)
الآن: تشغيل اختبارات الطلبات (48)عاد بتقرير
أنت، 21:40
الصور شبه ممتلئة. نظف المكررات وتحقق من النسخة الاحتياطية.
أمين الصور، 21:40
أبدأ الآن. يبحث وكيل واحد عن المكررات، ويفحص آخر النسخة الاحتياطية. وسأعود إليك بتقرير.
أمين الصور، 21:52
عثر وكيل التنظيف على 1,240 ملف مكرر. هل تريد حذفها؟
bash: ./clean.sh
أنت، 21:53
نعم، احذفها.
أمين الصور، 22:05
اكتمل: أزيل 1,240 ملف مكرر وعادت مساحة 18 GB حرة. النسخة الاحتياطية لليلة الماضية مكتملة.
إزالة الملفات المكررة
يعمليسألكتمعلى الصورالنموذج: Hoody AI (مجانية)
الآن: مقارنة الصورينتظر: bash: ./clean.shأعاد تقريره
فحص النسخة الاحتياطية
يعمليسألكتمعلى الصورالنموذج: Hoody AI (مجانية)
الآن: قراءة النسخة الاحتياطيةأعاد تقريره
أنت، 08:03
هل يعمل موقعي؟ يقول أحدهم إن نموذج الاتصال معطل.
مراقب الموقع، 08:03
أفحص الآن. وكيل واحد يختبر الموقع، ووكيل آخر يراجع النموذج. سأعود إليك بتقرير.
مراقب الموقع، 08:11
وجد وكيل النموذج الخلل ولديه إصلاح. هل تريد نشره؟
bash: ./publish.sh
أنت، 08:12
نعم، انشره.
مراقب الموقع، 08:19
اكتمل: موقعي يعمل ونموذج الاتصال يعمل من جديد. اختبره وكيل النموذج بعد الإصلاح.
إصلاح نموذج الاتصال
يعمليسألكتمعلى موقعيالنموذج: Hoody AI (مجاني)
الآن: قراءة أخطاء النموذجينتظر: bash: ./publish.shأعاد تقريره
فحص كل صفحة
يعمليسألكتمعلى موقعيالنموذج: Hoody AI (مجاني)
الآن: فتح 40 صفحةأعاد تقريره
أنت، 15:30
أي أداة من أدوات النشرة البريدية الثلاث هي الأرخص لعدد 5,000 قارئ؟
رفيق البحث، 15:30
أعمل على ذلك. يقرأ وكيلان عن الأدوات، ثم أعود إليك باختيار واحد.
رفيق البحث، 15:41
يريد وكيل الأسعار حفظ ملاحظاته على المتجر. هل تسمح بذلك؟
write: notes/tools.md
أنت، 15:42
نعم، احفظها.
رفيق البحث، 15:47
اكتمل: الأداة B هي الأرخص لعدد 5,000 قارئ. تسرد الملاحظات على المتجر الأسعار الثلاثة كلها.
مقارنة الأسعار
يعمليسألكتمعلى المتجرالنموذج: Hoody AI (مجاني)
الآن: قراءة ثلاث صفحات أسعارينتظر: write: notes/tools.mdأعاد تقريره
مقارنة الميزات
يعمليسألكتمعلى المتجرالنموذج: Hoody AI (مجاني)
الآن: سرد الميزاتأعاد تقريره
عمليًا
- رسالتك
POST /يعيدapi/ v1/ agent/ bots/ chief/ messages 202معmessage_idوstateوturn_id؛ ويعيدstate: queuedأثناء انشغال Bot.- رده
GET /SSE: إطارapi/ v1/ agent/ bots/ chief/ stream state، ثمrowواحد لكل صف في السجل؛ للاستئناف استخدمLast-Event-ID.- إيقاف وكيل واحد
POST /يوقف عمل ذلك الوكيل فورًا دون أن يوقف Bot. ويغلقapi/ v1/ agent/ bots/ chief/ delegates/ {sid}/ stop {"close": true}جلسته أيضًا.- تحدث بالصوت
POST /تحويل تسجيل wav أو mp3 إلى نص وإرساله كرسالة منك.api/ v1/ agent/ bots/ chief/ messages/ audio
امنح Bot عنوان URL عاما. اربط به من تثق بهم من أشخاص وتطبيقات وأنظمة ذكاء اصطناعي.
عنوان URL واحد وثلاثة مداخل: كنموذج للتطبيقات وحزم SDK التي تقبل عنوان URL أساسيا (بصيغة OpenAI أو Anthropic)، أو كخادم MCP، أو عبر HTTP عادي من سكربت.
chief · Bot URL
https://<label>.hoody.bot 1في تطبيق
إكمالات الدردشة والاستجابات والنماذج. يقتصر الإرسال على آخر رسالة للمستخدم، ويستثنى موجه نظام التطبيق وإعداداته.
الرسائل والنماذج، على عنوان URL من دون /v1. يقتصر الإرسال على آخر رسالة للمستخدم، ويستثنى موجه نظام التطبيق وإعداداته.
Bot كخادم MCP: ردود JSON-RPC، ولا جلسة للاحتفاظ بها ولا بث للأحداث.
مثال استخدام Bot كنموذج
يخاطب Bot المسمى chief مثل أي نموذج ذكاء اصطناعي، من أي تطبيق يدعم صيغة OpenAI.
استخدم Bot المسمى chief كنموذج في تطبيقي.
import OpenAI from 'openai';
const chief = new OpenAI({
baseURL: 'https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/global/chief/v1',
apiKey: 'any',
});
const res = await chief.chat.completions.create({
model: 'bot:global/chief',
messages: [{ role: 'user', content: 'Is the shop up?' }],
});import requests
r = requests.post(
"https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/global/chief/v1/chat/completions",
json={
"model": "bot:global/chief",
"messages": [{"role": "user", "content": "Is the shop up?"}],
},
)
print(r.json())BASE="https://{p}-{c}-agent-1.{node}.computers.hoody.com"
curl -X POST "$BASE/api/v1/agent/bots/global/chief/v1/chat/completions" \
-H "Content-Type: application/json" \
-d '{"model": "bot:global/chief", "messages": [{"role": "user", "content": "Is the shop up?"}]}'curl -X POST "https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/global/chief/v1/chat/completions" \
-H "Content-Type: application/json" \
-d '{"model": "bot:global/chief", "messages": [{"role": "user", "content": "Is the shop up?"}]}'import requests
r = requests.post(
"https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/global/chief/v1/chat/completions",
json={
"model": "bot:global/chief",
"messages": [{"role": "user", "content": "Is the shop up?"}],
},
)
print(r.json())https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request?url=https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/global/chief/v1/chat/completions&method=POST&json={"model":"bot:global/chief","messages":[{"role":"user","content":"Is%20the%20shop%20up?"}]}&response=transparent2من سكربت
HTTP عادي
POST /bots/ chief/ messages أسند إليه مهمة من سكربت أو من مهمة cron أو من ذكاء اصطناعي آخر.
GET /bots/ chief/ stream تابع الردود المكتملة وأحداث الوكلاء. يعرض بث جلسة Bot نص الرد أثناء كتابته.
POST /bots/ chief/ delegates/ {sid}/ stop أوقف وكيلا واحدا، ويواصل Bot عمله.
مثال إسناد مهمة إلى Bot
يطلب من Bot المسمى chief التحقق من أن المتجر يعمل.
اطلب من Bot المسمى chief التحقق من أن المتجر يعمل.
hoody -c {c} agent bots messages send \
--id chief \
--text "Check that the shop is up"import { HoodyClient } from 'hoody-sdk';
const hoody = new HoodyClient({ baseURL: 'https://api.hoody.com', token: process.env.HOODY_TOKEN });
const box = await hoody.withComputer('{c}');
const result = await box.agent.bots.sendMessage('chief', { text: 'Check that the shop is up' });
console.log(result.state);import requests
r = requests.post(
"https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/chief/messages",
json={"text": "Check that the shop is up"},
)
print(r.json())BASE="https://{p}-{c}-agent-1.{node}.computers.hoody.com"
curl -X POST "$BASE/api/v1/agent/bots/chief/messages" \
-H "Content-Type: application/json" \
-d '{"text": "Check that the shop is up"}'curl -X POST "https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/chief/messages" \
-H "Content-Type: application/json" \
-d '{"text": "Check that the shop is up"}'import requests
r = requests.post(
"https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/chief/messages",
json={"text": "Check that the shop is up"},
)
print(r.json())https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request?url=https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/chief/messages&method=POST&json={"text":"Check%20that%20the%20shop%20is%20up"}&response=transparent3من يدخل
امنح كل شخص أو تطبيق موثوق مفتاحا يحمل اسما. أوقفه مؤقتًا، أو حدد له موعد انتهاء أو قيدا على IPv4، أو ألغه على حدة.
كل من يملك مفتاحا يشارك في محادثة واحدة. شارك فقط مع الأشخاص وأنظمة الذكاء الاصطناعي التي تثق بها.
اجعل Bot ضمن مجال واحد: لا يرى وكلاؤه سوى أجهزة الكمبيوتر في ذلك المجال.
عمليًا
- عنوان Bot الأساسي
https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{realm}/{bot}OpenAI:<base>/v1، وAnthropic: العنوان الأساسي، وMCP:<base>/mcp.{realm}هوglobalأو معرف سداسي عشري من 24 خانة. يسردهاGET /bots/{id}ضمنurls. Bot مشترك:https://<label>.hoody.bot/v1/chat/completionsمع مفتاح Bearer.- إرسال رسالة
curl -X POST "<agent>/api/v1/agent/bots/chief/messages" -H "Authorization: Bearer <token>" -d '{"text":"Ship it"}'حتى 64 KiB من النص؛ ويعيد الرمز 202.- إيقاف وكيل واحد
POST /api/v1/agent/bots/chief/delegates/{sid}/stop {"close":true}يوقف وكيلا فرعيا، وليس Bot.
بلغة واضحة. هذا هو الإعداد كله.
اكتب ما يجب ألا يفعله Bot، بكلماتك. احفظ. انتهى الأمر.
- بلا صيغة خاصة
- يحصل عليها كل وكيل
- فحص العمل المحفوف بالمخاطر قبل بدئه
chief · الضوابطمثال
عمليًا
- استبدال الضوابط
PUT /api/v1/agent/bots/chief/guardrails {"guardrails":"Never push to main."}حقل نصي واحد؛ يصل كل سطر إلى Bot مع علامة[guardrails updated]قبل رسالته التالية.- درجة الصرامة
"guardrail_check": "strict"strict(افتراضي)، أوlenientأوoff. docs / api / agent / bots ↗
عمليًا
- الإرسال من أي مكان
POST /api/v1/agent/bots/chief/messages {"text":"Is staging up?"}يرد بالرمز 202، ويردqueuedأثناء انشغال Bot. أضفIdempotency-Keyلإعادة المحاولة بأمان.- استئناف البث
GET /api/v1/agent/bots/chief/stream?since=154Server-Sent Events؛ معرّف كل إطار صف هوseq، لذا يستأنفLast-Event-IDالبث تلقائيًا.- مداخل الصوت
…/bots/{id}/voice · …/bots/{id}/realtimeاتصال صوتي مباشر واحد لكل Bot في الوقت نفسه؛ يستبدلهtakeover=true. docs / api / agent / bots ↗
المزيد: السجل
أربعة أجهزة مفتوحة على Bot واحد: هاتف، ولابتوب، وطرفية، وتطبيق ذكاء اصطناعي. يرسل الهاتف واللابتوب في اللحظة نفسها، 22:31؛ فتصل الرسالتان بالرقمين #152 ثم #153، ويرد Bot بالرقم #154. يرى كل جهاز الترتيب نفسه. تتحول الأدوار الأقدم إلى ملخص قصير، وهي الصفوف من #1 إلى #120؛ وتبقى أحدث الأدوار، من #121 إلى #154، حرفيًا. يحتفظ السجل الكامل بكل صف.
كل الأجهزة، محادثة واحدة. الهاتف واللابتوب والطرفية وتطبيقات الذكاء الاصطناعي لديك مفتوحة كلها على Bot واحد في الوقت نفسه، ويرى كل جهاز الترتيب نفسه. ويشاركه أصحاب المفاتيح أيضًا، لذا لا تشاركه إلا مع من تثق بهم.
تأخذ كل رسالة الرقم التالي. الرسالتان المرسلتان في اللحظة نفسها تصلان بالرقمين #152 ثم #153. وتنتظر الرسالة المرسلة أثناء انشغال Bot دورها التالي.
لا تنفد المساحة. عندما تمتلئ نافذة النموذج، تتحول الأدوار الأقدم إلى ملخص قصير، وتبقى الأحدث حرفيًا، ويواصل Bot عمله. يحتفظ السجل بكل صف؛ وينقل النسيان الصفوف إلى الأرشيف.
محتوى الصف
seq وat وrole (user أو bot أو event أو system) وtext. ويمكن أن يضم الصف أيضًا session_id. يقسم السجل الصفوف إلى صفحات حسب seq؛ ويرسل البث كل صف جديد لحظة كتابته.تبديل النماذج
ذاكرة يحتفظ بها وكلاؤك
عمليًا
- اقرأ السجل
GET /api/v1/agent/bots/chief/logالصفوف بالترتيب، مقسمة إلى صفحات حسبseq.- تابعه
GET /api/v1/agent/bots/chief/streamإطارstateأولًا، ثم الصفوف؛ أما المؤشر المنقول إلى الأرشيف فيرد بالرمزlagged.- النسيان
POST /api/v1/agent/bots/chief/forgetاقرأه لاحقًا عبرGET …/archive؛ واحذفه عبرPOST …/purge.- الوثائق
- docs / api / agent / bots ↗
المزيد: الخطافات
اربط خطافا. يرى السكربت الاستدعاء أولًا والرد أخيرًا
يمرر الخطاف استدعاءات HTTP المطابقة أولًا عبر أحد نصوص Exec البرمجية لديك، قبل أن تصل إلى Bot أو معظم الخدمات الأخرى على أجهزة الكمبيوتر لديك. يرفض الخطاف ترقيات WebSocket على المسار المطابق، لذا اترك مسارات مثل بوابات الصوت في Bot خارج المطابقة. عند الدخول يمكنه مراقبتها أو فحصها أو تغييرها أو الرد عليها أو حظرها. وعند الخروج يقرأ الرد ويغيره قبل أن يصل إلى المتصل. لا حاجة إلى ترقيع أي شيء.
دخولعند الدخول
مراقبةسجّل من أرسل الاستدعاء وما أرسله، ثم مرّره.عرض السكربتإخفاء السكربت
القاعدة:
POST /api/v1/agent/bots/*←/bot-auditmodule.exports = async function (req, res, metadata) { if (!metadata.hook) { res.writeHead(404); return res.end(); } const ip = req.headers['x-real-ip']; console.log(metadata.hook.auditId, metadata.hook.origPath, ip); await metadata.hook.forward(req, res); };يرى السكربت عنوان IP الحقيقي للعميل. عند استدعائه دون خطاف يكون
metadata.hookفارغا، فيرد بالرمز 404. يمررforward()الاستدعاء إلى Bot كما هو.فحصاسمح بالمرور لمن سجّل الدخول فقط. ويوضع حد المعدل في الموضع نفسه.عرض السكربتإخفاء السكربت
القاعدة:
any method except OPTIONS /api/v1/agent/bots/*←/identity-gatemodule.exports = async function (req, res, metadata) { if (!metadata.hook) { res.writeHead(404); return res.end(); } const user = verifyClaim( req.headers['x-hoody-claim']); if (!user) { res.writeHead(401); return res.end(); } await metadata.hook.forward(req, res, { headers: { 'x-hoody-claim': null, 'x-hoody-user': user.username, } }); };يفحص
verifyClaimبيان تسجيل دخول من Hoody موقّعا باستخدام ED25519؛ والنص البرمجي الكامل في الوثائق. ومن لا يملك هذا البيان يحصل على 401 ولا يصل إلى Bot. ستحجب هذه القاعدة أيضًا مسارات الصوت عبر WebSocket؛ ضيّقها لتستثنيها.- تغييرأعد كتابة الطريقة أو المسار أو الترويسات أو المتن قبل وصوله.
- حظرارفض عمليات الرفع التي تفشل في فحص الفيروسات، أو الاستدعاءات التي تتجاوز حدك.
ردأرسل الرد بنفسك، مثل «نعود قريبًا»، فلا يرى Bot الاستدعاء.عرض السكربتإخفاء السكربت
القاعدة:
POST /api/v1/agent/bots/*←/bot-gatemodule.exports = async function (req, res, metadata) { if (!metadata.hook) { res.writeHead(404); return res.end(); } if (process.env.MAINTENANCE) { res.writeHead(503); return res.end('Back soon'); } await metadata.hook.forward(req, res, { headers: { cookie: null } }); };الرد الذي يرسله السكربت لا يصل إلى Bot. ويمكن أيضًا أن يغير
forward()الطريقة أو المسار أو الترويسات أو المتن؛ وتحذف أي ترويسة مضبوطة علىnull.
خروجعند الخروج
- قراءة الرداطلع على حالته وترويساته ومتنه قبل المتصل.
إعادة كتابةمرّر الرد كما هو، أو أرسل ردك.عرض السكربتإخفاء السكربت
القاعدة:
any method except OPTIONS /api/v1/agent/bots/*←/bot-answermodule.exports = async function (req, res, metadata) { if (!metadata.hook) { res.writeHead(404); return res.end(); } const up = await metadata.hook.fetchUpstream(req); if (up.status === 401) { res.writeHead(401); return res.end('Please sign in again'); } res.setHeader('x-hoody-hook-audit', metadata.hook.auditId); await metadata.hook.pipeResponse(up, res, { method: req.method }); };يحصل
fetchUpstream()على رد Bot دون إرساله، فيقرؤه السكربت أولًا؛ ثم يمررهpipeResponse(). ينتهي الرد المتدفق عند الحد الزمني للخطاف، وهو 30,000 ms كحد أقصى.- تنظيف الترويساتأزل الترويسات الخاصة من الردود، وأضف CSP.
لكل خطاف حد زمني، 500 ms افتراضيًا. إذا تعذر تشغيل السكربت أو انتهت مهلته، يتوقف الاستدعاء عندها. docs / proxy / hooks ↗
عمليًا
- إضافة خطاف
POST /api/v1/computers/{id}/proxy/hooks/agent · If-Match: file:v<N> {"match":{"method":["POST"],"path":"/api/v1/agent/bots/*"},"script":{"path":"/bot-audit"},"timeout":500}يمنح الخادم الخطاف معرّفه. تعمل القواعد بالترتيب وتنطبق أول قاعدة مطابقة.- قراءة الإصدار
GET /api/v1/computers/{id}/proxy/hooks/agentيحتاج كل تغيير في الخطافات إلىIf-Match: file:v<N>مع الإصدار الحالي.- السكربت
POST /api/v1/exec/scripts/write {"path":"bot-audit.js","content":"module.exports = async function (req, res, metadata) { … }"}متن السكربت هنا هو الهيكل فقط: ضع شيفرة التدقيق مكان{ … }. يسميscript.pathسكربتا في hoody-exec لديك. اكتبه على رابط exec لديك؛ ويقدم/bot-auditbot-audit.js. docs / api / exec / script-management ↗
ابدأ مجانًا في سطر واحد
البدء مجاني دون بطاقة. خدمة Hoody AI مدمجة، ويعمل كذلك الذكاء الاصطناعي الذي تستخدمه بالفعل.
يعمل في ChatGPT وClaude وأي ذكاء اصطناعي يستطيع جلب صفحة. انسخه وألصقه.
- الطرفية
ssh hoody.comأي جهاز يتضمن عميل ssh في طرفية تفاعلية، ولا حاجة إلى تثبيت شيء.- docs / kit / agent
- المهارة
npx skills add https://hoody.com/SKILLS/SKILL.mdnpx skills add HoodyNetwork/hoody-sdkيضيف الأمر الثاني كل صفحات الوثائق على القرص للاستخدام دون اتصال.- docs / foundation / agent-skill-bundle
- CLI
npm install -g hoody-sdkcurl -fsSL https://install.hoody.com | shالأمر الثاني لنظامي Linux وmacOS. دون تثبيت:npx hoody-sdk <command>- docs / foundation / cli
- SDK
npm install hoody-sdkTypeScript. Node.js 20.19 أو أحدث، وBun وDeno.- docs / getting-started / quickstart
- HTTP API
curl -H "Authorization: Bearer <token>" https://api.hoody.com/api/v1/computers/- docs / api / authentication
- SDK للمتصفح
<script src="https://cdn.jsdelivr.net/npm/hoody-sdk/dist/hoody-sdk.browser.min.js"></script>يتيحwindow.HoodySDK. ثبّت إصدارا في بيئة الإنتاج، وامنح الصفحات رموز وصول قصيرة العمر بأذونات محددة.- docs / getting-started / quickstart