Վեբհուքեր, SCIM և համակցում

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

Այս էջը ընդգրկում է արձանագրության մնացած մակերեսները: **համակցում սարքերի**, ձեռնարկություն **ավտենտիկացման ֆեդերացիա** (SAML / SCIM / OAuth), միացում ըստ ցանկության **MCP սերվեր** և **A2A** վերջնական կետեր, **մեդիա** հաղորդում, և **Միացնել-RPC** ծառայություններ. Դրանցից որոշներն անջատված են կանխավ, և պետք է ակնհայտորեն միացնել: ## Գործիքի միացում Մոբայլ և դեսկթոփ հաճախորդները միանում են օրինակին ինքայական կարգաբերման կարճ փոխանակման միջոցով (iOS/macOS հավելվածը օգտագործում է միայն QR միջոցով կարգավորում): | Մեթոդը և ուղին | Նպատակ | |---|---| | `POST /v1/pairing/redeem` | ակտիվացրեք զուգակցման կոդը և կարգավորեք սարքը | | `POST /v1/pairing/device/validate` | Ստուգել արդեն զուգակցված սարքը | ```bash 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-ները ներբեռնելու համար մնում են վավեր > վերաբեռնման. ## Միացնել RPC ծառայությունները AiHummer-ը նաև տրամադրում է զանգվածված հոսքային հաճախորդների համար **Միացնել-RPC** համակարգը HTTP-ով (առաջարկվում է սերվերի հոսքային փոխանցում): | Սերվիս | Տարածք | |---|---| | `aihummer.health.v1` | Բժշկական զննումներ | | `aihummer.event.v1` | Պատահարների հոսք | | `aihummer.conversation.v1` | Խոսակցություններ | | `aihummer.push.v1` | Push-նամակատարում | | `aihummer.media.v1` | Մեդիայի փոխանցում | | `aihummer.turn.v1` | Շրջադարձ կատարում | ## Որտեղից հետո - Ուղարկեք հաղորդագրություններ AiHummer-ին: [Մուտքային գործարկիչներ և ինտեգրման գործարկիչներ](/hy/v1.0/api/inbound-triggers). - Փոխանցեք այս մակերեսները և մյուսները՝ [Շրջակա միջավայրի փոփոխականներ](/hy/v1.0/reference/env-vars). - Կառավարեք նմուշը՝ [CLI-ի ուղեցույց](/hy/v1.0/reference/cli).