Marketplace-ის მიმოხილვა და დონეები

**პლაგინების marketplace** არის ის, თუ როგორ ვითარდება AiHummer მისი ჩაშენებული რანტაიმის მიღმა. მისი კატალოგი სინქრონიზდება CDN-იდან, ინსტალაცია არის ერთი დაწკაპუნება ადმინ-UI-დან, და ყოველი პლაგინი მუშაობს **ჰოსტზე-მშობლიურად** — მოდელში სადმე Docker არ არსებობს. პლაგინები მოდის **სამ დონეში**, რომლებიც განსხვავდებიან იმით, თუ როგორ სრულდებიან და რისი გაკეთება შეუძლიათ. ## სამი დონე ერთი შეხედვით | დონე | რა არის | როგორ მუშაობს | სერთიფიკატები | |---|---|---|---| | **Tier 1** | დამოუკიდებელი ჰოსტზე-მშობლიური სერვისები (არხები, ხმა) | საკუთარი იზოლირებული systemd ერთეული + პორტი | საზიარო (workspace) | | **Tier 2** | პროცესში მუშავი ხელსაწყოები/უნარები | gateway-ის პროცესის შიგნით | პირადი ან საზიარო | | **Tier 3** | უკოდო წყაროს ტიპები (OpenAPI, MCP) | gateway-ის მიერ სინთეზირებული, კოდის გარეშე | პირადი (თითო მომხმარებლის OAuth) ან საზიარო | ## Tier 1 — დამოუკიდებელი ჰოსტზე-მშობლიური სერვისები Tier-1 პლაგინები არიან სრულფასოვანი სერვისები საკუთარი უფლებით: არხის კონექტორები და ხმის კომპონენტები, როგორებიცაა SIP, Bitrix24, Einstein და iOS-proxy პლაგინები. თითოეული განთავსდება როგორც **საკუთარი იზოლირებული systemd ერთეული, რომელიც უსმენს საკუთარ პორტს**, ხოლო gateway მას ესაუბრება HTTP-ით. ეს არის "ჰოსტზე-მშობლიური, არა Docker" პრინციპი მოქმედებაში — პლაგინი არის მართვადი სისტემური სერვისი და არა კონტეინერი. **ახლა ხელმისაწვდომი არხის კონექტორები:** Telegram, MAX (ახალი რუსული მესენჯერი, არხი `max`) და Bitrix24 (შიდა თანამშრომელთა IM არხი, და არა მომხმარებლის ომნიარხი). Preview-ში და სამოქმედო გეგმაში: Discord, Slack, Teams, Matrix, Signal, Email და WhatsApp. > [!NOTE] > Tier-1 პლაგინები არ არის ჩაშენებული gateway-ის ბინარში. ისინი ინსტალირდება და > კონტროლდება როგორც ცალკე systemd სერვისები და მისაწვდომია URL-ით, რის გამოც > თითოეულს აქვს საკუთარი პორტი. ## Tier 2 — პროცესში მუშავი ხელსაწყოები/უნარები Tier-2 პლაგინები არიან **gateway-ში დაკომპილებული ხელსაწყოები/უნარები, რომლებიც მუშაობს მისი პროცესის შიგნით**. ვინაიდან ისინი სრულდებიან პროცესში მოქმედი მომხმარებლის სახელით, მათ შეუძლიათ გამოიყენონ [პირადი ან საზიარო სერთიფიკატები](/ka/v1.0/access/personal-vs-shared): პირადი რეჟიმი მოქმედებას მიაკუთვნებს კონკრეტულ ადამიანს (მის სერთიფიკატსა და მსვლელობის ატრიბუციას), საზიარო რეჟიმი იყენებს ერთ workspace-მასშტაბის სერთიფიკატს. > [!NOTE] > პირადი ინტეგრაციები გარე ანგარიშებთან (Google, Microsoft, Todoist, Asana, Jira, > ClickUp, GitLab, Spotify, Fitbit, Oura, SmartThings და სხვა) მოდის როგორც > [უკოდო Tier 3](/ka/v1.0/marketplace/zero-code) — თითო მომხმარებლის OAuth > ინტეგრაციები, რომელსაც ყოველი მომხმარებელი უკავშირებს საკუთარ ანგარიშს. ## Tier 3 — უკოდო წყაროს ტიპები Tier-3 პლაგინებს **საერთოდ არ სჭირდება ინტეგრაციის კოდი**. არსებობს ორი წყაროს ტიპი: - **OpenAPI** — მიუთითეთ ნებისმიერ OpenAPI 3.x სპეციფიკაციაზე და AiHummer ააგებს თითო ხელსაწყოს თითო ოპერაციაზე. - **MCP** — დააკავშირეთ ნებისმიერი MCP სერვერი stdio-ით ან HTTP-ით და გამოაჩინეთ მისი `tools/list`. ორივე აქცევს არსებულ სერვისს აგენტის ხელსაწყოებად ისე, რომ თქვენ არც კოდს დაწერთ და არც განათავსებთ. 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 და სხვა. სრული მიმოხილვისთვის იხილეთ [უკოდო ინტეგრაციები](/ka/v1.0/marketplace/zero-code). ## კატალოგი და CDN marketplace-ის კატალოგი **სინქრონიზდება CDN-იდან**, ასე რომ ინსტალირებადი პლაგინების სია მუდმივად განახლებულია თქვენი მხრიდან ხელით შეფუთვის გარეშე. ადმინ-UI-დან თქვენ ათვალიერებთ კატალოგს, აინსტალირებთ ერთი დაწკაპუნებით და თითოეულ ინსტალაციას აძლევთ საშუალებას, თავად განახლდეს საკუთარი გრაფიკით. ## ოფიციალური და საზოგადოების კატალოგი იყოფა ორ registry-ად, რომლებიც **არ ერევიან ერთმანეთში**: - **ოფიციალური (პირველი მხარის)** — მოდულები AiHummer-ისგან. წყარო ნაგულისხმევად ფიქსირებული და სანდოა (მოწმდება ფიქსირებული registry გასაღების მიმართ); Web-UI-ში ამ პლაგინებს აქვთ **Official** ბეჯი და პირველ რიგში ლაგდებიან. - **საზოგადოების (მესამე მხარის)** — პლაგინები გარე დეველოპერებისგან, გამოქვეყნებული [საჯარო registry](/ka/v1.0/marketplace/publishing)-ის გავლით. ემატება როგორც **ცალკე წყარო** (`community-catalog.json`), რომელიც **არ გადააწერს** ოფიციალურ კატალოგს; ჩამონათვალში ეს პლაგინები ჩანან ბეჯის გარეშე და ლაგდებიან ჩამოტვირთვების რაოდენობით. ორივე registry იყენებს იმავე მანიფესტის კონტრაქტს და იმავე ინსტალაციის გზას; ისინი განსხვავდებიან **წყაროთი და ნდობის წამყვანით** (იხილეთ [ინსტალაცია და განახლებები](/ka/v1.0/marketplace/install-updates#trust-model-and-the-pinned-key)). ## სად შემდეგ - [ინსტალაცია და განახლებები](/ka/v1.0/marketplace/install-updates) — ერთი დაწკაპუნებით ინსტალაციის სასიცოცხლო ციკლი და იზოლირებული systemd ერთეულები. - [Plugin SDK](/ka/v1.0/marketplace/sdk) — ააგეთ საკუთარი პლაგინი ერთი `manifest.json`-იდან. - [პლაგინის გამოქვეყნება](/ka/v1.0/marketplace/publishing) — ოფიციალური და საზოგადოების registry, ორი გამოქვეყნების რეჟიმი. - [უკოდო ინტეგრაციები](/ka/v1.0/marketplace/zero-code) — OpenAPI და MCP დეტალურად. </content> </invoke>