అవలోకనం

మీ సంస్థ కోసం GitHub Enterprise యాప్ టెంప్లేట్‌ను సెటప్ చేస్తున్న ChatGPT వర్క్‌స్పేస్ అడ్మిన్ అయితే ఈ గైడ్‌ను ఉపయోగించండి. టెంప్లేట్ అనేది సభ్యులు ఉపయోగించే తుది యాప్ కాదు. మీరు అవసరమైన GitHub Enterprise కాన్ఫిగరేషన్ అందించిన తర్వాత, అది వర్క్‌స్పేస్-నిర్దిష్ట డ్రాఫ్ట్ యాప్‌ను సృష్టించే సెటప్ ఫ్లో.

GitHub Enterprise కోసం, సెటప్ ChatGPTను మీ సంస్థ యొక్క GitHub Enterprise హోస్ట్కు కనెక్ట్ చేస్తుంది. మీరు GitHub Appను సృష్టించి, ChatGPT కాల్‌బ్యాక్ URLను నమోదు చేసి, క్రెడెన్షియల్‌లను రూపొందించి, ఆ విలువలను ChatGPT టెంప్లేట్ సెటప్ ఫ్లోలో పేస్ట్ చేస్తారు. ChatGPT డ్రాఫ్ట్ యాప్‌ను సృష్టించిన తర్వాత, దాన్ని ప్రచురించి ఇతర వర్క్‌స్పేస్ యాప్‌ల మాదిరిగా నిర్వహించవచ్చు.

మీరు సెటప్ చేస్తున్నది

మీరు ChatGPTలో వర్క్‌స్పేస్-నిర్దిష్ట GitHub Enterprise యాప్‌ను సృష్టిస్తున్నారు. యాప్ ఇవి ఉపయోగిస్తుంది:

• మీ GitHub Enterprise హోస్ట్‌లో నమోదు చేసిన GitHub App.

• వినియోగదారు OAuth అధికారం కోసం GitHub App client ID మరియు client secret.

• రిపోజిటరీ ఆపరేషన్‌ల కోసం ChatGPT ఇన్‌స్టాలేషన్ టోకెన్‌లను సృష్టించగలిగేలా GitHub App ప్రైవేట్ కీ.

• GitHub Enterprise ఇన్‌స్టాలేషన్ మరియు రిపోజిటరీ ఈవెంట్‌లను ChatGPTకు తిరిగి పంపగలిగేలా webhook secret మరియు webhook URL.

• github.example.com వంటి మీ GitHub Enterprise హోస్ట్‌నేమ్.

స్వతంత్ర GitHub OAuth App కాకుండా, GitHub Appను సృష్టించండి. ChatGPT టెంప్లేట్ సెటప్‌కు GitHub App క్రెడెన్షియల్‌లు, ప్రైవేట్ కీ మరియు webhook సెట్టింగ్‌లు అవసరం.

మీరు ప్రారంభించే ముందు

మీకు ఇవి అవసరం:

• ChatGPT వర్క్‌స్పేస్ అడ్మిన్ లేదా యజమాని యాక్సెస్.

• GitHub Appsను సృష్టించి ఇన్‌స్టాల్ చేయగల GitHub Enterprise అడ్మిన్ లేదా సంస్థ-యజమాని యాక్సెస్.

• https:// లేదా పాత్ లేకుండా, GitHub Enterprise హోస్ట్‌నేమ్ మాత్రమే.

• చదవడానికి మాత్రమే రిపోజిటరీ శోధన, పుల్ రిక్వెస్ట్ వర్క్‌ఫ్లోలు, ఇష్యూ వర్క్‌ఫ్లోలు, ఫైల్ సవరణలు, GitHub Actions లేదా విస్తృత Codex వర్క్‌ఫ్లోలు వంటి ఏ రిపోజిటరీ చర్యలకు ChatGPT మద్దతు ఇవ్వాలి అనే నిర్ణయం.

• GitHub App ప్రైవేట్ కీ మరియు client secretను నిర్వహించడానికి సురక్షిత స్థలం.

ChatGPT మరియు GitHub Enterpriseను వేర్వేరు ట్యాబ్‌లలో తెరిచి ఉంచండి. కాల్‌బ్యాక్ URLను ఊహించి సృష్టించవద్దు. ChatGPTలో చూపిన ఖచ్చితమైన కాల్‌బ్యాక్ URLను కాపీ చేయండి.

సిద్ధం చేయాల్సిన విలువలు

• GitHub Enterprise హోస్ట్‌నేమ్: ఉదాహరణకు, github.example.com.

• కాల్‌బ్యాక్ URL: దీన్ని ChatGPT టెంప్లేట్ సెటప్ ఫ్లో నుండి కాపీ చేయండి.

• GitHub App client ID.

• GitHub App client secret.

• GitHub App private key PEM.

• ChatGPT రూపొందించిన webhook secret.

• ChatGPTలో డ్రాఫ్ట్ యాప్ సృష్టించిన తర్వాత రూపొందించిన webhook URL.

ChatGPTలో టెంప్లేట్ సెటప్‌ను ప్రారంభించండి

1. ChatGPTలో, యాప్ అందుబాటులో ఉండాల్సిన వర్క్‌స్పేస్‌కు మారండి.

2. వర్క్‌స్పేస్ సెట్టింగ్‌లు > యాప్‌లు తెరవండి.

3. డైరెక్టరీని ఎంచుకోండి.

4. GitHub Enterprise కోసం వెతకండి.

5. GitHub Enterprise యాప్ టెంప్లేట్‌ను ఎంచుకుని సెటప్ ప్రారంభించండి.

6. GitHub Enterprise లేదా GitHub Enterprise - Engineering వంటి స్పష్టమైన యాప్ పేరు, వివరణను నమోదు చేయండి.

7. github.example.com వంటి GitHub Enterprise హోస్ట్‌నేమ్‌ను నమోదు చేయండి.

8. ChatGPTలో చూపిన కాల్‌బ్యాక్ URLను కాపీ చేయండి. ఈ ట్యాబ్‌ను తెరిచి ఉంచండి.

9. సెటప్ సమయంలో చూపితే, రూపొందించిన webhook secretను కాపీ చేయండి.

ఉదాహరణ కాల్‌బ్యాక్ URL: https://chatgpt.com/connector/oauth/<callback_id>

కాల్‌బ్యాక్ IDని తీసివేయవద్దు, చివర స్లాష్ జోడించవద్దు లేదా దాన్ని సాధారణ ChatGPT URLతో భర్తీ చేయవద్దు.

GitHub Enterpriseలో GitHub Appను సృష్టించండి

1. https://github.example.com వంటి మీ GitHub Enterprise హోస్ట్‌ను తెరవండి.

2. యాప్‌కు యజమానిగా ఉండాల్సిన సంస్థ లేదా ఖాతాకు వెళ్లండి.

3. Settings > Developer settings > GitHub Apps తెరవండి.

4. New GitHub App ఎంచుకోండి.

5. ChatGPT GitHub Enterprise Connector వంటి స్పష్టమైన యాప్ పేరును నమోదు చేయండి.

6. హోమ్‌పేజీ URLను నమోదు చేయండి. ప్రత్యేక అంతర్గత పేజీ లేకపోతే, GitHub Enterprise సంస్థ URLను ఉపయోగించండి.

7. Callback URLలో, ChatGPT నుండి కాపీ చేసిన ఖచ్చితమైన కాల్‌బ్యాక్ URLను పేస్ట్ చేయండి.

8. మీ భద్రతా బృందానికి మార్చడానికి నిర్దిష్ట కారణం లేకపోతే, Expire user authorization tokens ప్రారంభంగానే ఉంచండి.

9. ఇన్‌స్టాల్ లేదా కనెక్ట్ ఫ్లో సమయంలో వినియోగదారులు యాప్‌కు అధికారం ఇవ్వగలిగేలా Request user authorization during installationను ప్రారంభించండి.

10. Where can this GitHub App be installed? కింద, మీ రోలౌట్‌కు సరిపోయే అత్యంత పరిమిత ఎంపికను ఎంచుకోండి.

11. GitHub Appను సృష్టించండి.

అనుమతులు మరియు ఈవెంట్‌లను కాన్ఫిగర్ చేయండి

మీరు ప్రారంభించాలనుకునే ChatGPT చర్యలకు అవసరమైన కనీస అనుమతులను ఎంచుకోండి.

చదవడానికి మాత్రమే రిపోజిటరీ డిస్కవరీ మరియు Q&A కోసం, ఇలాంటి read అనుమతులతో ప్రారంభించండి:

• Metadata: చదవడానికి మాత్రమే. GitHub Apps కోసం GitHubకు మెటాడేటా అవసరం.

• Contents: ఫైల్ మరియు రిపోజిటరీ కంటెంట్ యాక్సెస్ కోసం, చదవడానికి మాత్రమే.

• Issues: ఇష్యూ శోధన లేదా ఇష్యూ చదవడం అవసరమైతే, చదవడానికి మాత్రమే.

• Pull requests: పుల్ రిక్వెస్ట్ శోధన లేదా సమీక్ష సందర్భం అవసరమైతే, చదవడానికి మాత్రమే.

• Actions: వర్క్‌ఫ్లో రన్ స్థితి, జాబ్‌లు, లాగ్‌లు లేదా ఆర్టిఫ్యాక్ట్‌లు అవసరమైతే, చదవడానికి మాత్రమే.

రైట్ వర్క్‌ఫ్లోల కోసం, Contents, Pull requests, Issues, Actions లేదా Workflows వంటి అవసరమైన చోట మాత్రమే రైట్ అనుమతులను జోడించండి. ఉద్దేశించిన ChatGPT చర్యలకు మద్దతు ఇచ్చే అత్యంత పరిమిత అనుమతులను ఉపయోగించండి.

Webhook ఈవెంట్‌లు మీరు మద్దతు ఇచ్చే వర్క్‌ఫ్లోలకు సరిపోవాలి. సాధారణ ఈవెంట్‌లలో Installation, Installation repositories, Push, Pull request, Issues, Issue comment, Workflow run మరియు Workflow job ఉంటాయి.

GitHub App క్రెడెన్షియల్‌లను రూపొందించి కాపీ చేయండి

1. GitHub App సెట్టింగ్‌లలో, Client IDని కాపీ చేయండి.

2. Client secretను రూపొందించి వెంటనే కాపీ చేయండి.

3. Private keys కింద, ప్రైవేట్ కీని రూపొందించండి.

4. .pem ఫైల్‌ను డౌన్‌లోడ్ చేసి సురక్షితంగా నిల్వ చేయండి.

5. .pem ఫైల్‌ను స్థానికంగా తెరిచి, ప్రారంభ మరియు ముగింపు పంక్తులతో సహా పూర్తి PEM టెక్స్ట్‌ను కాపీ చేయండి.

ప్రైవేట్ కీ సున్నితమైనది. దాన్ని క్రెడెన్షియల్‌లా పరిగణించండి. అది బహిర్గతమైతే, కొత్త ప్రైవేట్ కీని రూపొందించి, ChatGPT యాప్ సెటప్‌ను అప్‌డేట్ చేసి, GitHub Enterpriseలో రాజీపడిన కీని తొలగించండి.

ChatGPTలో సెటప్‌ను పూర్తి చేయండి

1. ChatGPT టెంప్లేట్ సెటప్ ట్యాబ్‌కు తిరిగి వెళ్లండి.

2. GitHub App Client IDని OAuth client IDలో పేస్ట్ చేయండి.

3. GitHub App Client secretను OAuth client secretలో పేస్ట్ చేయండి.

4. మీ సంస్థ ఉద్దేశపూర్వకంగా టెంప్లేట్ డిఫాల్ట్‌లను ఓవర్‌రైడ్ చేయాల్సి ఉంటే తప్ప Scopesను మార్చకుండా ఉంచండి.

5. GitHub Enterprise హోస్ట్‌నేమ్ github.example.com వంటి హోస్ట్‌నేమ్ మాత్రమే అని నిర్ధారించండి.

6. GitHub App private key PEMను GitHub App private keyలో పేస్ట్ చేయండి లేదా అప్‌లోడ్ చేయండి.

7. రూపొందించిన webhook secret ఉందని నిర్ధారించండి.

8. డ్రాఫ్ట్ యాప్‌ను సృష్టించండి.

9. ChatGPTలో సృష్టించిన డ్రాఫ్ట్ యాప్ వివరాలను తెరిచి, రూపొందించిన webhook URLను కాపీ చేయండి.

webhook URL ఇలా కనిపించాలి: https://connectors.api.openai.org/connectors/<connector_id>/webhook

GitHub Enterpriseలో webhook సెటప్‌ను పూర్తి చేయండి

1. GitHub Enterpriseలో GitHub App సెట్టింగ్‌లకు తిరిగి వెళ్లండి.

2. GitHub App General సెట్టింగ్‌లను తెరవండి.

3. Active webhooks ఇప్పటికే ప్రారంభించబడకపోతే వాటిని ప్రారంభించండి.

4. ChatGPT webhook URLను Webhook URLలో పేస్ట్ చేయండి.

5. ChatGPT webhook secretను Webhook secretలో పేస్ట్ చేయండి.

6. SSL ధృవీకరణను ప్రారంభంగానే ఉంచండి.

7. సబ్‌స్క్రైబ్ చేసిన webhook ఈవెంట్‌లు మీరు ప్రారంభించిన అనుమతులు మరియు చర్యలకు సరిపోతున్నాయని నిర్ధారించండి.

8. మార్పులను సేవ్ చేయండి.

ChatGPTలో యాప్‌ను ప్రచురించి నిర్వహించండి

డ్రాఫ్ట్ యాప్‌ను సృష్టించడం వల్ల అది సభ్యులకు స్వయంచాలకంగా అందుబాటులోకి రాదు. డ్రాఫ్ట్‌ను సమీక్షించిన తర్వాత:

1. డ్రాఫ్ట్ యాప్‌ను ప్రచురించండి.

2. యాప్ వర్క్‌స్పేస్ సెట్టింగ్‌లు > యాప్‌లు > ప్రారంభించబడినవిలో కనిపిస్తుందని నిర్ధారించండి.

3. దాన్ని ఉపయోగించాల్సిన పాత్రల కోసం వినియోగదారు యాక్సెస్ను కాన్ఫిగర్ చేయండి.

4. చదవడం మరియు రాయడం చర్యల కోసం చర్య నియంత్రణను సమీక్షించండి.

5. యాప్‌ను ఉపయోగించే ముందు ChatGPT సభ్యులను ఎప్పుడు అడగాలో ఎంచుకోవడానికి యాప్ అనుమతులును సమీక్షించండి.

6. అనుమతించబడిన పరీక్ష వినియోగదారుని ChatGPTలో యాప్‌లు తెరవమని, యాప్ కనిపిస్తుందో నిర్ధారించమని అడగండి.

ఈ యాప్ అనుమతులు ChatGPT సంభాషణలకు వర్తిస్తాయి. ఏ యాప్ చర్యలు అందుబాటులో ఉంటాయో, తుది వినియోగదారులను వాటిని ఆమోదించమని ఎప్పుడు అడగాలో నిర్ణయించడానికి వర్క్‌స్పేస్ ఏజెంట్‌లు ఏజెంట్ బిల్డర్ సెట్ చేసిన ప్రతి-ఏజెంట్ నియంత్రణలను ఉపయోగిస్తాయి. ఏజెంట్ ప్రవర్తన కోసం, చూడండి: Enterprise మరియు Business కోసం ChatGPT వర్క్‌స్పేస్ ఏజెంట్‌లు.

GitHub Appను ఇన్‌స్టాల్ చేసి పరీక్షించండి

1. GitHub Enterpriseలో, సంస్థ లేదా ఖాతాలో GitHub appను ఇన్‌స్టాల్ చేయండి.

2. వర్క్‌స్పేస్ విధానం ప్రకారం అన్ని రిపోజిటరీలు లేదా ఎంచుకున్న రిపోజిటరీలను ఎంచుకోండి.

3. అనుమతించబడిన వినియోగదారుగా ChatGPT నుండి కనెక్ట్ ఫ్లోను ప్రారంభించండి.

4. ప్రాంప్ట్ వచ్చినప్పుడు GitHub appకు అధికారం ఇవ్వండి.

5. మొదట యాక్సెస్ చేయగల రిపోజిటరీలను జాబితా చేయడం లేదా తెలిసిన పుల్ రిక్వెస్ట్‌ను పొందడం వంటి చిన్న read చర్యను అమలు చేయండి.

6. రైట్ చర్యలు ప్రారంభించబడి ఉంటే, విస్తృత రోలౌట్‌కు ముందు తక్కువ ప్రమాదం ఉన్న రిపోజిటరీతో పరీక్షించండి.

హోస్ట్‌నేమ్ మరియు OAuth ప్రవర్తన

GitHub Enterprise ఎండ్‌పాయింట్‌లను ఉత్పన్నం చేయడానికి ChatGPT హోస్ట్‌నేమ్‌ను ఉపయోగిస్తుంది. github.example.com లేదా octocorp.ghe.com వంటి హోస్ట్‌ను మాత్రమే నమోదు చేయండి.

ఈ యాప్‌కు ఖచ్చితమైన GitHub Enterprise హోస్ట్ అదే అయితే తప్ప, API పాత్, రిపోజిటరీ పాత్ లేదా github.com నమోదు చేయవద్దు.

ట్రబుల్‌షూటింగ్

• Redirect URI mismatch: GitHub App కాల్‌బ్యాక్ URL ChatGPTలో చూపిన కాల్‌బ్యాక్ URLతో ఖచ్చితంగా సరిపోతుందని నిర్ధారించండి.

• ChatGPT డ్రాఫ్ట్ యాప్‌ను సృష్టించలేకపోతోంది లేదా సేవ్ చేయలేకపోతోంది: హోస్ట్‌నేమ్, OAuth client ID, OAuth client secret, ప్రైవేట్ కీ మరియు webhook secret సహా అన్ని అవసరమైన ఫీల్డ్‌లు ఉన్నాయని నిర్ధారించండి.

• ప్రామాణీకరణ విజయవంతమైనా రిపోజిటరీ కాల్‌లు విఫలమవుతున్నాయి: GitHub App ఇన్‌స్టాల్ చేయబడిందని మరియు రిపోజిటరీకి యాక్సెస్ ఉందని నిర్ధారించండి.

• API 403 లేదా తగిన అనుమతులు లేవని చూపుతోంది: లేని GitHub App అనుమతిని జోడించండి మరియు ప్రాంప్ట్ వస్తే అప్‌డేట్ చేసిన అనుమతులను ఇన్‌స్టాలేషన్ యజమాని ఆమోదించేలా చేయండి.

• రిపోజిటరీలు కనిపించడం లేదు: యాప్ ఇన్‌స్టాలేషన్‌లో ఆశించిన రిపోజిటరీలు ఉన్నాయని మరియు ChatGPTలో అధికారం ఇస్తున్న వినియోగదారుకు వాటికి యాక్సెస్ ఉందని నిర్ధారించండి.

• Webhook డెలివరీలు విఫలమవుతున్నాయి: webhook URL మరియు webhook secret ChatGPTలోని విలువలతో సరిపోతున్నాయని నిర్ధారించండి, SSL ధృవీకరణను ప్రారంభంగా ఉంచండి, అలాగే GitHub Enterprise హోస్ట్ connectors.api.openai.orgను చేరగలదని నిర్ధారించండి.

• ప్రైవేట్ కీ లోపాలు: ప్రారంభ మరియు ముగింపు పంక్తులతో సహా పూర్తి PEM కంటెంట్ కాపీ చేయబడిందని నిర్ధారించండి.

సూచనలు

• GitHub డాక్స్: GitHub Appను నమోదు చేయడం

• GitHub డాక్స్: వినియోగదారు authorization callback URL గురించి

• GitHub డాక్స్: GitHub App కోసం అనుమతులను ఎంచుకోవడం

• GitHub డాక్స్: GitHub Appsతో webhooksను ఉపయోగించడం

• GitHub డాక్స్: GitHub Apps కోసం ప్రైవేట్ కీలను నిర్వహించడం