Tinklo kabliukai, SCIM ir poravimas

v1.0.x · atnaujinta 2026-07-05

Šiame puslapyje aptariamos likusios protokolo sąsajos: įrenginio poravimas, įmonė autentifikacijos federacija (SAML / SCIM / OAuth), dalyvavimas pagal pasirinkimą MCP serveris ir A2A galo taškai, žiniasklaida perkelti, ir Prisijungti-RPC paslaugos. Kelios iš jų pagal nutylėjimą yra išjungtos ir turi būti įjungtos aiškiai.

Įrenginio poravimas

Mobilieji ir stalinių kompiuterių klientai prisijungia prie instancijos per trumpą susiejimo mainų procesą (iOS/macOS programėlė naudoja tik QR susiejimą).

Metodas ir kelias	Tikslas
`POST /v1/pairing/redeem`	Įveskite susiejimo kodą ir paruoškite įrenginį
`POST /v1/pairing/device/validate`	Patvirtinti jau sujungtą įrenginį

curl https://your-aihummer.example/v1/pairing/redeem \
  -H "Content-Type: application/json" \
  -d '{ "code": "ABCD-EFGH" }'

Autentifikacijos federacija

AiHummer yra integruojamas su įmonių tapatybės tiekėjais tiek prisijungimui, tiek vartotojų tiekimui.

SAML

Metodas ir kelias	Tikslas
`GET /saml/metadata`	Paslaugų teikėjo metaduomenys jūsų IdP
`POST /saml/acs`	Tvirtinimo vartotojo paslauga (SAML atsakymas)
`GET /saml/login`	Paleisti SAML prisijungimą

SCIM tiekimas

Kryžminių domenų tapatybės valdymo sistema (SCIM 2.0) leidžia jūsų IdP automatiškai kurti ir valdyti vartotojus.

Metodas ir kelias	Tikslas
`.../scim/v2/Users`	Sąrašas / sukurti vartotojus
`.../scim/v2/Users/{id}`	Skaityti / atnaujinti / ištrinti naudotoją

SCIM galutiniai taškai autentifikuojasi su SCIM nešėjo žetonas kiekvienam nuomininkui, išduota (ir pasukta/atšaukta) POST /v1/admin/scim/token; IdP siunčia jį į Authorization: Bearer antraštė. Žetonas rodomas tik išleidimo metu.

OAuth žetonas

Metodas ir kelias	Tikslas
`POST /v1/oauth/token`	OAuth žetono galinis taškas

MCP serveris (publikuoti į išorę)

AiHummer gali skelbti savo įrankius MCP klientams veikdamas kaip MCP serveris. Tai yra prisijungti ir išjungta, nebent nustatytumėte AIHUMMER_MCP_PUBLISH=1.

Metodas ir kelias	Tikslas
`POST /v1/mcp`	MCP serverio galinis taškas (reikalauja `AIHUMMER_MCP_PUBLISH=1`)

[!WARNING] Vien AIHUMMER_MCP_PUBLISH=1 nepakanka. Jis atveria adresą, bet eksporto sąrašas tuščias: tools/list grąžina tuščią masyvą, o kiekvienas iškvietimas atmetamas. Išvardykite reikiamus įrankius tiksliais pavadinimais, atskirtais kableliais, nuostatoje AIHUMMER_MCP_EXPORT_TOOLS — šablonai ir * nepalaikomi. Į išorę galima teikti tik skaitymo įrankius: http_request, web_fetch, browser, code_exec ir filesystem_read niekada neeksportuojami, net jei juos nurodysite.

Abi nuostatos nustatomos Valdymas → Nuostatos arba komanda aihummer settings set, o ne faile gateway.env — šiems raktams aplinka ignoruojama. AIHUMMER_MCP_PUBLISH priima tiksliai 1: true ar on paliks adresą uždarą. Pakeitimai įsigalioja iš naujo paleidus šliuzą.

Klientas privalo antraštėje Authorization: Bearer … atsiųsti API raktą su mcp sritimi; be jo atsakymas yra 401.

[!NOTE] Išoriniai leidybos įrankiai skiriasi nuo MCP serverio naudojimo kaip nulinio kodo integracija. Šis galinis taškas skirtas leisti kitiems MCP klientams kviesti į AiHummer.

A2A (Agentas-agentui)

AiHummer gali atskleisti A2A paviršių, kad kiti agentai galėtų jį atrasti ir siųsti žinutes. Tai taip pat prisijungti per AIHUMMER_A2A_PUBLISH=1.

Metodas ir kelias	Tikslas
`GET /.well-known/agent.json`	A2A agento kortelė / atradimo dokumentas
`POST /a2a/message`	Gauti A2A žinutę (reikalauja `AIHUMMER_A2A_PUBLISH=1`)

Medija

Didelė žiniasklaida (garso įrašai, vaizdai, failai) įkeliama ir gaunama per specialius galinius taškus, o ne įterpiama į JSON kūnus.

Metodas ir kelias	Tikslas
`PUT /v1/media/{id}/content`	Įkelkite baitus medijos objektui
`GET /v1/files/{id}`	Atsisiųsti saugomą failą

[!TIP] Rinkinys AIHUMMER_BLOB_DIR įgalinti žiniasklaidos/duomenų failų paslaugą, ir AIHUMMER_MEDIA_TOKEN_SECRET taigi pasirašytos atsisiuntimo URL nuorodos lieka galiojančios visame paleidžia iš naujo.

Connect-RPC paslaugos

Tišktiems, srautiniams klientams AiHummer taip pat atskleidžia Prisijungti-RPC paslaugos per HTTP (palaikomas serverio transliavimas):

Paslauga	Plotas
`aihummer.health.v1`	Sveikatos patikrinimai
`aihummer.event.v1`	Įvykių srautas
`aihummer.conversation.v1`	Pokalbiai
`aihummer.push.v1`	Stumti pristatymą
`aihummer.media.v1`	Medijos perdavimas
`aihummer.turn.v1`	Ėjimo vykdymas

Kur toliau

Siųsti pranešimus į AiHummer: Įeinantys ir integracijos sukeliamieji veiksniai.
Perjunkite šiuos paviršius ir dar daugiau: Aplinkos kintamieji.
Valdykite egzempliorių: CLI nuoroda.