Marketplace-ի ակնարկ և մակարդակներ

**Փլագինների marketplace**-ն այն եղանակն է, որով AiHummer-ն աճում է իր ներկառուցված runtime-ից դուրս։ Նրա կատալոգը համաժամացվում է CDN-ից, տեղադրումները ադմին UI-ից մեկ սեղմում են, և յուրաքանչյուր փլագին աշխատում է **host-native** — մոդելում որևէ տեղ Docker չկա։ Փլագիններ գալիս են **երեք մակարդակով**, որոնք տարբերվում են նրանով, թե ինչպես են կատարվում և ինչ կարող են անել։ ## Երեք մակարդակները հպանցիկ | Մակարդակ | Ինչ է այն | Ինչպես է աշխատում | Հավատարմագրեր | |---|---|---|---| | **Tier 1** | Ինքնուրույն host-native ծառայություններ (ալիքներ, ձայն) | Իր սեփական մեկուսացված systemd միավորը + պորտ | Համատեղ (workspace) | | **Tier 2** | In-process գործիքներ/skills | Gateway-ի պրոցեսի ներսում | Անձնական կամ համատեղ | | **Tier 3** | Zero-code աղբյուրի տիպեր (OpenAPI, MCP) | Սինթեզվում է gateway-ի կողմից, առանց կոդի | Անձնական (օգտատերերով OAuth) կամ համատեղ | ## Tier 1 — ինքնուրույն host-native ծառայություններ Tier-1 փլագինները ինքնին լիարժեք ծառայություններ են. ալիքների կոնեկտորներ և ձայնային բաղադրիչներ, ինչպիսիք են SIP, Bitrix24, Einstein և iOS-proxy փլագինները։ Յուրաքանչյուրը տեղակայվում է որպես **իր սեփական մեկուսացված systemd միավոր, որը լսում է իր սեփական պորտում**, և gateway-ը նրա հետ խոսում է HTTP-ով։ Սա «host-native, ոչ Docker» սկզբունքն է գործողության մեջ — փլագինը կառավարվող համակարգային ծառայություն է, ոչ թե կոնտեյներ։ **Ալիքների կոնեկտորներ, որոնք հասանելի են հիմա.** Telegram, MAX (նոր ռուսական մեսենջեր, ալիք `max`) և Bitrix24 (ներքին աշխատակիցների IM ալիք, ոչ թե հաճախորդների omnichannel)։ Նախադիտման մեջ և ճանապարհային քարտեզում. Discord, Slack, Teams, Matrix, Signal, Email և WhatsApp։ > [!NOTE] > Tier-1 փլագինները չեն ներառվում gateway-ի binary-ի մեջ։ Դրանք տեղադրվում և > վերահսկվում են որպես առանձին systemd ծառայություններ և հասանելի են URL-ով, ինչն այն պատճառն է, որ յուրաքանչյուրն > ունի իր սեփական պորտը։ ## Tier 2 — in-process գործիքներ/skills Tier-2 փլագինները **գործիքներ/skills են, որոնք կոմպիլացված են gateway-ի մեջ և աշխատում են նրա պրոցեսի ներսում**։ Քանի որ դրանք կատարվում են in-process գործող օգտատիրոջ անունից, դրանք կարող են օգտագործել [անձնական կամ համատեղ հավատարմագրեր](/hy/v1.0/access/personal-vs-shared). անձնական ռեժիմը գործողությունը վերագրում է կոնկրետ անձի (նրա հավատարմագիր և turn-ի վերագրում), համատեղ ռեժիմը օգտագործում է մեկ workspace-ի մասշտաբով հավատարմագիր։ > [!NOTE] > Անձնական ինտեգրացիաները արտաքին հաշիվներին (Google, Microsoft, Todoist, Asana, > Jira, ClickUp, GitLab, Spotify, Fitbit, Oura, SmartThings և այլն) մատակարարվում են որպես > [zero-code Tier 3](/hy/v1.0/marketplace/zero-code) — օգտատերերով OAuth > ինտեգրացիաներ, որոնք յուրաքանչյուր օգտատեր միացնում է իր սեփական հաշվին։ ## Tier 3 — zero-code աղբյուրի տիպեր Tier-3 փլագինները **ընդհանրապես ինտեգրացիայի կոդ չեն պահանջում**։ Կան երկու աղբյուրի տիպ. - **OpenAPI** — ուղղորդեք ցանկացած OpenAPI 3.x spec-ի վրա, և AiHummer-ը սինթեզում է մեկ գործիք յուրաքանչյուր operation-ի համար։ - **MCP** — միացրեք ցանկացած MCP սերվեր stdio-ով կամ HTTP-ով և բացահայտեք նրա `tools/list`-ը։ Երկուսն էլ առկա ծառայությունը վերածում են agent-ի գործիքների՝ առանց ձեր կողմից որևէ կոդ գրելու կամ տեղակայելու։ OpenAPI մեխանիզմի միջոցով օգտատերերով OAuth-ով արդեն հասանելի է **անձնական ինտեգրացիաների** մեծ հավաքածու — յուրաքանչյուր օգտատեր դրանք միացնում է իր սեփական հաշվին. 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 և այլն։ Տես [Zero-code ինտեգրացիաներ](/hy/v1.0/marketplace/zero-code)՝ ամբողջական ուղեցույցի համար։ ## Կատալոգը և CDN-ը Marketplace-ի կատալոգը **համաժամացվում է CDN-ից**, այնպես որ տեղադրելի փլագինների ցանկը պահվում է արդիական՝ առանց ձեր կողմից ձեռքով փաթեթավորման։ Ադմին UI-ից դիտում եք կատալոգը, տեղադրում մեկ սեղմումով, և թույլ տալիս յուրաքանչյուր տեղադրմանը auto-update անել իր սեփական ժամանակացույցով։ ## Official և community Կատալոգը բաժանված է երկու registry-ի, որոնք **չեն խառնվում**. - **Official (առաջին կողմի)** — մոդուլներ AiHummer-ից։ Աղբյուրը ֆիքսված և վստահելի է լռելյայն (ստուգվում է ֆիքսված registry բանալու դեմ). Web UI-ում այս փլագինները կրում են **Official** կրծքանշան և դասակարգվում առաջինը։ - **Community (երրորդ կողմի)** — փլագիններ արտաքին մշակողներից, որոնք հրապարակվում են [հանրային registry](/hy/v1.0/marketplace/publishing)-ի միջոցով։ Այն ավելացվում է որպես **առանձին աղբյուր** (`community-catalog.json`), որը **չի վերագրում** պաշտոնական կատալոգը. ցուցակներում այս փլագինները ցուցադրվում են առանց կրծքանշանի և տեսակավորվում ըստ ներբեռնումների քանակի։ Երկու registry-ներն էլ օգտագործում են նույն manifest-ի պայմանագիրը և նույն տեղադրման ուղին. դրանք տարբերվում են **origin-ով և վստահության խարսխով** (տես [Տեղադրում և թարմացումներ](/hy/v1.0/marketplace/install-updates#trust-model-and-the-pinned-key))։ ## Ո՞ւր հաջորդիվ - [Տեղադրում և թարմացումներ](/hy/v1.0/marketplace/install-updates) — մեկ սեղմումով տեղադրման կենսացիկլը և մեկուսացված systemd միավորները։ - [Փլագինի SDK](/hy/v1.0/marketplace/sdk) — ստեղծեք ձեր սեփական փլագինը մեկ `manifest.json`-ից։ - [Փլագինի հրապարակում](/hy/v1.0/marketplace/publishing) — պաշտոնական և համայնքային registry, հրապարակման երկու ռեժիմները։ - [Zero-code ինտեգրացիաներ](/hy/v1.0/marketplace/zero-code) — OpenAPI և MCP մանրամասն։