انتقل إلى المحتوى
الذكاء الاصطناعي لديك@https://hoody.com Connect to Hoody

وضع المطور

بكلام بسيط. وهذه Hoody عمليًا.

يعرض كل قسم الآن استدعاءات واجهة Bot API التي تقف خلفه، مع «انسخ». المجموعة الكاملة من الاستدعاءات في النهاية.

افتح الاستدعاءات

hoody / bots

Bots

تحدث إلى Bots لديك.
وهي تدير الوكلاء

Bot مساعد طويل الأمد بمحادثة واحدة تحتفظ بالمحادثة كاملة. اطلب منه أي شيء: يطلق وكلاء على أجهزة الكمبيوتر لديك، ويتابع عملهم، ثم يعود إليك بتقرير عما أنجزوه. امنحه عنوان URL على .hoody.bot وشاركه مع من تثق بهم من أشخاص وأدوات ذكاء اصطناعي عبر مفاتيح تحمل أسماء.

أول Bot لديك، chief، موجود منذ البداية. خدمة Hoody AI (مجانية) مدمجة فيه. أو سجّل الدخول عبر ChatGPT. ويستطيع مساعدو Bot استخدام Claude Pro أو Max عبر Claude Code عندما تسمح لهم بذلك.

كيف يترابطمثال
أنت

صحح الخطأ المطبعي في موقعي وسعر المتجر، ثم رتب الصور الجديدة.

Bot لديك

chiefمحادثة واحدة · الأجزاء الأقدم ملخّصة · حدودك

الوكلاء

تمتصحيح الخطأ المطبعي في موقعي

يسألكتصحيح سعر المتجر

يعملترتيب الصور الجديدة

أجهزة الكمبيوتر لديك
موقعي المتجر الصور

كل وكيل جلسة Hoody Agent كاملة على أحد أجهزة الكمبيوتر لديك.

عمليًا

أول Bot لديك
GET /api/v1/agent/bots/chiefchief ينشأ عند أول استخدام، فلا تكون قائمة Bots فارغة.
مكان التشغيل
https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/botsتعمل Bots على Hoody Agent (agent-1)، وليس على خدمة تطبيق الدردشة في /api/bot/.
hoody / how it flows

رسالة واحدة تصل بالعمل إلى نهايته. ثم يعود تقرير

أنت

من أي من هذه الوسائل

تقريراكتمل العمل. تم إصلاح المتجر.

أجهزة الكمبيوتر لديك

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

اكتمل العمل على موقعي: الإصلاح منشور. يتوقف إتمام الشراء عند استعلام واحد بطيء، ولدى وكيل المتجر إصلاح جاهز للتجربة.

اكتب في أي وقتتنتظر الرسالة المرسلة أثناء انشغال Bot دورها. أرسل تصحيحا فيقرأ الرسالتين معًا.
يعمل على أجهزة الكمبيوتر لديكيعمل الوكلاء حيث توجد الشيفرة والملفات، ويواصلون العمل بعد إغلاق التبويب.
يعود إليك ليسأللا يعتمد طلب الوكيل إلا برسالة ترسلها أنت، وليس بتقرير من الوكيل.

عمليًا

رسالتك
POST /api/v1/agent/bots/chief/messagesيعيد 202 مع message_id وstate وturn_id؛ ويعيد state: queued أثناء انشغال Bot.
رده
GET /api/v1/agent/bots/chief/streamSSE: إطار state، ثم row واحد لكل صف في السجل؛ للاستئناف استخدم Last-Event-ID.
إيقاف وكيل واحد
POST /api/v1/agent/bots/chief/delegates/{sid}/stopيوقف عمل ذلك الوكيل فورًا دون أن يوقف Bot. ويغلق {"close": true} جلسته أيضًا.
تحدث بالصوت
POST /api/v1/agent/bots/chief/messages/audioتحويل تسجيل wav أو mp3 إلى نص وإرساله كرسالة منك.
hoody / api

امنح Bot عنوان URL عاما. اربط به من تثق بهم من أشخاص وتطبيقات وأنظمة ذكاء اصطناعي.

عنوان URL واحد وثلاثة مداخل: كنموذج للتطبيقات وحزم SDK التي تقبل عنوان URL أساسيا (بصيغة OpenAI أو Anthropic)، أو كخادم MCP، أو عبر HTTP عادي من سكربت.

chief · Bot URL

https://<label>.hoody.bot
رمز QR يمثل Bot، وفي وسطه شعار Bot، كما يرسمه Hub: يفتح الهاتف الذي يمسحه صفحة دردشة Bot. يفتح هذا المثال hoody.com/bots.

1في تطبيق

تطبيقكمعرفات المثال
الصيغة
عنوان URL الأساسي<Bot URL>/v1
النموذجbot:global/chief
مفتاح APIمفتاحك hbk_
عنوان URL الأساسي<Bot URL>
النموذجbot:global/chief
مفتاح APIمفتاحك hbk_
عنوان URL للخادم<Bot URL>/mcp
النقلHTTP، وPOST لكل طلب
مفتاح APIمفتاحك hbk_

إكمالات الدردشة والاستجابات والنماذج. يقتصر الإرسال على آخر رسالة للمستخدم، ويستثنى موجه نظام التطبيق وإعداداته.

الرسائل والنماذج، على عنوان URL من دون /v1. يقتصر الإرسال على آخر رسالة للمستخدم، ويستثنى موجه نظام التطبيق وإعداداته.

Bot كخادم MCP: ردود JSON-RPC، ولا جلسة للاحتفاظ بها ولا بث للأحداث.

2من سكربت

HTTP عادي

  • POST /bots/chief/messages

    أسند إليه مهمة من سكربت أو من مهمة cron أو من ذكاء اصطناعي آخر.

  • GET /bots/chief/stream

    تابع الردود المكتملة وأحداث الوكلاء. يعرض بث جلسة Bot نص الرد أثناء كتابته.

  • POST /bots/chief/delegates/{sid}/stop

    أوقف وكيلا واحدا، ويواصل Bot عمله.

3من يدخل

امنح كل شخص أو تطبيق موثوق مفتاحا يحمل اسما. أوقفه مؤقتًا، أو حدد له موعد انتهاء أو قيدا على 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.
hoody / guardrails

بلغة واضحة. هذا هو الإعداد كله.

اكتب ما يجب ألا يفعله Bot، بكلماتك. احفظ. انتهى الأمر.

  • بلا صيغة خاصة
  • يحصل عليها كل وكيل
  • فحص العمل المحفوف بالمخاطر قبل بدئه

chief · الضوابطمثال

لا ترفع التغييرات إلى main، افتح PR وانتظرني لا تلمس الفوترة أو DNS أو المدفوعات قاعدة بيانات الإنتاج للقراءة فقط إذا كلفت مهمة أكثر من 20 دولارا، فتوقف واسأل لست متأكدا؟ اسألني ولا تخمن

عمليًا

استبدال الضوابط
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 واحد، وسجل واحد

أربعة أجهزة مفتوحة على 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؛ ويرسل البث كل صف جديد لحظة كتابته.
تبديل النماذج
يبدأ النموذج الجديد مع الجلسة التالية لدى Bot: تنقل إعادة الضبط السجل إلى الأرشيف وتفتح الجلسة الجديدة. يبقى الأرشيف قابلا للقراءة حتى تحذفه.
ذاكرة يحتفظ بها وكلاؤك
يحفظ الوكلاء أيضًا ذاكرة خاصة بهم ويبحثون فيها (بالكلمات المفتاحية وبالمعنى وبالروابط بين العناصر)، وهي غير مقيدة بتطبيق ذكاء اصطناعي واحد. docs / api / agent / memory ↗

عمليًا

اقرأ السجل
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.
المزيد: الخطافات

اربط خطافا. يرى السكربت الاستدعاء أولًا والرد أخيرًا

يمرر الخطاف استدعاءات HTTP المطابقة أولًا عبر أحد نصوص Exec البرمجية لديك، قبل أن تصل إلى Bot أو معظم الخدمات الأخرى على أجهزة الكمبيوتر لديك. يرفض الخطاف ترقيات WebSocket على المسار المطابق، لذا اترك مسارات مثل بوابات الصوت في Bot خارج المطابقة. عند الدخول يمكنه مراقبتها أو فحصها أو تغييرها أو الرد عليها أو حظرها. وعند الخروج يقرأ الرد ويغيره قبل أن يصل إلى المتصل. لا حاجة إلى ترقيع أي شيء.

حلقة تبدأ من المتصل إلى Bot أو معظم الخدمات الأخرى على أجهزة الكمبيوتر لديك. تدخل الاستدعاءات من الأعلى وتعود الردود من الأسفل. يمتد نص Exec برمجي واحد عبر الاتجاهين، فيرى كل استدعاء عند دخوله ويمكنه أن يرى كل رد عند خروجه. لكل خطاف حد زمني، 500 ms افتراضيًا.

دخولعند الدخول

  • مراقبةسجّل من أرسل الاستدعاء وما أرسله، ثم مرّره.عرض السكربتإخفاء السكربت

    القاعدة: POST /api/v1/agent/bots/* ← /bot-audit

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

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

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

    module.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-audit bot-audit.js. docs / api / exec / script-management ↗

ابدأ مجانًا في سطر واحد

البدء مجاني دون بطاقة. خدمة Hoody AI مدمجة، ويعمل كذلك الذكاء الاصطناعي الذي تستخدمه بالفعل.

بدون كود
الرمز
ذكاؤك الاصطناعي@https://hoody.com Connect to Hoody

يعمل في ChatGPT وClaude وأي ذكاء اصطناعي يستطيع جلب صفحة. انسخه وألصقه.

ذكاؤك
@https://hoody.com Connect to Hoody
docs / foundation / agent-skill-bundle
المتصفح
https://hub.hoody.com
docs / kit / agent
الطرفية
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

منذ 2021

من الخصوصية إلى بنية تحتية للوكلاء

hoody / kit

ما يأتي مع أجهزة الكمبيوتر لديك

لكل خدمة رابطها الخاص. افتحه، أو شاركه، أو سلّمه للذكاء الاصطناعي لديك. يفتحه كل من لديه الرابط إلى أن تقفله. تأخذ روابط Kit الشكل https://{p}-{c}-<kit>-1.{node}.computers.hoody.com: {p} هو مشروعك، و{c} أحد أجهزة الكمبيوتر لديك، و{node} خادمه.

أجهزة الكمبيوتر

Bots

API