Вебхуктар, SCIM және жұптау

v1.1.x · жаңартылды 2026-07-05

Бұл бетте қалған протокол беттері қарастырылады: құрылғыны жұптастыру, кәсіпорын аутентификация федерациясы (SAML / SCIM / OAuth), қосылу опциясы MCP сервері және A2A соңғы нүктелер, медиа аудару және Қосылу-RPC қызметтер. Олардың бірнешеуі әдепкі бойынша өшірілген және оларды нақты түрде қосу қажет.

Құрылғыны жұптастыру

Мобильді және десктоптық клиенттер қысқа жұптасу айырбастау арқылы инстанцияға қосылады (iOS/macOS қосымшасы тек QR арқылы жұптауды пайдаланады).

Әдіс және жол	Мақсат
`POST /v1/pairing/redeem`	Тиісті кодты пайдаланып, құрылғыны баптау
`POST /v1/pairing/device/validate`	Алдын ала жұптастырылған құрылғыны тексеру

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

Аутентификация федерациясы

AiHummer тіркелу және пайдаланушыны қамтамасыз ету үшін корпоративтік жеке бас провайдерлерімен біріктіріледі.

SAML

Әдіс және жол	Мақсат
`GET /saml/metadata`	Сіздің IdP үшін қызмет көрсетушінің метадеректері
`POST /saml/acs`	Сенімдемені қабылдау қызметі (SAML жауабы)
`GET /saml/login`	SAML арқылы кірісті бастау

SCIM қамтамасыз ету

Өзара домендік жеке басын басқару жүйесі (SCIM 2.0) сіздің IdP пайдаланушыларды автоматты түрде жасауға және басқаруға мүмкіндік береді.

Әдіс және жол	Мақсат
`.../scim/v2/Users`	Пайдаланушыларды тізімдеу / құру
`.../scim/v2/Users/{id}`	Пайдаланушыны оқу / жаңарту / жою

SCIM ұштастырғыштары аутентификацияланады пайдаланушыға арналған SCIM тасымалдаушы токені, шығарылған (және айналдырылған/кері қайтарылған) кезінде POST /v1/admin/scim/token; IdP оны ішінде жібереді Authorization: Bearer тақырып. Токен шығарылған кезде бір рет көрсетіледі.

OAuth белгісі

Әдіс және жол	Мақсат
`POST /v1/oauth/token`	OAuth токеннің соңы нүктесі

MCP сервері (сыртқа жариялау)

AiHummer өз құралдарын MCP клиенттеріне жариялай алады, әрекет етіп MCP сервері. Бұл қатысу және орнатпағанша өшірілген AIHUMMER_MCP_PUBLISH=1.

Әдіс және жол	Мақсат
`POST /v1/mcp`	MCP серверінің соңғы нүктесі (қажет) `AIHUMMER_MCP_PUBLISH=1`)

[!WARNING] Жалғыз AIHUMMER_MCP_PUBLISH=1 жеткіліксіз. Ол мекенжайды ашады, бірақ экспорт тізімі бос: tools/list бос массив қайтарады, ал кез келген шақыру қабылданбайды. Қажет құралдарды AIHUMMER_MCP_EXPORT_TOOLS ішінде нақты атауларымен, үтір арқылы тізіңіз — үлгілер мен * қолдау таппайды. Сыртқа тек оқу құралдарын беруге болады: http_request, web_fetch, browser, code_exec және filesystem_read тізсеңіз де ешқашан экспортталмайды.

Екі параметр де Басқару → Параметрлер бөлімінде немесе aihummer settings set командасымен беріледі, gateway.env файлында емес — бұл кілттер үшін орта еленбейді. AIHUMMER_MCP_PUBLISH тек 1 мәнін қабылдайды: true немесе on мекенжайды жабық қалдырады. Өзгерістер шлюз қайта іске қосылғаннан кейін күшіне енеді.

Клиент Authorization: Bearer … тақырыбында mcp аясы бар API кілтін жіберуі тиіс; онсыз жауап — 401.

[!NOTE] Баспа құралдарын сыртқа шығару MCP серверін пайдалану сияқты емес нөлдік код интеграциясы. Бұл соңғы нүкте басқа MCP клиенттеріне шақыру жасауға арналған АйХаммер.

A2A (Агенттен агентке)

AiHummer A2A бетін аша алады, сондықтан басқа агенттер оны таба алады және хабарлама жібере алады. Бұл сондай-ақ қатысу арқылы AIHUMMER_A2A_PUBLISH=1.

Әдіс және жол	Мақсат
`GET /.well-known/agent.json`	A2A агенттік картасы / ашу құжаты
`POST /a2a/message`	A2A хабарламасын қабылдаңыз (қажет етеді `AIHUMMER_A2A_PUBLISH=1`)

Медиа

Үлкен медиа (дауыс, суреттер, файлдар) JSON денелеріне енгізілместен, арнайы ұшыртқыштар арқылы жүктеледі және алынады.

Әдіс және жол	Мақсат
`PUT /v1/media/{id}/content`	Медиа объект үшін байттарды жүктеңіз
`GET /v1/files/{id}`	Сақталған файлды жүктеу

[!TIP] Кез келген AIHUMMER_BLOB_DIR медиа/файл қызметін қосу үшін, және AIHUMMER_MEDIA_TOKEN_SECRET осылайша қол қойылған жүктеу URL мекенжайлары барлық жерде жарамды болып қалады қайта іске қосылады.

Connect-RPC қызметтері

Терілетін, ағындық клиенттер үшін AiHummer сонымен қатар ашады Қосылу-RPC HTTP арқылы қызметтер (сервер ағыны қолдаулы):

Қызмет	Аумағы
`aihummer.health.v1`	Денсаулық тексерулері
`aihummer.event.v1`	Оқиғалар ағыны
`aihummer.conversation.v1`	Сөйлесулер
`aihummer.push.v1`	Итерме жеткізу
`aihummer.media.v1`	Медиа тасымалдау
`aihummer.turn.v1`	Кезекті орындау

Келесі қайда

AiHummer-ге хабарларды итеру: Кіріс және интеграция триггерлері.
Осы беттерді және басқаларын ауыстырыңыз: Қоршаған орта айнымалылары.
Инстанцияны іске қосыңыз: CLI сілтемесі.