სავაჭრო პლატფორმის მიმოხილვა და დონეები

ეს **პლაგინების მაღაზია** შეიძლება ასე ვთქვათ, AiHummer გადადის მის ნაპრიბილებულ დრაივტაიმს. მისი კატალოგი სინქრონიზებულია CDN-იდან, ინსტალაციები ხდება ერთი დაწკაპებით ადმინისტრატორის UI-დან, და ყოველი პლაგინი მუშაობს **მასპინძლისთვის ბუნებრივი** — მოდელში არსადაა Docker. პლაგინები ირთვება **სამი დონე** რომლებიც განსხვავდებიან იმით, როგორ შესრულებენ და რას შეძლებენ აკეთონ. ## სამი დონე პირველივე მზერაზე | საფეხური | რა არის ეს | როგორ მუშაობს ეს | ობიექტის მონაცემები | |---|---|---|---| | **საფეხური 1** | თავისუფალი ადგილობრივი ჰოსტ-სერვისები (არხები, ხმა) | საკუთარი ქვიშის ყუთის ერთეული systemd + პორტი | საერთო (სამუშაო სივრცე) | | **საფეხური 2** | ინსტრუმენტები/ჩინოვნებები პროცესში | გეითვეის პროცესის შიგნით | პირადი თუ საერთო | | **საფეხური 3** | კოდის ტიპები პროგრამირების გარეშე (OpenAPI, MCP) | სინთეზირებულია გაჯეტის მიერ, კოდის გარეშე | პირადი (OAuth თითოეული მომხმარებლისთვის) ან საერთო | ## საფეხური 1 — მასპინძლის დამოუკიდებელი ადგილობრივი სერვისები პირველი დონის პლაგინები სრულფასოვანი სერვისებია თავად: არხის კავშირელები და ხმოვანი კომპონენტები, როგორიცაა SIP, Bitrix24, Einstein და iOS-პროქსი პლაგინები. თითოეული მათგანი განთავსდება როგორც **განცალკეულებული საკუთარი systemd ერთეული, საკუთარი პორტის მოსმენა**, და გადამრთველი მასთან HTTP-ის მეშვეობით ეთიანობს. ეს არის პრინციპი „მეინჰოსტისთვის ნამდვილი, არა Docker-ისთვის“ — დანამატი მართვადი სისტემური სერვისია, არა კონტეინერი. **არხების კონექტორები კატალოგში:** ტელეგრამი გაერთიანებულია Community–ის გეგმაში; MAX (ახალი რუსული მესენჯერი, არხი `max`), Bitrix24 (თანამშრომლებისთვის საშინაო მყისიერი შეტყობინების არხი, მომხმარებლისთვის არა ომნიკანალი), ასევე Discord, Slack, Teams, Matrix, Signal, Email და WhatsApp საჭიროებენ ლიცენზიას — იხილეთ ქვემოთ შენიშვნა. > [!NOTE] > კომუნიტის გეგმა მოიცავს მხოლოდ მთავარ არხს — Telegram. ნებისმიერი სხვა არხის შემაერთებლის დაყენება საჭიროებს აქტიურ **სტარტერი**, > **ბიზნესი** ან **წარმოება** ლიცენზია; მოთხოვნა საზოგადოების დაყენებაზე > აბრუნებს **HTTP 402 «ხრიკინდება განახლება»** (კოდი `plan_limit`) — იხ. > [ლიცენზირება](/ka/v1.0/commercial/licensing). > [!NOTE] > პირველი დონეების პლაგინები არ არის ჩართული გეითვეის ბაინარულ ფაილში. ისინი დაინსტალირება და > კონტროლირდება როგორც სარეიტინგო systemd სერვისები და ხელმისაწვდომია URL–ის საშუალებით, ამიტომ თითოეული > ერთ ვიღაცას აქვს თავისი პორტი. ## საფეხური 2 — პროცესში ხელსაწყოები/უნარები მეორე დონავის პლაგინებია **ინსტრუმენტები/განცადოები შედგენილი გაერთიანებაში და შესრულება მის პროცესში**. რადგან ისინი შესრულდებიან პროცესის ფარგლებში მიმდინარე მომხმარებლის სახელით, ისინი შეუძლიათ გამოიყენონ [პირველადი ან საერთო ანგარიშის მონაცემები](/ka/v1.0/access/personal-vs-shared): პერსონალური რეჟიმი აკრავს მოქმედებას კონკრეტულ ადამიანს (მის ანგარიშთა მონაცემებს და პროცესის ანტრიბუციას), ზოგადი რეჟიმი იყენებს ერთსა და იმავე ანგარიშის მონაცემებს მთელი სამუშაო სივრცისთვის. > [!NOTE] > პერსონალური ინტეგრაციები გარე ანგარიშებთან (Google, Microsoft, Todoist, Asana, > Jira, ClickUp, GitLab, Spotify, Fitbit, Oura, SmartThings და სხვები მიწოდებულია როგორც > [დონე 3 კოდის გარეშე](/ka/v1.0/marketplace/zero-code) — OAuth თითოეული მომხმარებლისთვის > ინტეგრაციები, რომლებსაც თითოეული მომხმარებელი საკუთარ ანგარიშთან უკავშირდება. ## დონე 3 — წყაროების ტიპები კოდის გარეშე მესამე დონეს პლაგინები ჭირდება **ინტეგრაციის კოდის საერთოდ არ მაქვს**. არსებობს ორ ტიპის წყაროები: - **OpenAPI** — მიუთითეთ ნებისმიერი OpenAPI 3.x სპეციფიკაცია, და AiHummer შექმნის ერთ ინსტრუმენტს ოპერაციისთვის. - **MCP** — შეერთდით ნებისმიერ MCP სერვერზე stdio ან HTTP-ის საშუალებით და გახსენით იგი `tools/list`. ორივე აქციონ არსებული სერვისი აგენტის ინსტრუმენტებად, გარეშე საჭიროების რაღაც კოდის დაწერისა ან განთავსების. OpenAPI მექანიზმის საშუალებით, მომხმარებელზე მორგებით OAuth, დიდი ნაკრები **პირადი ინტეგრაციები** უკვე ხელმისაწვდომია — თითოეული მომხმარებელი აკავშირებს მათ თავის ანგარიშთან: Gmail, Google კალენდარი, Google კონტაქტები, Google დავალებები, Google დისკი, YouTube, Outlook ფოსტა, Outlook კალენდარი, OneDrive, Microsoft To Do, Todoist, Asana, Jira Cloud, ClickUp, GitLab, Fitbit, Oura Ring, Spotify, Samsung SmartThings და სხვები. ნახეთ [კოდის გარეშე ინტეგრაციები](/ka/v1.0/marketplace/zero-code) სრული ნაბიჯ-ნაბიჯ სახელმძღვანელოსთვის. ## კატალოგი და CDN გაყიდვების სავაჭრო პლატფორმის კატალოგი **თანმიმდევრულად სინქრონიზდება CDN-თან**, ასე რომ ინსტალირებადი პაპლიგინების სია მუდმივად ახლობელია მექანიკური პაკეტირების გარეშე თქვენს მხარზე. ადმინისტრატორის ინტერფეისიდან თქვენ შეძლებთ კატალოგის შემოწმებას, დაყენებას ერთი დაწკაპუნებით და თითოეული ინსტალაცია თავის განრიგზე ავტომატურად განახლდება. ## სახელმწიფო და საზოგადოებრივი კატალოგი დაყოფილია ორ რეესტრზე, რომლებიც **არ აურიოთ**: - **ოფიციალური (პირველი მხარე)** — AiHummer-ის მოდულები. წყარო დამაგრებულია და ნდობილი სტანდარტულად (შემოწმდება რეგისტრირებული კლავიშის მიხედვით); ვებ -ინტერფეისში ეს პლაგინები შეიცავენ **ოფიციალური** ნიშანი და პირველი რანგი. - **საზოგადოება (მესამე მხარე)** — მესამე მხარის შემქმნელების პლაგინები, გამოქვეყნებული მეშვეობით ეს [პერსონალური ოფისი](/ka/v1.0/marketplace/submit-plugin) («ჩემი პლაგინები» → ჩატვირთვა → ხელოვნური ინტელექტის გადამოწმება → ადამიანის მოდერაცია). ისინი ემატება როგორც **განსხვავებული წყარო** (`community-catalog.json`) რომელიც აკეთებს **არ წაშალოთ** ოფიციალური კატალოგი; ში ამ სიის მიხედვით, ეს პლაგინები აღინიშნება without აიკონის გარეშე და სორტირდება ჩამოტვირთვების რაოდენობის მიხედვით. ორივე რეესტრი იყენებს ერთსა და იმავე მანიფესტის კონტრაქტს და ერთსა და იმავე ინსტალაციის გზას; ისინი განსხვავდებიან **მოვლა და სანდო კვანძი** (იხ. [ინსტალაცია და განახლებები](/ka/v1.0/marketplace/install-updates#trust-model-and-the-pinned-key)). ## სად შემდეგ? - [ინსტალაცია და განახლებები](/ka/v1.0/marketplace/install-updates) — ერთი წკაპი დაადგინოთ სიცოცხლის ციკლი და იზოლირებული systemd ერთეულები. - [პლაგინების განვითარების ნაკრები](/ka/v1.0/marketplace/sdk) — შექმენით თქვენი საკუთარი პლაგინი მარტოხელა `manifest.json`. - [პლაგინის გამოქვეყნება](/ka/v1.0/marketplace/publishing) — ოფიციალური და კომუნის რეესტრი, ორი გამოქვეყნების რეჟიმი. - [კოდის გარეშე ინტეგრაციები](/ka/v1.0/marketplace/zero-code) — OpenAPI და MCP-ში დეტალი.