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

Databricks-ისთვის დაყენების უმეტესი ნაწილი Databricks Account Console-ში ხდება. თქვენ ქმნით მორგებულ OAuth აპის კავშირს, არეგისტრირებთ ChatGPT-ის callback URL-ს, აკოპირებთ შექმნილ client credentials-ს, შემდეგ კი ამ მნიშვნელობებს ChatGPT-ის შაბლონის დაყენების პროცესში სვამთ. მას შემდეგ, რაც ChatGPT შავ აპს შექმნის, შეგიძლიათ გამოაქვეყნოთ ის და მართოთ სხვა სამუშაო სივრცის აპებივით.

რას აყენებთ

თქვენ ქმნით სამუშაო სივრცისთვის განკუთვნილ Databricks აპს ChatGPT-ში. აპი იყენებს:

• თქვენს Databricks Account Console-ში შექმნილ Databricks OAuth აპის კავშირს.

• Databricks OAuth-ის client ID-სა და client secret-ს.

• ChatGPT-დან დაკოპირებულ ზუსტ callback URL-ს.

• Databricks-ის scope-ებს, რომლებიც შეესაბამება იმ connector-ის შესაძლებლობებს, რომელთა ჩართვაც გსურთ.

• Databricks პროვაიდერის ნებისმიერ დეტალს, რომელსაც ChatGPT-ის დაყენების პროცესი მოითხოვს, როგორიცაა workspace host, account host, account ID ან warehouse.

სანამ დაიწყებთ

დაგჭირდებათ:

• ChatGPT სამუშაო სივრცის ადმინისტრატორის ან მფლობელის წვდომა.

• Databricks ანგარიშის ადმინისტრატორის წვდომა. ზოგიერთი ამოცანისთვის სამუშაო სივრცის ადმინისტრატორის წვდომა შეიძლება საკმარისი იყოს, მაგრამ მორგებული აპის კავშირები Databricks Account Console-დან კონფიგურდება.

• Databricks Account Console გახსნილი ცალკე ჩანართში.

• Databricks აპის შაბლონის დაყენების ეკრანი გახსნილი ChatGPT-ში, რათა ზუსტი callback URL დააკოპიროთ.

• გადაწყვეტილება იმის შესახებ, სჭირდება თუ არა აპს Databricks API-ზე ზოგადი წვდომა თუ მხოლოდ Databricks SQL-ზე წვდომა.

• უსაფრთხო ადგილი Databricks client secret-თან სამუშაოდ.

არ მოიგონოთ callback URL. დააკოპირეთ ChatGPT-ში ნაჩვენები ზუსტი callback URL.

მოსამზადებელი მნიშვნელობები

• Callback URL: დააკოპირეთ ეს ChatGPT-ის შაბლონის დაყენების პროცესიდან.

• Databricks OAuth-ის client ID.

• Databricks OAuth-ის client secret.

• Databricks-ის წვდომის scope-ები, როგორიცაა ALL APIs ან SQL.

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

აპის გამოქვეყნება და მართვა ChatGPT-ში

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

1. გამოაქვეყნეთ შავი აპი.

2. დაადასტურეთ, რომ აპი ჩანს სამუშაო სივრცის პარამეტრები > აპები > ჩართული-ში.

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

4. გადახედეთ მოქმედების კონტროლს Databricks-ის იმ მოქმედებებისთვის, რომლებსაც აპი ავლენს.

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

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

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

დაიწყეთ შაბლონის დაყენება ChatGPT-ში

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

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

3. აირჩიეთ კატალოგი.

4. მოძებნეთ Databricks.

5. აირჩიეთ Databricks აპის შაბლონი და დაიწყეთ დაყენება.

6. შეიყვანეთ გასაგები აპის სახელი და აღწერა, მაგალითად Databricks ან Databricks - Data Platform.

7. OAuth client-ის სექციაში დააკოპირეთ callback URL ChatGPT-დან. ეს ჩანართი ღია დატოვეთ.

Callback URL-ის მაგალითი: https://chatgpt.com/connector/oauth/<callback_id>

არ წაშალოთ callback ID, არ დაამატოთ ბოლოში დახრილი ხაზი და არ ჩაანაცვლოთ ის ზოგადი ChatGPT URL-ით.

OAuth აპის კავშირის შექმნა Databricks-ში

1. გახსენით Databricks Account Console თქვენი Databricks ანგარიშისთვის.

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

3. გახსენით ჩანართი აპის კავშირები.

4. აირჩიეთ კავშირის დამატება.

5. შეიყვანეთ აპლიკაციის სახელი, მაგალითად ChatGPT Databricks Connector.

6. Redirect URLs-ში ჩასვით ChatGPT-დან დაკოპირებული ზუსტი callback URL.

7. წვდომის scope-ების ქვეშ აირჩიეთ აპისთვის საჭირო scope-ები.

8. გამოიყენეთ ALL APIs ზოგადი Databricks აპისთვის, რომელსაც SQL-ის მიღმა Databricks API-ები სჭირდება.

9. გამოიყენეთ მხოლოდ SQL ისეთი აპისთვის, რომელიც Databricks SQL API-ებით არის შეზღუდული.

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

11. ჩართეთ client secret-ის გენერაცია. ამ პროცესისთვის ChatGPT-ს კონფიდენციალური OAuth client სჭირდება.

12. შექმენით კავშირი.

მონაცემების კოპირება Databricks-დან

1. Connection created დიალოგში დააკოპირეთ Client ID.

2. დაუყოვნებლივ დააკოპირეთ Client secret და უსაფრთხოდ შეინახეთ.

3. თუ დიალოგს secret-ის კოპირებამდე დახურავთ, შექმენით ან დაატრიალეთ OAuth აპის credentials და გამოიყენეთ ახალი secret.

Databricks secret-ს მხოლოდ ერთხელ აჩვენებს. მოეპყარით მას როგორც credential-ს და არ ჩართოთ ეკრანის ანაბეჭდებში, tickets-ში, კომენტარებში ან ჩატებში.

დაასრულეთ დაყენება ChatGPT-ში

1. დაბრუნდით ChatGPT-ის შაბლონის დაყენების ჩანართზე.

2. ჩასვით Databricks Client ID OAuth client ID-ში.

3. ჩასვით Databricks Client secret OAuth client secret-ში.

4. Scopes უცვლელად დატოვეთ, თუ განზრახ არ გჭირდებათ შაბლონის ნაგულისხმევი მნიშვნელობების გადაფარვა.

5. შეავსეთ Databricks პროვაიდერის ყველა ველი, რომელსაც დაყენების პროცესი მოითხოვს, როგორიცაა workspace host, account host, account ID, warehouse ან Databricks-ისთვის სპეციფიკური სხვა მნიშვნელობები.

6. შექმენით შავი აპი.

აპის ტესტირება მომხმარებლის როლით

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

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

3. დაამტკიცეთ მოთხოვნილი scope-ები.

4. შეამოწმეთ, რომ ბრაუზერი ბრუნდება ChatGPT-ში და აპი დაკავშირებულად ჩანს.

5. ჯერ გაუშვით დაბალი რისკის წაკითხვის მოქმედება, მაგალითად მიმდინარე მომხმარებლის ინფორმაციის მიღება ან დამტკიცებული Databricks SQL რესურსის გამოკითხვა.

6. თუ ჩართულია ჩაწერის მოქმედებები, ფართო გაშვებამდე შეამოწმეთ აშკარად დაბალი რისკის Databricks სამუშაო პროცესით.

წვდომის მართვა

წვდომის კონტროლში მონაწილეობს როგორც Databricks, ისე ChatGPT.

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

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

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

• Redirect URI-ის შეუსაბამობა: დაადასტურეთ, რომ Databricks Redirect URL ზუსტად ემთხვევა ChatGPT-ში ნაჩვენებ callback URL-ს, მათ შორის path-სა და callback ID-ს.

• Secret აკლია: Databricks secret-ები ერთჯერადად ჩანს. თუ არ დაკოპირდა, შექმენით ახალი client secret.

• OAuth აპი დაუყოვნებლივ ხელმისაწვდომი არ არის: Databricks ამბობს, რომ OAuth აპლიკაციის განახლებების დამუშავებას შეიძლება 30 წუთამდე დასჭირდეს.

• არასაკმარისი scope: თუ ChatGPT ავთენტიფიკაციას ახერხებს, მაგრამ Databricks API გამოძახებები ვერ სრულდება, დაადასტურეთ, რომ Databricks აპს აქვს ALL APIs, როცა აპს non-SQL API-ები სჭირდება.

• SQL მოქმედებები ვერ სრულდება: დაადასტურეთ SQL scope, warehouse-ის კონფიგურაცია და Databricks-ის ნებართვები.

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

• მომხმარებლები ვერ უკავშირდებიან: დაადასტურეთ, რომ მომხმარებელს აქვს Databricks-ზე წვდომა და ნებადართული აქვს OAuth აპის ავტორიზაცია.

წყაროები

• Databricks-ის დოკუმენტაცია: ავთენტიფიკაცია OAuth user-to-machine-ით

• Databricks-ის დოკუმენტაცია: OAuth აპის კავშირების მართვა