ვებჰუკები, 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 სერვერი. ეს abonementi სურვილისამებრ და გათიშულია, თუ არ დააყენებთ 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 მისამართს დახურულს დატოვებს. ცვლილებები ძალაში შედის კარიბჭის გადატვირთვის შემდეგ.

კლიენტმა უნდა გამოაგზავნოს API-გასაღები mcp არეალით სათაურში Authorization: Bearer …; მის გარეშე პასუხია 401.

[!NOTE] ინსტრუმენტების საჯაროდ გამოქვეყნება განსხვავდება MCP სერვერის გამოიყენებისგან ასევე კოდის გარეშე ინტეგრირება. ეს ტერმინი განკუთვნილია იმისთვის, რომ სხვა MCP კლიენტები შეძლონ მისი გამოძახება აიჰამერი.

A2A (ეიჯენტი ეიჯენტისთვის)

AiHummer შეუძლია გააღოს A2A-მხრივი ზედაპირი, რათა სხვა აგენტები მისი გამოვლენა და შეტყობინებების გაგზავნა შეძლონ. ეს ასევე abonementi სურვილისამებრ მეშვეობით 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] კომplekტი AIHUMMER_BLOB_DIR მედია/ფაილთა სერვისის ჩართვისთვის, და AIHUMMER_MEDIA_TOKEN_SECRET ამრიგად, ჩამოტვირთვისთვის ხელმოწერილი URL-ები კვლავ მოქმედია გაათიშვა და კვლავ ჩართვა.

RPC სერვისების ჩართვა

აიჰამერი ასევე უზრუნველყოფს ტიპიზირებული სტრიმინგ კლიენტებისთვის რთვის-მონაცემთა RPC სერვისები HTTP-ის საშუალებით (მხარდაჭერილია სერვერული ნაკადის გადაცემა):

სერვისი	პლოშადი
`aihummer.health.v1`	მედიცინური შემოწმებები
`aihummer.event.v1`	ობიექტების ნაკადი
`aihummer.conversation.v1`	საუბრები
`aihummer.push.v1`	პუშ-მიწოდება
`aihummer.media.v1`	მედიატრანსფერი
`aihummer.turn.v1`	გაბრუნების შესრულება

სად შემდეგ?

გაგზავნეთ შეტყობინებები AiHummer-ში: მიმდინარე ტრიგერები და ინტეგრაციის ტრიგერები.
გაამრთელეთ ეს ზედაპირები და სხვა: გარემოს ცვლადები.
მართეთ ეგზემპლარი: CLI-ის სახელმძღვანელო.