AiHummer
Română▾
Autentificare
v1.0.x▾
v1.0.xstable
{ }Swagger
Marketplace și pluginuri/Prezentare generală și niveluri ale marketplace-ului

Prezentare generală și niveluri ale marketplace-ului

v1.0.x · actualizat 2026-06-26

Marketplace-ul de plugin-uri este modul în care AiHummer crește dincolo de runtime-ul său încorporat. Catalogul său se sincronizează dintr-un CDN, instalările se fac cu un singur clic din interfața de administrare, iar fiecare plugin rulează nativ pe gazdă — nu există Docker nicăieri în acest model. Plugin-urile vin în trei niveluri care diferă prin modul în care se execută și prin ceea ce pot face.

Cele trei niveluri pe scurt

Nivel Ce este Cum rulează Acreditări
Nivel 1 Servicii native pe gazdă autonome (canale, voce) Propria unitate systemd izolată + port Partajate (spațiu de lucru)
Nivel 2 Instrumente/competențe în proces În interiorul procesului gateway Personale sau partajate
Nivel 3 Tipuri de sursă fără cod (OpenAPI, MCP) Sintetizate de gateway, fără cod Personale (OAuth per utilizator) sau partajate

Nivelul 1 — servicii native pe gazdă autonome

Plugin-urile de nivel 1 sunt servicii complete în sine: conectori de canal și componente vocale precum plugin-urile SIP, Bitrix24, Einstein și iOS-proxy. Fiecare este implementat ca propria unitate systemd izolată care ascultă pe propriul port, iar gateway-ul comunică cu acesta prin HTTP. Acesta este principiul „nativ pe gazdă, nu Docker” în acțiune — un plugin este un serviciu de sistem gestionat, nu un container.

Conectori de canal disponibili acum: Telegram, MAX (un nou messenger rusesc, canalul max) și Bitrix24 (un canal IM intern pentru angajați, nu omnicanal pentru clienți). În previzualizare și pe foaia de parcurs: Discord, Slack, Teams, Matrix, Signal, Email și WhatsApp.

[!NOTE] Plugin-urile de nivel 1 nu sunt incluse în binarul gateway. Sunt instalate și supravegheate ca servicii systemd separate și accesate prin URL, motiv pentru care fiecare are propriul port.

Nivelul 2 — instrumente/competențe în proces

Plugin-urile de nivel 2 sunt instrumente/competențe compilate în gateway și rulate în interiorul procesului acestuia. Deoarece se execută în proces în numele utilizatorului care acționează, pot folosi acreditări personale sau partajate: modul personal atribuie o acțiune unei anumite persoane (acreditarea sa și atribuirea turei), modul partajat folosește o singură acreditare la nivel de spațiu de lucru.

[!NOTE] Integrările personale către conturi externe (Google, Microsoft, Todoist, Asana, Jira, ClickUp, GitLab, Spotify, Fitbit, Oura, SmartThings și altele) sunt livrate ca Nivel 3 fără cod — integrări OAuth per utilizator pe care fiecare utilizator le conectează la propriul cont.

Nivelul 3 — tipuri de sursă fără cod

Plugin-urile de nivel 3 nu necesită niciun cod de integrare. Există două tipuri de sursă:

  • OpenAPI — indică orice specificație OpenAPI 3.x, iar AiHummer sintetizează câte un instrument per operație.
  • MCP — conectează orice server MCP prin stdio sau HTTP și expune tools/list.

Ambele transformă un serviciu existent în instrumente pentru agent fără ca tu să scrii sau să implementezi cod.

Prin mecanismul OpenAPI cu OAuth per utilizator, un set mare de integrări personale este deja disponibil — fiecare utilizator le conectează la propriul cont: Gmail, Google Calendar, Google Contacts, Google Tasks, Google Drive, YouTube, Outlook Mail, Outlook Calendar, OneDrive, Microsoft To Do, Todoist, Asana, Jira Cloud, ClickUp, GitLab, Fitbit, Oura Ring, Spotify, Samsung SmartThings și altele. Consultă Integrări fără cod pentru parcurgerea completă.

Catalogul și CDN-ul

Catalogul marketplace-ului se sincronizează dintr-un CDN, astfel încât lista de plugin-uri instalabile este menținută la zi fără împachetare manuală din partea ta. Din interfața de administrare răsfoiești catalogul, instalezi cu un singur clic și lași fiecare instalare să se actualizeze automat pe propriul program.

Oficial și comunitate

Catalogul este împărțit în două registre care nu se amestecă:

  • Oficial (propriu) — module de la AiHummer. Sursa este fixată și de încredere în mod implicit (verificată față de cheia de registru fixată); în Web UI aceste plugin-uri poartă o insignă Official și se clasează primele.
  • Comunitate (terț) — plugin-uri de la dezvoltatori externi publicate prin registrul public. Este adăugat ca o sursă separată (community-catalog.json) care nu suprascrie catalogul oficial; în liste aceste plugin-uri apar fără insignă și se sortează după numărul de descărcări.

Ambele registre folosesc același contract de manifest și aceeași cale de instalare; diferă prin origine și ancoră de încredere (consultă Instalare și actualizări).

Unde mergi mai departe