მიმოხილვა

სამუშაო სივრცის ადმინისტრატორებს შეუძლიათ GitHub-იდან პლაგინების მარკეტპლეისის იმპორტი თავიანთი სამუშაო სივრცის კატალოგში. მარკეტპლეისი არის JSON კატალოგი, რომელშიც ჩამოთვლილია იმპორტისთვის განკუთვნილი პლაგინები. იმპორტის შემდეგ ყოველდღიური სინქრონიზაცია პლაგინებს რეპოზიტორიუმში შეტანილი ცვლილებების შესაბამისად აახლებს.


მარკეტპლეისის სინქრონიზაციით ხდება პლაგინების შიგთავსის იმპორტი — ის არ აკავშირებს სამუშაო სივრცის წევრთა ანგარიშებს და არც პლაგინში შემავალ აპებზე წვდომას ანიჭებს მათ.


პლაგინებისა და მათში შემავალი აპების გასაცნობად იხილეთ: პლაგინები ChatGPT-სა და Codex-ში.

დაწყებამდე

• გამოიყენეთ GitHub-ის ანგარიში, რომელსაც მარკეტპლეისის რეპოზიტორიუმისა და მასში მითითებული ყველა სხვა რეპოზიტორიუმის წაკითხვის უფლება აქვს. მხარდაჭერილია github.com-ზე განთავსებული საჯარო და კერძო რეპოზიტორიუმები.

• მიიღეთ GitHub-ის ორგანიზაციის ყველა საჭირო თანხმობა, რათა იმპორტისთვის გამოყენებულ ანგარიშს ამ რეპოზიტორიუმებზე წვდომა ჰქონდეს.

• გადახედეთ რეპოზიტორიუმის შიგთავსს. იმპორტისას მუშავდება ყველა გამართული პლაგინი თითოეულის ცალკე დამტკიცების გარეშე, ხოლო მომდევნო სინქრონიზაციებმა შეიძლება ახალი პლაგინებიც დაამატოს.

ახალი პლაგინების ინსტალაციის საწყისი სტატუსია ხელმისაწვდომი, ავთენტიფიკაცია კი ინსტალაციისას ხდება. ახალ მარკეტპლეისებს ავტომატური ყოველდღიური სინქრონიზაცია ჩართული აქვთ. იმპორტის შემდეგ გადახედეთ თითოეული პლაგინის სამუშაო სივრცის პარამეტრებსა და საჭირო აპებს.

მარკეტპლეისის იმპორტი

1. გადადით ადმინისტრატორის კონსოლში, აირჩიეთ ChatGPT-ის სასურველი სამუშაო სივრცე და გახსენით პლაგინები. შემდეგ აირჩიეთ დამატება და მარკეტპლეისის იმპორტი.

2. ველში წყარო შეიყვანეთ რეპოზიტორიუმის URL, მაგალითად, https://github.com/example/team-plugins. გამოიყენეთ მხოლოდ რეპოზიტორიუმის URL და არა განშტოების ან საქაღალდის URL.

3. თუ მარკეტპლეისი ქვესაქაღალდეშია, მიუთითეთ ეს საქაღალდე ველში ბილიკი. მაგალითად, team-tools/.agents/plugins/marketplace.json ფაილისთვის შეიყვანეთ team-tools. რეპოზიტორიუმის ძირეული საქაღალდის გამოსაყენებლად ველი ბილიკი ცარიელი დატოვეთ. არ შეიყვანოთ აღწერის ფაილის სახელი.

4. სურვილისამებრ, შეავსეთ ველი განშტოება, ტეგი ან კომიტი. რეპოზიტორიუმის ნაგულისხმევი განშტოების გამოსაყენებლად ველი ცარიელი დატოვეთ. მომავალი კომიტების მისაღებად გამოიყენეთ განშტოება. კონკრეტული კომიტის მითითებისას ვერსია უცვლელი რჩება.

5. აირჩიეთ მარკეტპლეისის იმპორტი და მოთხოვნისას მიეცით GitHub-ზე წვდომის ნებართვა.

6. გადახედეთ იმპორტის შედეგებს, შემდეგ გახსენით თითოეული იმპორტირებული პლაგინი მისი ინსტალაციის პოლიტიკისა და საჭირო აპების დასაყენებლად.

ძალიან დიდი მარკეტპლეისების თავდაპირველ იმპორტს შეიძლება 1 საათამდე დასჭირდეს. შემდგომ ყოველდღიურ სინქრონიზაციას, ჩვეულებრივ, რამდენიმე წუთი სჭირდება.

თუ პლაგინის იმპორტი ვერ მოხერხდება, ანგარიშში განმარტებული იქნება შეცდომის მიზეზი. სხვა გამართული პლაგინების იმპორტი მაინც შესაძლებელია.

მხარდაჭერილი ფორმატები

არჩეული საქაღალდე უნდა შეიცავდეს მხარდაჭერილ აღწერის ფაილს:

• .agents/plugins/marketplace.json — Codex-ის მარკეტპლეისისთვის.

• .claude-plugin/marketplace.json — Claude-თან თავსებადი მარკეტპლეისისთვის.

• .claude-plugin/plugin.json — Claude-ის დამოუკიდებელი პლაგინისთვის, როცა მარკეტპლეისის აღწერის ფაილი არ არსებობს.

მარკეტპლეისის ჩანაწერებში შეიძლება მითითებული იყოს პლაგინების საქაღალდეები იმავე რეპოზიტორიუმში ან GitHub-ის რეპოზიტორიუმის მხარდაჭერილი წყაროები. სამუშაო სივრცეში იმპორტს არ აქვს სხვა Git ჰოსტებისა და პაკეტების რეესტრის წყაროების, მაგალითად, npm-ის მხარდაჭერა.

მხარდაჭერილი ფორმატების, JSON მაგალითებისა და წყაროს ველების შესახებ იხილეთ: პლაგინების მართვა.

სამუშაო სივრცეში წვდომის პარამეტრების დაყენება

პლაგინის შიგთავსს GitHub აწვდის, ხოლო ინსტალაციასა და ავთენტიფიკაციას სამუშაო სივრცის პარამეტრები განსაზღვრავს. იმპორტი და სინქრონიზაცია არ იყენებს რეპოზიტორიუმში მითითებულ პოლიტიკის მნიშვნელობებს, როგორიცაა AVAILABLE ან ON_USE. დააყენეთ ეს პარამეტრები თქვენს სამუშაო სივრცეში თითოეული პლაგინისთვის.


პარამეტრით ინსტალაციის პოლიტიკა აირჩიეთ ხელმისაწვდომი ან ინსტალირებული თითოეული შესაბამისი როლისთვის. საჭირო აპებიც ჩართული უნდა იყოს, წევრებს კი უნდა ჰქონდეთ დაკავშირებულ სერვისზე წვდომა და გავლილი ჰქონდეთ ყველა საჭირო ავთენტიფიკაცია.


პლაგინის განახლების სინქრონიზაციისას ან არსებული პლაგინის GitHub-ით მართვაზე გადაყვანისას მისი სამუშაო სივრცის პოლიტიკები უცვლელი რჩება. პლაგინის იმპორტი არ იძლევა აპზე წვდომას და არ აკავშირებს წევრთა ანგარიშებს.


სამუშაო სივრცეში ნავიგაციის, აპებზე წვდომისა და სამუშაო სივრცის მართვის საშუალებების შესახებ იხილეთ: პლაგინებისა და აპების ადმინისტრაციული მართვა, უსაფრთხოება და მოთხოვნებთან შესაბამისობა.

პლაგინების განახლება

ახალი მარკეტპლეისებისთვის განახლებები ყოველდღიურად მოწმდება. განახლების მოთხოვნისთვის ავტომატური სინქრონიზაციის ლოდინის გარეშე:

1. გადადით ადმინისტრატორის კონსოლში, აირჩიეთ ChatGPT-ის სასურველი სამუშაო სივრცე და გახსენით პლაგინები.

2. გახსენით მარკეტპლეისები და აირჩიეთ მარკეტპლეისი.

3. აირჩიეთ სინქრონიზაცია ახლა.

სინქრონიზაციით შესაძლებელია მარკეტპლეისის ახალი ჩანაწერების დამატება და არსებული პლაგინების განახლება. გაერთიანებამდე გადახედეთ რეპოზიტორიუმის ცვლილებებს, რადგან ავტომატურ სინქრონიზაციას შეუძლია ახალი პლაგინების იმპორტი დამატებითი საიმპორტო ნაბიჯის გარეშე.

სინქრონიზაციის შედეგების გადახედვა

სინქრონიზაციის შემდეგ გადახედეთ მის სტატუსსა და შენახულ ანგარიშს. დასრულებულია — N შეცდომა ნიშნავს, რომ სინქრონიზაცია დასრულდა, თუმცა ზოგიერთი პლაგინის დამუშავება ვერ მოხერხდა.


თუ არსებული პლაგინის განახლება არავალიდურია, ნარჩუნდება მისი ბოლო მუშა ვერსია. სხვა ვალიდური განახლებები მაინც შეიძლება დასრულდეს. გამოასწორეთ ანგარიშში მითითებული პრობლემა GitHub-ზე, შემდეგ ხელახლა საცდელად აირჩიეთ სინქრონიზაცია ახლა.


თუ ადმინისტრატორის ინტერფეისში ცალკე იმპორტირებული პლაგინისთვის ჩანს განახლება, გამოიყენეთ ის ამ პლაგინის განსაახლებლად. პლაგინების სიის განახლება მხოლოდ ხელახლა ტვირთავს ნაჩვენებ სიას; ის GitHub-თან სინქრონიზაციას არ ასრულებს.

რას გულისხმობს ამოღება და წაშლა

რეპოზიტორიუმიდან ჩანაწერის ამოღება არ შლის სამუშაო სივრცეში იმპორტირებულ მის ასლს. პლაგინს ენიჭება სტატუსი წყაროში აღარ არის.


ChatGPT-ში მარკეტპლეისის წაშლა შლის მისგან იმპორტირებულ ყველა პლაგინს. არ წაშალოთ მარკეტპლეისი GitHub-თან კავშირის აღსადგენად ან მფლობელის შესაცვლელად.

GitHub-თან კავშირის აღდგენა ან წვდომის შეცვლა

მარკეტპლეისის სინქრონიზაციისთვის გამოიყენება იმ ადმინისტრატორის GitHub-თან კავშირი, რომელმაც მისი იმპორტი განახორციელა. ამ ანგარიშს მუდმივად უნდა ჰქონდეს წვდომა მარკეტპლეისის რეპოზიტორიუმსა და მასში მითითებულ ყველა რეპოზიტორიუმზე.

თავდაპირველი ანგარიშის ხელახლა დაკავშირება

1. დარწმუნდით, რომ იმპორტისთვის გამოყენებულ GitHub-ის ანგარიშს კვლავ აქვს წვდომა ყველა საჭირო რეპოზიტორიუმზე.

2. სთხოვეთ ადმინისტრატორს, რომელმაც თავდაპირველად მარკეტპლეისის იმპორტი განახორციელა, ChatGPT-ში გახსნას GitHub-ის პლაგინი და ხელახლა დააკავშიროს თავისი ანგარიში.

ახალი ადმინისტრატორისთვის გადაბარება

სამუშაო სივრცის ახალ ადმინისტრატორს შეუძლია იმავე მარკეტპლეისის იმპორტი GitHub-თან საკუთარი კავშირის გამოყენებით:

1. გადადით ადმინისტრატორის კონსოლში, აირჩიეთ ChatGPT-ის სასურველი სამუშაო სივრცე და გახსენით პლაგინები. შემდეგ აირჩიეთ დამატება > მარკეტპლეისის იმპორტი.

2. ველებში წყარო, ბილიკი და განშტოება, ტეგი ან კომიტი შეიყვანეთ იგივე მნიშვნელობები, რომლებიც არსებული მარკეტპლეისისთვის გამოიყენება.

3. აირჩიეთ მარკეტპლეისის იმპორტი და მოთხოვნისას მიეცით GitHub-ზე წვდომის ნებართვა.

მომავალი სინქრონიზაციებისთვის გამოყენებული იქნება ახალი ადმინისტრატორის GitHub-თან კავშირი. ახალი ადმინისტრატორის ანგარიშს უნდა ჰქონდეს მარკეტპლეისის რეპოზიტორიუმისა და მასში მითითებული ყველა რეპოზიტორიუმის წაკითხვის უფლება.

არსებული პლაგინის GitHub-ით მართვაზე გადაყვანა

მარკეტპლეისით შეგიძლიათ მართოთ სამუშაო სივრცეში არსებული პლაგინი, რომელიც არქივის სახით აიტვირთა ან ჯერ არ იმართება GitHub-ის წყაროდან. არსებული პლაგინი იმავე სამუშაო სივრცეში უნდა იყოს და პლაგინის იგივე სახელი უნდა ჰქონდეს. ამ გზით ვერ გადაიბარებთ იმ პლაგინის მართვას, რომელიც GitHub-ის სხვა წყაროდან იმართება.


თქვენს მარკეტპლეისში არსებული პლაგინის იდენტიფიცირებისთვის:

1. გადადით ადმინისტრატორის კონსოლში, აირჩიეთ ChatGPT-ის სასურველი სამუშაო სივრცე და გახსენით პლაგინები. გახსენით პლაგინი.

2. დააკოპირეთ პლაგინის ID, რომელიც მის URL-ში /admin/plugins/-ის შემდეგაა.

3. მარკეტპლეისის plugins მასივის შესაბამის ჩანაწერში დაამატეთ ეს ID როგორც pluginId, name და source ველების გვერდით. არ დაამატოთ ის პლაგინის plugin.json ფაილში.

პლაგინი ინარჩუნებს თავის ID-ს, გაზიარების პარამეტრებსა და სამუშაო სივრცის პოლიტიკებს. მომავალი განახლებების წყარო ხდება GitHub, ამიტომ მოგვიანებით ატვირთული არქივებით პლაგინს ვეღარ ჩაანაცვლებთ.


მიგრაციის მაგალითისა და მოთხოვნებისთვის იხილეთ: პლაგინების მართვა.

არსებული აპის მითითება

პლაგინს შეუძლია არსებული აპი მიუთითოს თავის ძირეულ საქაღალდეში მდებარე .app.json ფაილში. ფაილის სახელის დასაწყისში წერტილიც ჩართეთ და პლაგინის ID-ის ნაცვლად აპის ID გამოიყენეთ. ნატიური პლაგინისთვის .codex-plugin/plugin.json ფაილის apps ველის მნიშვნელობად მიუთითეთ ./.app.json.


ასეთი მითითება არ ქმნის აპს და არც დამატებით ნებართვებს იძლევა. აპისთვის კვლავ მოქმედებს სამუშაო სივრცეში წვდომის, ავთენტიფიკაციის, ქმედებების მართვისა და დაკავშირებული სერვისის ნებართვების არსებული წესები.


JSON ფორმატისთვის იხილეთ: პლაგინების მართვა.

რას ნიშნავს იარლიყი „მხოლოდ დესკტოპზე“

პლაგინი იარლიყით მხოლოდ დესკტოპზე ვერ იმუშავებს ChatGPT-ის ვებვერსიაში. იმპორტირებულ პლაგინებს შეიძლება ეს იარლიყი მიენიჭოს, თუ მათში დეკლარირებულია MCP სერვერები, მაგალითად, mcp.json ან .mcp.json ფაილში, მაშინაც კი, როცა სერვერი დისტანციურ HTTPS URL-ს იყენებს.



.app.json ფაილში აპის მითითების დამატება თავისთავად არ ხსნის იარლიყს მხოლოდ დესკტოპზე. ნებისმიერი მითითებული აპი კვლავ ხელმისაწვდომი უნდა იყოს წევრის როლისთვის და მასზე ვრცელდება წვდომისა და ავთენტიფიკაციის ჩვეულებრივი მოთხოვნები.