Tīmekļa āķi, SCIM un savienošana

v1.1.x · atjaunināts 2026-07-05

Šī lapa aptver pārējās protokola virsmas: ierīču pārošana, uzņēmums autentifikācijas federācija (SAML / SCIM / OAuth), izvēle pieslēgties MCP serveris un A2A galapunkti, mediji pārvietot, un Savienot-RPC pakalpojumi. Daži no tiem pēc noklusējuma ir izslēgti un tos jāieslēdz īpaši.

Ierīču savienošana

Mobilie un galddatoru klienti pievienojas instancē, izmantojot īsu savienošanās apmaiņu (iOS/macOS lietotne izmanto tikai QR savienošanu).

Metode un ceļš	Mērķis
`POST /v1/pairing/redeem`	Ievadiet pārašanas kodu un sagatavojiet ierīci
`POST /v1/pairing/device/validate`	Pārbaudīt jau savienotu ierīci

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

Autentifikācijas federācija

AiHummer integrējas ar uzņēmuma identitātes nodrošinātājiem gan pieteikšanās, gan lietotāju nodrošināšanas vajadzībām.

SAML

Metode un ceļš	Mērķis
`GET /saml/metadata`	Pakalpojumu sniedzēja metadati jūsu IdP
`POST /saml/acs`	Apgalvojuma patērētāja pakalpojums (SAML atbilde)
`GET /saml/login`	Sākt SAML pieteikšanos

SCIM nodrošināšana

Sistēma lietotāju identitātes pārvaldībai dažādās jomās (SCIM 2.0) ļauj jūsu IdP automātiski izveidot un pārvaldīt lietotājus.

Metode un ceļš	Mērķis
`.../scim/v2/Users`	Saraksts / izveidot lietotājus
`.../scim/v2/Users/{id}`	Lasīt / atjaunināt / dzēst lietotāju

SCIM galapunkti autentificējas ar SCIM nēsātāja marķieris katram īrniekam, izsniegts (un pagriezts/atsaukts) pie POST /v1/admin/scim/token; IdP to to nosūta Authorization: Bearer galvene. Žetons tiek parādīts tikai izsniegšanas brīdī.

OAuth žetons

Metode un ceļš	Mērķis
`POST /v1/oauth/token`	OAuth žetona galapunkts

MCP serveris (publicēt uz āru)

AiHummer var publicēt savus rīkus MCP klientiem, rīkojoties kā MCP serveris. Tas ir piedalīties un atspējots, ja vien neiestatīsit AIHUMMER_MCP_PUBLISH=1.

Metode un ceļš	Mērķis
`POST /v1/mcp`	MCP servera galapunkts (prasa `AIHUMMER_MCP_PUBLISH=1`)

[!WARNING] Ar vienu AIHUMMER_MCP_PUBLISH=1 nepietiek. Tas atver adresi, bet eksporta saraksts ir tukšs: tools/list atgriež tukšu masīvu un jebkurš izsaukums tiek noraidīts. Uzskaitiet vajadzīgos rīkus ar precīziem nosaukumiem, atdalot ar komatu, iestatījumā AIHUMMER_MCP_EXPORT_TOOLS — šabloni un * netiek atbalstīti. Uz āru drīkst publicēt tikai lasīšanas rīkus: http_request, web_fetch, browser, code_exec un filesystem_read netiek eksportēti nekad, pat ja tos nosauksiet.

Abus iestatījumus norāda sadaļā Pārvaldība → Iestatījumi vai ar komandu aihummer settings set, nevis failā gateway.env — šīm atslēgām vide tiek ignorēta. AIHUMMER_MCP_PUBLISH pieņem tieši 1: true vai on atstās adresi slēgtu. Izmaiņas stājas spēkā pēc vārtejas pārstartēšanas.

Klientam galvenē Authorization: Bearer … jāatsūta API atslēga ar mcp tvērumu; bez tās atbilde ir 401.

[!NOTE] Publicēšanas rīki ārēji atšķiras no MCP servera patēriņa kā nulles koda integrācija. Šis galapunkts ir paredzēts, lai ļautu citiem MCP klientiem izsaukt AiHummer.

A2A (Aģenta uz Aģentu)

AiHummer var atklāt A2A virsmu, lai citi aģenti to varētu atklāt un nosūtīt ziņojumu. Tas arī piedalīties caur AIHUMMER_A2A_PUBLISH=1.

Metode un ceļš	Mērķis
`GET /.well-known/agent.json`	A2A aģenta karte / atklāšanas dokuments
`POST /a2a/message`	Saņemt A2A ziņu (prasa `AIHUMMER_A2A_PUBLISH=1`)

Mediji

Lielie multivides faili (audio, attēli, faili) tiek augšupielādēti un iegūti caur speciālām galapunktiem, nevis iegulti JSON struktūrās.

Metode un ceļš	Mērķis
`PUT /v1/media/{id}/content`	Augšupielādējiet baitus multivides objektam
`GET /v1/files/{id}`	Lejupielādēt saglabāto failu

[!TIP] Komplekts AIHUMMER_BLOB_DIR lai iespējotu multivides/failu pakalpojumu, un AIHUMMER_MEDIA_TOKEN_SECRET tātad parakstītie lejupielādes URL paliek derīgi pāri pārstartējas.

Savienot RPC pakalpojumus

Tīpētiem, straumējošiem klientiem AiHummer arī atklāj Savienot-RPC pakalpojumi pār HTTP (atbalstīta servera plūsma):

Pakalpojums	Laukums
`aihummer.health.v1`	Veselības pārbaudes
`aihummer.event.v1`	Notikumu plūsma
`aihummer.conversation.v1`	Sarunas
`aihummer.push.v1`	Push piegāde
`aihummer.media.v1`	Mediju pārsūtīšana
`aihummer.turn.v1`	Izpildes kārta

Kur uz nākamo

Iesniegt ziņojumus AiHummer: Ienākošie un integrācijas aktivatori.
Pārslēgt šos virsmas un vairāk: Vides mainīgie.
Palaidiet instanci: CLI atsauce.