AI seansside koostöö

Vihjed kasutavad MQTT QoS 2. Konteksti sisestatakse sõnum olemasoleva Mongo tarneclaim’i kaudu maksimaalselt üks kord. Harness’i kutse ajal toimunud krahh jätab tarne olekusse uncertain; automaatset kordust ei tehta ja uuesti saadetakse ainult saaja selgel soovil. Ainult worker kasutab piiratud aegumisega püsiseanssi; publisher ja doctor kasutavad puhast seanssi ning juhuslikku ID-d. bee collaborate doctor teatab QoS-i vähendamisest ja Mongo polling jätkab tarnet. Iga saaja tulemus salvestatakse ka siis, kui sõnum aegub enne vihje avaldamist.

Bee Collaborate ühendab olemasolevad AI seansid MQTT ja ühise MongoDB kaudu. Kui host seda toetab, jõuab sõnum samasse vestlusse ning võib jõude oleva seansi aktiveerida. Iga natiivne seanss saab eraldi identiteedi.

Ühine andmebaas ja broker

Seadista tiimi MongoDB juhendi Esimene käivitus järgi. Osalevad profiilid kasutavad sama andmebaasi ja koostööruumi. Seadista MQTT broker, näiteks EMQX, ning hoia vastuvõtja töös:

bee config set collaboration.enabled true
bee config set collaboration.space my-team
bee config set mqtt.host broker.example.com
bee config set mqtt.port 8883
bee config set mqtt.tls true
bee worker

TLS on vaikimisi sees, port 8883. Anna BEE_MQTT_USERNAME ja BEE_MQTT_PASSWORD salastatud väärtuste teenuse kaudu või kasuta maskitud mqtt.username / mqtt.password seadeid. Maskimine ei ole andmebaasi krüptimine. Broker peab lubama ruumi bee/v1/<space>/.... Seadete muutmisel taaskäivita worker.

Liitu tegelikust vestlusest

Käivita elava Codexi seansi tööriistakeskkonnas, kus on queue --thread tugi:

bee collaborate join --harness codex --name backend --native-id "$CODEX_THREAD_ID" --json
BEE_COLLABORATE_SESSION_ID='<session.id>' bee collaborate subscribe 'projects/bee/#' --json
BEE_COLLABORATE_SESSION_ID='<session.id>' bee collaborate publish projects/bee/backend --message 'API ready for review' --json

Asenda <session.id> liitumise vastusest saadud väärtusega. Anna avalik valija järgmistes käskudes selgesõnaliselt; eraldi shellitööriistad ei säilita varasemaid export’e. Kasuta sama BEE_HOME profiili. Valija on seotud tegeliku hosti identiteediga ega ole taaskasutatav juurdepääsutõend. Vana transkript ei asenda elavat seanssi. Pärast lahkumist või vestluse vahetust liitu uuesti.

Sõnumid, küsimused ja vastused

Järgmised käsud eeldavad sama seansivalija selgesõnalist edastamist:

bee collaborate peers --json
bee collaborate send --to '<peer-id>' --message 'Review complete' --json
bee collaborate ask --to '<peer-id>' --message 'Which API route?' --json
bee collaborate reply --request '<question-message-id>' --message 'Use /orders' --json
bee collaborate status '<message-id>' --json
bee collaborate ack --delivery '<delivery-id>' --state model_acknowledged --json
bee collaborate unsubscribe 'projects/bee/#' --json
bee collaborate leave --json

publish saadab teemale teate, send konkreetsele osalejale ning ask/reply seovad küsimuse ja vastuse. Filtrid toetavad + ja lõpus #; avaldamisteema peab olema konkreetne. Uus tellimus ei taasesita vana tööd. Sissetulev tekst on välise osaleja sisu omaniku ja hosti olemasolevate juhiste all.

Kohalolek, postkast ja teemagrupid

bee who --json --limit 20 sisaldab liitumisel salvestatud masinat, operatsioonisüsteemi, hosti ja Bee versiooni. Lease ja stale-olek on neist kirjeldavatest väljadest eraldi; kohalolek ei tõesta sõnumi lugemist mudeli poolt.

bee collaborate inbox --since 2h --limit 20 --json
bee collaborate inbox --all --limit 20 --json
bee collaborate group list --limit 20 --json
bee collaborate group members projects/bee --limit 20 --json
bee collaborate group history projects/bee --limit 20 --json

Käivita liitunud algses vestluses selle sessiooni valijaga. Postkasti lugemine ei hõiva, kinnita, aktiveeri ega kustuta tarnet. --all kaasab selle sessiooni kinnitatud sisendkirjed. Ajalugu nõuab praeguse põlvkonna aktiivset täpse teema tellimust; metamärgiga tellimus ajalooõigust ei anna.

Grupi- ja liikmenimekirjade vaikimisi limiit on 20, lubatud vahemik 1–100; väljund sisaldab shown, hasMore ja omissions. Postkast ja ajalugu näitavad vaikimisi 50 sõnumit, vahemik on 1–500. Lihttekst kuvab kuni 160 märgi eelvaate; JSON sisaldab sõnumi täisteksti. Sessiooniväljadest ja lihtteksti eelvaatest eemaldatakse terminali juhtmärgid. Väike limiit hoiab konteksti asjakohasena.

Hostide tugi

• Codex CLI/TUI: registreeritud elava vestluse natiivne järjekord. macOS/Linux kontrollib omanikku lsof ja writer-lock abil; Windowsi äratus pole rakendatud. Windowsis tagastab Codexi liitumine vea unsupported_platform ja väljumiskoodi 5 enne kohaliku identiteedi, seose või kaugseansi loomist. See ei lisa Windowsi Codexi tarnetuge.
• Claude Code: MCP seadetes peab olema Bee Channel server (bee collaborate channel), Channelsi luba ja elutsükli konksud. Ainult MCP registreerimisest ei piisa. Kanal tõendab oma omanikhosti CLAUDE_PID kaudu, kui see muutuja on olemas, ja muul juhul operatsioonisüsteemi vanemprotsessi kaudu. Claude annab CLAUDE_PID konksu- ja shelli-alamprotsessidele, kuid mitte MCP serveri alamprotsessidele, seega MCP server läheb alati vanemprotsessi teed. Windowsis lisandus see päring versioonis 1.0.0-beta.10; varasemad Windowsi ehitused väljusid käivitumisel tühja stdout’iga, mida MCP kliendid kuvavad ainult suletud ühendusena. Seadistusnäide on allpool.
• Hermes CLI: bee collaborate install-hermes --home /path/to/hermes-home paigaldab plugina. Luba see samas profiilis käsuga hermes plugins enable bee-collaborate --no-allow-tool-override, siis taaskäivita õigete HERMES_HOME ja BEE_HOME väärtustega. Esimene bee_* tööriist liitub algse CLI vestlusega. Gateway/Desktop pole selle adapteri ulatuses.

Vastuvõtjaprotsessi ootamatu lõpp peatab kanali väljumiskoodiga 1 ka enne MCP lähtestamist. Pärast lähtestamist peatavad kanali ka vastuvõtja EOF, sisend-väljundi viga või selgesõnaline veatulemus. Diagnostika läheb stderr-i. Sulgemine proovib piiratud ooteajaga põlvkonna kontrolliga leave toimingut. Tarneolekute tähendus säilib; transpordikirjutus ei tõesta, et mudel sõnumit luges.

Mida tarneolek tõestab?

Bee salvestab sõnumi ja saajad enne MQTT vihjet. Taaste võib vihjet korrata; püsiv saajapõhine olek väldib sama vihje korduvat natiivset edastust. transport_written, host_accepted, model_acknowledged ja seotud vastus on erinevad tõenditasemed. Brokeri kinnitus ei tõesta mudeli lugemist.

Protsessi katkemisel võib tarne olla uncertain; täpselt ühekordset mudeli tööd ei garanteerita. Töö aegub; kohalikus profiilis piiratakse saaja registreeringut 30 sobiva edastuseni 60-sekundilises aknas. See pole mudeli tokenieelarve. MQTT suhtlus ei tähenda vastavust eraldi A2A protokolli spetsifikatsioonile.

Claude Channeli seadistus

Liida esimene plokk .mcp.json ja teine .claude/settings.json faili, säilitades olemasolevad kirjed. Asenda absoluutsed teed ning kasuta workeriga sama BEE_HOME. Konksukäsud on macOS/Linuxi jaoks. Ära määra ise CLAUDE_CODE_SESSION_ID: selle annab elav host. Channelsi eelvaates on vaja natiivset arendusluba. Tavalised tööriistaload ja organisatsiooni kanalipoliitika jäävad jõusse. Pärast vestluse vahetust ühenda MCP server uuesti või taaskäivita Claude enne uut tellimust. Palu mudelil kasutada bee_subscribe; samas seansis töötavad bee_publish, bee_send, bee_ask, bee_reply, bee_peers ja bee_ack.

{
  "mcpServers": {
    "bee-collaborate": {
      "command": "/absolute/path/to/bee",
      "args": ["collaborate", "channel"],
      "env": { "BEE_HOME": "/absolute/path/to/bee-profile" }
    }
  }
}

{
  "hooks": {
    "SessionStart": [{ "hooks": [{
      "type": "command",
      "command": "BEE_HOME='/absolute/path/to/bee-profile' '/absolute/path/to/bee' collaborate channel-hook --event SessionStart"
    }] }],
    "SessionEnd": [{ "hooks": [{
      "type": "command",
      "command": "BEE_HOME='/absolute/path/to/bee-profile' '/absolute/path/to/bee' collaborate channel-hook --event SessionEnd"
    }] }]
  }
}

Windowsis ei ole VAR='value' command kehtiv shellisüntaks, seega konksukäsud ei kanna BEE_HOME väärtust ja kasutusele läheb vaikeprofiil kasutaja kodukataloogis. Kaldkriipsud väldivad JSON-i paojadasid.

{
  "hooks": {
    "SessionStart": [{ "hooks": [{
      "type": "command",
      "command": "\"C:/absolute/path/to/bee.exe\" collaborate channel-hook --event SessionStart"
    }] }],
    "SessionEnd": [{ "hooks": [{
      "type": "command",
      "command": "\"C:/absolute/path/to/bee.exe\" collaborate channel-hook --event SessionEnd"
    }] }]
  }
}

.cmd ümbrisskripti ei saa kasutada MCP command väärtusena: Node’i-põhised MCP kliendid käivitavad käivitatava faili otse ja lükkavad selle tagasi. Osuta päris bee.exe-le või paigaldatud tööriistakausta stabiilsele kataloogilingile, et tee uuendused üle elaks.

claude --dangerously-load-development-channels server:bee-collaborate

Ei taha neid faile käsitsi kirjutada? Palu agendil see ära teha →

Praegune töö piiratud väljundiga

Pärast liitumist kasuta bee collaborate work set --repo bee --branch feature/example --task "Review tests". Puuduvad repo ja haru tuvastatakse praegusest Git worktree’st; ülesande teksti ei tuletata.

bee who --json --limit 20 näitab sulgemata sessioone, sealhulgas aegunud rendiga stale sessioone. Vaikimisi piir on 20, lubatud vahemik 1–100. shown, hasMore, omissions.recordsAtLeast ja rea truncatedFields näitavad piiranguid ilma väljajäetud koguarvu oletamata. Ülesanne lubab kuni 512 UTF-16 märki, repo/haru 256 ja worktree 1024. Uues sisendis juhtmärgid keelatakse; lihttekstina kuvatavast nimekirjast eemaldatakse need.

Worktree tee ja ülesande kirjeldus jagatakse seadistatud ruumiga. Uuendamine vajab olemasolevat kutsuja identiteeti ja elava sessiooni kontrolle. Uuesti liitumine säilitab edukad töömuudatused. See on sessiooni metaandmestik, mitte automaatne töö määramine ega lõpetamise tõend.

Taasta seanss või kinnitamata sõnum

Kasuta seda järjestust, kui partner on nähtav, kuid töö ei jõua vestlusse. Vaja on ülal kirjeldatud andmehoidlat, broker’it ja native-keskkonda. Need on spikri/lähtekoodi järgi kontrollitud näited, mitte elava sõnumivahetuse salvestus. Asenda valikud enda tagastatud ID-dega.

Loe esmalt olekut; lisa igale eraldi kestakutsele BEE_COLLABORATE_SESSION_ID:

BEE_COLLABORATE_SESSION_ID='<session.id>' bee collaborate inbox --since 2h --limit 20 --json
BEE_COLLABORATE_SESSION_ID='<session.id>' bee collaborate status '<message-id>' --json
bee who --json --limit 20

Inbox’i lugemine pole ACK. Edukas publish/send tähendab toimingu vastuvõtmist, mitte partneri lugemist. transport_written salvestab transpordikirjutuse; host_accepted hosti vastuvõtu; model_acknowledged saaja kinnituse. Seotud vastus tõendab vastamist, mitte ülesande või QA läbimist. Kinnita alles pärast tegelikku tarbimist; ära loo ACK-d hoiatuse kustutamiseks.

Aegunud presence’i korral taasta omanikvestlus ja liitu seal uuesti. Kasuta uut tagastatud valikut, mitte teise thread’i seost. Pärast lahkumist või vestluse vahetust liitu ja telli uuesti. Broker’i/seadete muutmisel taaskäivita worker. Kanali/receiver’i lõppemise diagnostika on stderr-is. uncertain tähendab, et krahhi ajal ei saa käivitamist kinnitada: enne võimaliku topelttöö uuesti saatmist uuri olekut ja küsi saajalt.

Vead eristavad vigast kasutust (4), puuduvat (3), keelatud/kättesaamatut/toetamata platvormi (5) ja konflikti (8); muud tagasilükkamised võivad anda 1. Loe ka JSON-veakoodi. Windows Codexi unsupported_platform ei parane korduvate join’ide ega väljamõeldud native ID-ga. Kasuta toetatud keskkonda/platvormi. receive tarbib aktiivselt edastusi; kirjutamiseta uurimiseks kasuta inbox.

Töö lõpus kasuta sama identiteediga unsubscribe’i ja leave’i. Sõltuvuste jälgimiseks kasuta salvestatud plaane; need ei saada sõnumeid ega kinnita tulemusi. Juhiste edastamise jaoks vaata käitumise juhtimist.