İçeriğe geç
Yapay zekanız@https://hoody.com Connect to Hoody

Geliştirici modu

Sade tuttuk. İşte Hoody, somut haliyle.

Her bölüm artık arkasındaki Bot API çağrılarını gösterir ve Kopyala düğmesi sunar. Çağrıların tamamı en sonda.

Çağrıları açın

hoody / bots

Bots

Bot'larınızla konuşun.
Ajanları onlar çalıştırır.

Bot, tüm konuşmayı tutan tek bir sohbeti olan kalıcı bir asistandır. Ne isterseniz isteyin: bilgisayarlarınızda ajanlar açar, işlerini izler ve ne yaptıklarını bildirir. Bot'a bir .hoody.bot URL'si verin ve adlandırılmış anahtarlarla güvendiğiniz kişilerle ve yapay zekalarla paylaşın.

İlk Bot'unuz chief baştan hazırdır. Hoody AI (ücretsiz) yerleşiktir. İsterseniz ChatGPT ile oturum açın. Bot'un yardımcıları, izin verdiğinizde Claude Pro veya Max planını Claude Code ile kullanabilir.

Nasıl birleşirÖrnek
Siz

Sitem'deki yazım hatasını ve Mağaza fiyatını düzeltin, sonra yeni fotoğrafları düzenleyin.

Bot'unuz

chieftek sohbet · eski bölümler özetlenir · sınırlarınız

Ajanlar

bittiSitem'in yazım hatasını düzeltme

size soruyorMağaza fiyatını düzeltme

çalışıyorYeni fotoğrafları düzenleme

Bilgisayarlarınız
Sitem Mağaza Fotoğraflar

Her ajan, bilgisayarlarınızdan birinde çalışan tam bir Hoody Agent oturumudur.

Somut olarak

İlk Bot'unuz
GET /api/v1/agent/bots/chiefchief ilk kullanımda oluşturulur, bu yüzden Bot'ların listesi hiç boş kalmaz.
Nerede çalışır
https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/botsBot'lar Hoody Agent'te çalışır (agent-1). /api/bot/ adresindeki sohbet uygulaması hizmetinde değil.
hoody / how it flows

Tek mesaj sonuna kadar gider. Geriye bir rapor döner.

Siz

bunlardan herhangi biri

RaporBitti. Mağaza düzeltildi.

Bilgisayarlarınız

Bot'unuz

mesajınızı hemen alır, iş bitince rapor verir

Agent

yardımcıları

Agent

yardımcıları

  • Sitemgüncelleme
  • Mağazadüzeltme
  • Fotoğraflaryedekleme

ÖrnekHepsi bilgisayarlarınızda çalışır. Bot'unuz her birini tanır.

Somut olarak

Ajanları
GET /api/v1/agent/bots/chief/delegates?state=openDevredilen her ajan sıradan bir oturumdur; /sessions rotalarıyla okunur ya da bağlanır. Açık olanlar capability ve current_step taşır.
Kendi canlı turu
GET /api/v1/agent/sessions/{session_id}/streamYanıt metni ve düşünme yazıldıkça, araç çağrıları ve her turun sonu. Bot ilk mesajını aldıktan sonra session_id şuradan gelir: GET /bots/{id}.
Daha fazla: tam bir turu izleyin, her seferinde bir Bot

Bir kez sorun. İşi o dağıtır.

Yanıt verir, uzun işler için ajanlar açar; ajanların sorularıyla ve sonuçlarıyla size döner.

Örnek tur

Siz, 09:12

Sitem'deki fiyat yazım hatasını düzeltin. Ayrıca Mağaza'da ödemenin neden yavaşladığını bulun.

Chief, 09:12

Başlıyorum. İki ajan açıyorum: biri düzeltme için Sitem'de, biri ödeme süresini ölçmek için Mağaza'da. Size bildireceğim.

açıldı 2 ajan · Sitem, Mağaza

Chief, 09:19

Sitem ajanı yazım hatasını düzeltti ve bunu çalıştırmak istiyor. İzin verilsin mi?

bash: ./publish.sh

Siz, 09:20

Evet, devam edin.

[rapor] Sitem ajanı tamamladı: Yazım hatası düzeltildi, site güncellendi.

Chief, 09:31

Sitem tamam: düzeltme yayında. Ödeme, yavaş bir sorguda bekliyor; Mağaza ajanının denenmeye hazır bir düzeltmesi var.

İstediğiniz zaman yazınMeşgulken gönderilen mesaj sırasını bekler. Bir düzeltme gönderin, ikisini birlikte okur.
Bilgisayarlarınızda çalışırAjanlar kodunuzun ve dosyalarınızın olduğu yerde çalışır; sekmeyi kapattıktan sonra da çalışmaya devam eder.
Sormak için geri gelirBir ajanın isteği yalnızca gönderdiğiniz bir mesajla onaylanır, ajanın raporuyla asla onaylanmaz.

Somut olarak

Mesajınız
POST /api/v1/agent/bots/chief/messages202 ile yanıt verir: message_id, state ve turn_id; Bot meşgulken state: queued.
Yanıtı
GET /api/v1/agent/bots/chief/streamSSE: bir state çerçevesi, sonra her log satırı için bir row; Last-Event-ID ile devam edin.
Bir ajanı durdurma
POST /api/v1/agent/bots/chief/delegates/{sid}/stopO ajanın işini hemen durdurur; Bot'u durdurmaz. {"close": true} ayrıca oturumunu kapatır.
Sesli söyleyin
POST /api/v1/agent/bots/chief/messages/audiowav veya mp3 kaydı yazıya dökülür ve mesajınız olarak gönderilir.
hoody / api

Bot'unuza herkese açık bir URL verin. Güvendiğiniz kişileri, uygulamaları ve yapay zekaları bağlayın.

Tek URL, üç giriş yolu: temel URL alan uygulamalar ve SDK'ler için model olarak (OpenAI veya Anthropic biçimi), MCP sunucusu olarak ya da bir betikten düz HTTP ile.

chief · Bot URL'si

https://<label>.hoody.bot
Bir Bot'un QR kodu; ortasında Bot işareti var ve Hub'ın çizdiği haliyle görünür. Kodu tarayan telefon Bot'un sohbet sayfasını açar. Bu örnek şu adresi açar: hoody.com/bots.

1Bir uygulamada

UygulamanızÖrnek kimlikler
Biçim
Temel URL<Bot URL>/v1
Modelbot:global/chief
API anahtarıhbk_ anahtarınız
Temel URL<Bot URL>
Modelbot:global/chief
API anahtarıhbk_ anahtarınız
Sunucu URL'si<Bot URL>/mcp
AktarımHTTP, her istekte POST
API anahtarıhbk_ anahtarınız

Sohbet tamamlamaları, yanıtlar ve modeller. Yalnızca son kullanıcı mesajı gönderilir; uygulamanın kendi sistem istemi ve ayarları dışarıda kalır.

Mesajlar ve modeller, /v1 içermeyen URL'de. Yalnızca son kullanıcı mesajı gönderilir; uygulamanın kendi sistem istemi ve ayarları dışarıda kalır.

Bot'unuz MCP sunucusu olarak: JSON-RPC yanıtları, tutulacak oturum yok, olay akışı yok.

2Bir betikten

Düz HTTP

  • POST /bots/chief/messages

    Betikten, cron görevinden veya başka bir yapay zekadan görev verin.

  • GET /bots/chief/stream

    Tamamlanan yanıtları ve ajan olaylarını izleyin. Bot'un oturum akışı, yanıt metnini yazıldıkça gösterir.

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

    Bir ajanı durdurun; Bot çalışmaya devam eder.

3Kimler girebilir

Güvendiğiniz her kişiye veya uygulamaya adlandırılmış bir anahtar verin. Anahtarı duraklatın, son kullanma tarihi veya IPv4 kısıtı belirleyin ya da ayrı ayrı iptal edin.

Anahtarı olan herkes aynı konuşmayı paylaşır. Yalnızca güvendiğiniz kişilerle ve yapay zekalarla paylaşın.

Bot'u tek bir gruba bağlayın: ajanları yalnızca o grubun bilgisayarlarını görür.

Somut olarak

Bot temel URL'si
https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{realm}/{bot}OpenAI <base>/v1, Anthropic temel URL'yi, MCP <base>/mcp kullanır. {realm}, global veya 24 haneli onaltılık bir kimliktir. GET /bots/{id} bunları urls altında listeler. Paylaşılan Bot: Bearer anahtarıyla https://<label>.hoody.bot/v1/chat/completions.
Mesaj gönderme
curl -X POST "<agent>/api/v1/agent/bots/chief/messages" -H "Authorization: Bearer <token>" -d '{"text":"Ship it"}'En fazla 64 KiB metin; 202 ile yanıt verir.
Bir ajanı durdurma
POST /api/v1/agent/bots/chief/delegates/{sid}/stop {"close":true}Bir alt ajanı durdurur; Bot'u asla durdurmaz.
hoody / guardrails

Sade Türkçe. Kurulum bu kadar.

Bot'unuzun asla yapmaması gerekenleri kendi sözlerinizle yazın. Kaydedin. Bitti.

  • Sözdizimi yok
  • Her ajan bunu alır
  • Riskli işler başlamadan önce denetlenir

chief · güvenlik sınırlarıÖrnek

main dalına asla göndermeyin, PR açın ve beni bekleyin faturalandırmaya, DNS'e ve ödemelere dokunmayın prod veritabanı salt okunur bir iş 20 $'dan fazlaya mal olacaksa durun ve sorun emin değilseniz bana sorun, tahmin etmeyin

Somut olarak

Koruma kurallarını değiştirme
PUT /api/v1/agent/bots/chief/guardrails {"guardrails":"Never push to main."}Tek bir metin alanı; Bot, sonraki mesajından önce her satırı [guardrails updated] işaretiyle alır.
Ne kadar sıkı
"guardrail_check": "strict"strict (varsayılan), lenient veya off. docs / api / agent / bots ↗

Somut olarak

Her yerden gönderme
POST /api/v1/agent/bots/chief/messages {"text":"Is staging up?"}202 yanıtı verir; Bot meşgulken queued. Güvenle yeniden denemek için bir Idempotency-Key ekleyin.
Akışı sürdürme
GET /api/v1/agent/bots/chief/stream?since=154Server-Sent Events; her satır çerçevesinin kimliği seq değeridir, bu yüzden Last-Event-ID kendiliğinden devam eder.
Ses kapıları
…/bots/{id}/voice · …/bots/{id}/realtimeBot başına aynı anda tek bir canlı ses bağlantısı olur; takeover=true onun yerini alır. docs / api / agent / bots ↗
Daha fazla: log
Örnek: dört cihaz, tek Bot, tek kayıt

Aynı Bot'ta dört cihaz açık: bir telefon, bir dizüstü bilgisayar, bir terminal ve bir yapay zeka uygulaması. Telefon ve dizüstü bilgisayar aynı anda, 22:31'de mesaj gönderir; mesajlar önce #152, sonra #153 olarak sıraya girer, Bot da yanıtı #154 olarak verir. Her cihaz aynı sırayı görür. Eski turlar kısa bir özete katlanır (#1 ile #120 arası satırlar); en yeni turlar, yani #121 ile #154 arası, kelimesi kelimesine kalır. Tam log her satırı tutar.

Her cihaz, tek konuşma. Telefonunuz, dizüstü bilgisayarınız, terminaliniz ve yapay zeka uygulamalarınız aynı anda aynı Bot'ta açıktır ve her cihaz aynı sırayı görür. Anahtar sahipleri de aynı konuşmayı paylaşır, bu yüzden yalnızca güvendiğiniz kişilerle paylaşın.

Her mesaj sıradaki numarayı alır. Aynı anda gönderilen iki mesaj önce #152, sonra #153 olur. Bot meşgulken gönderilen mesaj, Bot'un bir sonraki turunu bekler.

Yer hiç bitmez. Modelin bağlam penceresi dolunca eski turlar kısa bir özete katlanır, en yeniler kelimesi kelimesine kalır ve Bot devam eder. Log her satırı tutar; unutma işlemi satırları arşive taşır.

Bir satırda ne var
Her satırda seq, at, role (user, bot, event veya system) ve text var. Ayrıca session_id da olabilir. Log, seq ile sayfalanır; akış her yeni satırı yazıldığı anda gönderir.
Model değiştirme
Yeni model, Bot'un bir sonraki oturumuyla başlar: sıfırlama log'u arşive taşır ve yeni oturumu açar. Arşiv, siz temizleyene kadar okunabilir kalır.
Ajanlarınızın tuttuğu hafıza
Ajanlar kendi hafızalarını da kaydeder ve arar (anahtar kelime, anlam ve öğeler arası bağlantılar); hafıza tek bir yapay zeka uygulamasına bağlı değildir. docs / api / agent / memory ↗

Somut olarak

Log'u oku
GET /api/v1/agent/bots/chief/logSatırlar sırayla gelir, seq ile sayfalanır.
Takip et
GET /api/v1/agent/bots/chief/streamÖnce bir state çerçevesi, ardından satırlar gelir; arşive taşınmış bir imleç lagged yanıtı verir.
Unut
POST /api/v1/agent/bots/chief/forgetSonra GET …/archive ile okuyun; POST …/purge ile silin.
Daha fazla: hook'lar

Araya girin. Betiğiniz çağrıyı ilk, yanıtı en son görür.

Hook, eşleşen HTTP çağrılarını Bot'a ya da bilgisayarlarınızdaki diğer hizmetlerin çoğuna ulaşmadan önce Exec betiklerinizden birine gönderir. Eşleşen bir yoldaki WebSocket yükseltmeleri reddedilir; bu yüzden Bot'un ses kapıları gibi yolları eşleşmenin dışında tutun. İçeri giderken çağrıları izleyebilir, denetleyebilir, değiştirebilir, yanıtlayabilir veya engelleyebilir. Dışarı çıkarken yanıtı okuyabilir ve çağıran taraf almadan önce değiştirebilir. Yamalanacak bir şey yok.

Çağıran taraftan Bot'a ya da bilgisayarlarınızdaki diğer hizmetlerin çoğuna uzanan bir döngü. Çağrılar üstten girer, yanıtlar alttan geri döner. Tek bir Exec betiği ikisini de kapsar; böylece her çağrıyı içeri giderken görür, her yanıtı da dışarı çıkarken görebilir. Her hook'un zaman sınırı vardır, varsayılan olarak 500 ms.

Girişİçeri giderken

  • İzleKimin neyi çağırdığını kaydedin, sonra çağrıyı iletin.Betiği gösterBetiği gizle

    Kural: 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);
    };

    Betik gerçek istemci IP'sini görür. Hook olmadan çağrılırsa metadata.hook boştur ve betik 404 yanıtı verir. forward() çağrıyı Bot'a olduğu gibi iletir.

  • DenetleYalnızca oturum açmış kişileri geçirin. Hız sınırı da aynı yere konur.Betiği gösterBetiği gizle

    Kural: 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, ED25519 ile imzalanmış bir Hoody oturum beyanını denetler; tam betik dokümanlarda var. Beyanı olmayan herkes 401 alır ve Bot'a hiç ulaşamaz. Bu kural WebSocket ses yollarını da reddeder; onları dışarıda bırakmak için kuralı daraltın.

  • DeğiştirMetodu, yolu, başlıkları veya gövdeyi çağrı ulaşmadan önce yeniden yazın.
  • EngelleVirüs taramasından geçemeyen yüklemeleri veya sınırınızı aşan çağrıları geri çevirin.
  • YanıtlaKendiniz yanıt verin, örneğin “Birazdan döneriz”; Bot çağrıyı hiç görmez.Betiği gösterBetiği gizle

    Kural: 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 } });
    };

    Betiğin gönderdiği yanıt Bot'a hiç ulaşmaz. forward() ayrıca metodu, yolu, başlıkları veya gövdeyi de değiştirebilir; null olarak ayarlanan bir başlık kaldırılır.

ÇıkışDışarı çıkarken

  • Yanıtı okuDurumunu, başlıklarını ve gövdesini çağıran taraftan önce görün.
  • Yeniden yazYanıtı olduğu gibi iletin ya da kendi yanıtınızı gönderin.Betiği gösterBetiği gizle

    Kural: 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'un yanıtını göndermeden alır, böylece betik önce onu okur; pipeResponse() yanıtı iletir. Akışla gelen yanıt hook'un zaman sınırında biter, en fazla 30.000 ms.

  • Başlıkları temizleYanıtlardan özel başlıkları çıkarın, bir CSP ekleyin.

Her hook'un bir zaman sınırı vardır, varsayılan olarak 500 ms. Betik hata verirse veya süresi dolarsa çağrı orada durur. docs / proxy / hooks ↗

Somut olarak

Hook ekleme
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}Hook'un kimliğini sunucu verir. Kurallar sırayla çalışır ve ilk eşleşme geçerli olur.
Sürümü okuma
GET /api/v1/computers/{id}/proxy/hooks/agentHook'lardaki her değişiklik, geçerli sürümü içeren If-Match: file:v<N> ister.
Betik
POST /api/v1/exec/scripts/write {"path":"bot-audit.js","content":"module.exports = async function (req, res, metadata) { … }"}Buradaki betik gövdesi yalnızca biçimi gösterir: denetim kodunuzu { … } yerine koyun. script.path, kendi hoody-exec hizmetinizdeki bir betiğin adını verir. Betiği exec bağlantınıza yazın; /bot-audit, bot-audit.js sunar. docs / api / exec / script-management ↗

Ücretsiz başlayın, tek satırda.

Kart olmadan ücretsiz başlayın: Hoody AI yerleşiktir, zaten kullandığınız yapay zeka da çalışır.

Kodsuz
Kod
Yapay zekanız@https://hoody.com Connect to Hoody

ChatGPT'de, Claude'da veya sayfa getirebilen her yapay zekada çalışır. Kopyalayıp yapıştırın.

Yapay zekanız
@https://hoody.com Connect to Hoody
docs / foundation / agent-skill-bundle
Tarayıcı
https://hub.hoody.com
docs / kit / agent
Terminal
ssh hoody.comssh istemcisi olan her bilgisayar, etkileşimli bir terminalde. Kurulacak bir şey yok.
docs / kit / agent
Beceri
npx skills add https://hoody.com/SKILLS/SKILL.mdnpx skills add HoodyNetwork/hoody-sdkİkincisi, çevrimdışı kullanım için tüm doküman sayfalarını diske ekler.
docs / foundation / agent-skill-bundle
CLI
npm install -g hoody-sdkcurl -fsSL https://install.hoody.com | shİkincisi Linux ve macOS için. Kurmadan: npx hoody-sdk <command>
docs / foundation / cli
SDK
npm install hoody-sdkTypeScript. Node.js 20.19 veya üstü, Bun, Deno.
docs / getting-started / quickstart
HTTP API
curl -H "Authorization: Bearer <token>" https://api.hoody.com/api/v1/computers/
docs / api / authentication
Tarayıcı SDK'si
<script src="https://cdn.jsdelivr.net/npm/hoody-sdk/dist/hoody-sdk.browser.min.js"></script>window.HoodySDK sunar. Canlı ortamda sürümü sabitleyin, sayfalara kısa ömürlü ve kapsamı sınırlı erişim belirteçleri verin.
docs / getting-started / quickstart

2021'den beri

Gizlilikten ajan tabanlı altyapıya

hoody / kit

Bilgisayarlarınızla gelenler

Her hizmetin kendi bağlantısı vardır. Açın, paylaşın veya yapay zekanıza verin. Bağlantıya sahip herkes, siz kilitleyene kadar onu açabilir. Kit bağlantılarının biçimi https://{p}-{c}-<kit>-1.{node}.computers.hoody.com şeklindedir: {p} projeniz, {c} bilgisayarlarınızdan biri, {node} onun sunucusudur.

Bilgisayarlar

Bots

API