მიმოხილვა

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

შაბლონები სასარგებლოა, როცა OpenAI-ს შეუძლია აპის საერთო ქცევის უზრუნველყოფა, მაგრამ თითოეულმა სამუშაო სივრცემ პროვაიდერისთვის სპეციფიკური კონფიგურაცია უნდა მიაწოდოს. შაბლონიდან გამომდინარე, ეს კონფიგურაცია შეიძლება მოიცავდეს ტენანტის ან ჰოსტის სახელს, OAuth-ის კლიენტის ავტორიზაციის მონაცემებს, უკუკავშირის URL-ებს, სკოუპებს, ვებჰუკის დეტალებს, მართული MCP სერვერის URL-ებს ან პროვაიდერის სხვა პარამეტრებს. მაგალითად, GitHub Enterprise-ის შაბლონმა შეიძლება შექმნას სამუშაო სივრცისთვის განკუთვნილი კონექტორი, რომელსაც Codex იყენებს ამ ორგანიზაციის GitHub Enterprise ჰოსტთან დასაკავშირებლად.

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


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

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

• GitHub Enterprise

• Snowflake

• Databricks

შაბლონები სასარგებლოა, როცა აპის ერთი და იგივე მოდელი ბევრ ორგანიზაციაში შეიძლება იმუშაოს, მაგრამ თითოეულ ორგანიზაციას საკუთარი კონფიგურაცია სჭირდება.

გავრცელებული მაგალითებია:

• პროვაიდერის URL შეიცავს კომპანიის ტენანტს, ანგარიშს, ორგანიზაციას ან სამუშაო სივრცის ჰოსტის სახელს.

• ორგანიზაციამ უნდა გამოიყენოს საკუთარი OAuth კლიენტი ან პროვაიდერის ავტორიზაციის მონაცემები.

• პროვაიდერი მოითხოვს მომხმარებლისთვის სპეციფიკური უკუკავშირის URL-ის დაყენებას.

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

რით განსხვავდება შაბლონებიჩვეულებრივი აპებისგან

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

ჩვეულებრივი პროცესი ასეთია:

• ადმინისტრატორი პოულობს შაბლონს სამუშაო სივრცის პარამეტრებში > აპები > დირექტორია.

• ადმინისტრატორს შეჰყავს სამუშაო სივრცისთვის საჭირო კონფიგურაცია.

• ChatGPT სამუშაო სივრცისთვის ქმნის აპის შავ ვერსიას.

• ადმინისტრატორი გადახედავს და აქვეყნებს შავ ვერსიას.

• ადმინისტრატორი გამოქვეყნებული აპისთვის აკონფიგურირებს წვდომისა და მოქმედებების პარამეტრებს.

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

აპის შაბლონის პოვნა და დაყენება

• გახსენით სამუშაო სივრცის პარამეტრები > აპები.

• აირჩიეთ დირექტორია.

• მოძებნეთ პროვაიდერის ან აპის სახელი.

• მოძებნეთ ჩანაწერები, რომლებიც შაბლონებად არის მონიშნული.

• დაყენების პროცესის დასაწყებად აირჩიეთ ჩართვა.

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

მაგალითად, GitHub Enterprise-ის შაბლონმა შეიძლება მოითხოვოს ისეთი დეტალები, როგორიცაა:

• აპის სახელი და აღწერა.

• GitHub Enterprise-ის ჰოსტის სახელი.

• უკუკავშირის URL-ის კონფიგურაცია.

• OAuth-ის კლიენტის ID და კლიენტის საიდუმლო.

• GitHub App-ის პირადი გასაღები.

• მოთხოვნილი სკოუპები.

• ვებჰუკის დაყენების დეტალები.

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

იხილეთ აპისთვის განკუთვნილი ინსტრუქციები:GitHub,Snowflake დაDatabricks.

OAuth კლიენტის დაყენება

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

OAuth-ის კლიენტის ID და საიდუმლო ChatGPT-ში შეიყვანეთ მხოლოდ მას შემდეგ, რაც დაადასტურებთ, რომ პროვაიდერის კონფიგურაცია შაბლონის დაყენების ინსტრუქციებს ემთხვევა.

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

შავი ვერსიის შექმნა

საჭირო ინფორმაციის შეყვანის შემდეგ აირჩიეთ შავი ვერსიის შექმნა.

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

შედეგად მიღებული აპის გამოქვეყნება და მართვა

გამოქვეყნების შემდეგ სამუშაო სივრცისთვის განკუთვნილი აპი მართეთ სამუშაო სივრცის პარამეტრებიდან > აპები > ჩართული.

რეკომენდებული შემოწმებები გამოქვეყნების შემდეგ:

• დაადასტურეთ, რომ აპი ჩანს ჩართულ აპებში.

• დააყენეთ მომხმარებლის წვდომა იმ როლებისთვის, რომლებმაც აპი უნდა გამოიყენონ.

• გადახედეთ მოქმედებების კონტროლს წაკითხვისა და ჩაწერის მოქმედებებისთვის.

• გადახედეთ აპის ნებართვებს, რათა აირჩიოთ, როდის ჰკითხავს ChatGPT წევრებს აპის გამოყენებამდე.

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

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

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

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

თუ შაბლონის გამოყენება მხოლოდ ერთხელ შეიძლება

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

რას ხედავენ წევრები

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

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

შეამოწმეთ, რომ:

• აპი გამოქვეყნებულია.

• აპი ჩართულია სამუშაო სივრცისთვის.

• წევრის სამუშაო სივრცის როლს აქვს წვდომა.

• წევრი სწორ სამუშაო სივრცეშია.

• წევრს გარე პროვაიდერში საჭირო ნებართვები აქვს.

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

პრობლემების მოგვარება

თუ დაყენება ვერ სრულდება ან აპი არ ჩანს, გადაამოწმეთ შემდეგი:

• ტენანტის, ანგარიშის ან სამუშაო სივრცის ჰოსტის სახელი სწორია.

• უკუკავშირის URL ზუსტად დაკოპირდა პროვაიდერის კონფიგურაციაში.

• OAuth-ის კლიენტის ID და კლიენტის საიდუმლო სწორია.

• მოთხოვნილი სკოუპები ემთხვევა იმას, რასაც პროვაიდერის OAuth აპი უშვებს.

• შავი ვერსია შეიქმნა.

• შავი ვერსია გამოქვეყნდა.

• როლის წვდომა სატესტო მომხმარებელს აპის ნახვის უფლებას აძლევს.

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

უსაფრთხოების შენიშვნები

• OAuth-ის კლიენტის საიდუმლოები და პროვაიდერის ავტორიზაციის მონაცემები სენსიტიურ ინფორმაციად მიიჩნიეთ.

• შავი ვერსიის შექმნამდე გადახედეთ მოთხოვნილ სკოუპებს.

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

• გამოიყენეთ აპის ნებართვები, რათა განსაზღვროთ, როდის ჰკითხავს ChatGPT წევრებს აპის გამოყენებამდე.

• გაითვალისწინეთ, რომ პროვაიდერის ნებართვები კვლავ მოქმედებს მას შემდეგაც, რაც აპი ChatGPT-ში ჩაირთვება.