Webhooki, SCIM i parowanie

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

Ta strona obejmuje pozostałe powierzchnie protokołu: parowanie urządzeń, przedsiębiorstwo federacja uwierzytelniania (SAML / SCIM / OAuth), opcja włączenia Serwer MCP i A2A punkty końcowe, media transfer i Połącz-RPC usługi. Kilka z nich jest wyłączonych domyślnie i musi być włączonych ręcznie.

Parowanie urządzeń

Klienci mobilni i stacjonarni dołączają do instancji za pomocą krótkiej wymiany parowania (aplikacja iOS/macOS używa tylko parowania za pomocą kodu QR).

Metoda i ścieżka	Cel
`POST /v1/pairing/redeem`	Zrealizuj kod parowania i skonfiguruj urządzenie
`POST /v1/pairing/device/validate`	Zweryfikuj już sparzone urządzenie

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

Federacja uwierzytelniania

AiHummer integruje się z dostawcami tożsamości przedsiębiorstw zarówno w celu logowania, jak i udostępniania użytkowników.

SAML

Metoda i ścieżka	Cel
`GET /saml/metadata`	Metadane dostawcy usług dla Twojego IdP
`POST /saml/acs`	Usługa odbioru twierdzeń (odpowiedź SAML)
`GET /saml/login`	Rozpocznij logowanie SAML

Provisioning SCIM

System do zarządzania tożsamością międzydomenową (SCIM 2.0) pozwala Twojemu IdP automatycznie tworzyć i zarządzać użytkownikami.

Metoda i ścieżka	Cel
`.../scim/v2/Users`	Lista / utwórz użytkowników
`.../scim/v2/Users/{id}`	Odczytaj / zaktualizuj / usuń użytkownika

Punkty końcowe SCIM uwierzytelniają się za pomocą token dostępu SCIM dla każdego najemcy, wydany (i odnowiony/odwołany) w POST /v1/admin/scim/token; IdP wysyła to w Authorization: Bearer nagłówek. Token jest wyświetlany raz w momencie wydania.

token OAuth

Metoda i ścieżka	Cel
`POST /v1/oauth/token`	punkt końcowy tokena OAuth

Serwer MCP (publikuj na zewnątrz)

AiHummer może publikować własne narzędzia dla klientów MCP, działając jako Serwer MCP. To jest dobrowolny udział i wyłączone, chyba że ustawisz AIHUMMER_MCP_PUBLISH=1.

Metoda i ścieżka	Cel
`POST /v1/mcp`	Punkt końcowy serwera MCP (wymaga `AIHUMMER_MCP_PUBLISH=1`)

[!WARNING] Samo AIHUMMER_MCP_PUBLISH=1 nie wystarczy. Otwiera adres, ale lista eksportu jest pusta: tools/list zwraca pustą tablicę, a każde wywołanie jest odrzucane. Wypisz potrzebne narzędzia dokładnymi nazwami, po przecinku, w AIHUMMER_MCP_EXPORT_TOOLS — wzorce ani * nie są obsługiwane. Na zewnątrz można wystawiać wyłącznie narzędzia odczytu: http_request, web_fetch, browser, code_exec i filesystem_read nigdy nie są eksportowane, nawet jeśli je wymienisz.

Oba ustawienia zmienia się w Zarządzanie → Ustawienia lub poleceniem aihummer settings set, a nie w gateway.env — dla tych kluczy środowisko jest ignorowane. AIHUMMER_MCP_PUBLISH przyjmuje dokładnie 1: true czy on pozostawią adres zamknięty. Zmiany działają po restarcie bramy.

Klient musi przesłać klucz API z zakresem mcp w nagłówku Authorization: Bearer …; bez niego odpowiedzią jest 401.

[!NOTE] Udostępnianie narzędzi na zewnątrz różni się od konsumpcji serwera MCP jako integracja bez kodu. Ten punkt końcowy służy do umożliwienia innym klientom MCP wywoływania AiHummer.

A2A (Agent-do-Agenta)

AiHummer może udostępnić powierzchnię A2A, aby inni agenci mogli ją odkryć i wysyłać do niej wiadomości. To również dobrowolny udział przez AIHUMMER_A2A_PUBLISH=1.

Metoda i ścieżka	Cel
`GET /.well-known/agent.json`	Karta agenta A2A / dokument odkrywczy
`POST /a2a/message`	Otrzymaj wiadomość A2A (wymaga `AIHUMMER_A2A_PUBLISH=1`)

Media

Duże media (audio, obrazy, pliki) są przesyłane i pobierane za pośrednictwem dedykowanych punktów końcowych, a nie osadzane w ciałach JSON.

Metoda i ścieżka	Cel
`PUT /v1/media/{id}/content`	Prześlij bajty obiektu multimedialnego
`GET /v1/files/{id}`	Pobierz zapisany plik

[!TIP] Zestaw AIHUMMER_BLOB_DIR aby włączyć usługę mediów/plików, oraz AIHUMMER_MEDIA_TOKEN_SECRET więc podpisane adresy URL pobierania pozostają ważne w całym uruchamia ponownie.

Połącz usługi RPC

Dla klienta pisemnego i przesyłającego strumieniowo AiHummer udostępnia również Połącz-RPC usługi przez HTTP (wspierane jest strumieniowanie z serwera):

Usługa	Obszar
`aihummer.health.v1`	Kontrole zdrowotne
`aihummer.event.v1`	Strumień zdarzeń
`aihummer.conversation.v1`	Rozmowy
`aihummer.push.v1`	Dostawa push
`aihummer.media.v1`	Transfer mediów
`aihummer.turn.v1`	Wykonanie tury

Dokąd dalej

Wypchaj wiadomości do AiHummera: Wyzwalacze przychodzące i integracyjne.
Przełącz te powierzchnie i nie tylko: Zmienne środowiskowe.
Obsługuj instancję: Odwołanie CLI.