Jifunze kudhibiti ufikiaji wa tovuti za SharePoint na kuondoa faili zinazotumika zenye lebo za unyeti zilizochaguliwa katika ChatGPT.

Muhtasari

Wasimamizi wa eneokazi wanaweza kutumia vidhibiti vya SharePoint kuruhusu mikusanyiko ya tovuti iliyoidhinishwa, kuzuia mikusanyiko ya tovuti iliyochaguliwa na kuondoa faili zinazotumika zenye lebo za unyeti za Microsoft Purview zilizochaguliwa.

Mkusanyiko wa tovuti wa SharePoint, unaoitwa pia SPSite, unaweza kuwa na tovuti nyingi. Kanuni ya mkusanyiko inahusu mkusanyiko mzima, kwa kuzingatia ruhusa za Microsoft ambazo kila mtumiaji tayari anazo. Haimpi mtumiaji ufikiaji wa maudhui ambayo hawezi kufikia katika Microsoft 365.

Vizuizi vya tovuti vinahusu utafutaji, kuvinjari, urejeshaji wa faili na vitendo vya kusoma/kuandika vinavyotumika katika SharePoint. Ufikiaji wa OneDrive hudhibitiwa kando.

Chagua hali ya ufikiaji inayolingana na sera yako:

Tovuti zinazoruhusiwa: Orodha ya tovuti zinazoruhusiwa ikiwa si tupu, watumiaji wanaweza kufikia kupitia programu mikusanyiko ya tovuti iliyoorodheshwa pekee.
Tovuti zilizozuiwa: Watumiaji wanaweza kufikia mikusanyiko ya tovuti ambayo haipo kwenye orodha ya iliyozuiwa, kwa kuzingatia ruhusa zao za Microsoft.

Orodha moja pekee ndiyo inayoweza kuwa na vipengee kwa wakati mmoja. Orodha tupu ya tovuti zinazoruhusiwa haizuii tovuti zote. Orodha zote mbili zikiwa tupu, vizuizi vya tovuti za SharePoint huondolewa; ruhusa za Microsoft na vidhibiti vingine vilivyosanidiwa vinaendelea kutumika.

Upatikanaji

Vidhibiti na API ya usimamizi ya eneokazi vinahitaji kuwezeshwa kwa eneokazi lako. Vidhibiti vinavyopatikana ni pamoja na orodha za mikusanyiko ya tovuti inayoruhusiwa, orodha za mikusanyiko ya tovuti iliyozuiwa, uagizaji wa tovuti kwa CSV na uondoaji wa faili kwa lebo za unyeti.

Kanuni zinahusu mikusanyiko mizima ya tovuti. Vidhibiti hivi vya mikusanyiko ya tovuti havijumuishi kudhibiti tovuti, folda au faili mahususi wala kutekeleza Microsoft Sites.Selected.

Kabla ya kuanza

Tambua mikusanyiko ya tovuti ambayo shirika lako linataka kuruhusu au kuzuia.
Pata GUID ya kila mkusanyiko. Kitambulisho kamili cha tovuti cha Microsoft Graph kina GUID ya mkusanyiko kama thamani yake ya katikati. API ya usimamizi hutumia GUID za mikusanyiko; zana ya kuagiza CSV kwenye kiolesura inaweza pia kuzitoa kwenye vitambulisho vya tovuti vya Graph vyenye sehemu tatu.
Wezesha ruhusa za Microsoft zinazohitajika na programu ya SharePoint katika mipangilio ya ruhusa ya ChatGPT na pia Microsoft Entra, ikijumuisha Sites.Read.All na Files.Read.All. Vidhibiti hivi huchuja ufikiaji upande wa OpenAI; havichukui nafasi ya ruhusa zilizokasimiwa za Microsoft.
Ili kuondoa faili kwa lebo za unyeti, mwombe msimamizi wako wa Microsoft 365 au Purview akupe GUID isiyobadilika ya kila lebo isiyo na usimbaji fiche.
Kwa usimamizi kupitia API, pata UUID ya eneokazi lako, ufunguo wa msimamizi wa eneokazi la ChatGPT na tokeni ya Microsoft Graph ikiwa unahitaji kutafuta vitambulisho vya URL za SharePoint. Vitambulisho hivyo viwili vya uthibitishaji vina madhumuni tofauti.

Kuhusu OpenAI Cookbook

OpenAI Cookbook ni mkusanyiko wa OpenAI wa misimbo ya mfano na miongozo inayopatikana kwa umma. Makala hii hutumia mwongozo wake wa ufikiaji wa tovuti za SharePoint na hati yake ya usimamizi ya Python, ambazo zote zimehifadhiwa kwenye GitHub. Unaweza kufungua viungo hivi kwenye kivinjari chako ili kusoma faili. Ili kuendesha hati, ipakue na ufuate maagizo ya usanidi na amri yaliyo kwenye mwongozo.

Katika makala hii yote, “Cookbook” inarejelea mwongozo huo wa SharePoint, na “zana ya Cookbook” inarejelea hati ya Python iliyounganishwa. Tumia marejeleo haya kwa mifano ya amri na udhibiti wa orodha ya tovuti zinazoruhusiwa kupitia API.

Sanidi vitambulisho vya uthibitishaji kwa usimamizi kupitia API

Kumbuka: Lazima uwe msimamizi wa eneokazi ili uweze kuunda funguo za msimamizi. Soma zaidi.

Unda ufunguo wa msimamizi wa eneokazi la ChatGPT

Fungua dashibodi ya usimamizi ya ChatGPT na uchague eneokazi lililokusudiwa.
Nenda kwenye Vitambulisho vya uthibitishaji na uchague Funguo za msimamizi.
Unda ufunguo wenye ruhusa Zenye mipaka na uweke Programu kuwa Kuandika.
Hifadhi ufunguo kwa usalama. Ufunguo huu unaruhusu kusoma na kubadilisha sera ya SharePoint ya eneokazi lako.

Ruhusa inayohitajika ni chatgpt.enterprise.apps.write. Kumbuka kuwa ufunguo wa Jukwaa la API na tokeni ya Microsoft Graph haviwezi kutumika badala ya ufunguo wa msimamizi wa eneokazi la ChatGPT.

Kwa maelezo zaidi, angalia: Kudhibiti funguo za msimamizi kwenye kichupo cha Vitambulisho vya uthibitishaji. Kwa vigeu vya mazingira vya vitambulisho vya uthibitishaji vya hati na mfano wa kuviingiza kwa usalama, angalia maagizo ya vitambulisho vya uthibitishaji ya Cookbook.

Pata tokeni ya Microsoft Graph

Tumia mchakato wa uthibitishaji wa Microsoft ulioidhinishwa na shirika lako. Kwa utafutaji shirikishi, ikiwa shirika lako linaruhusu Graph Explorer:

Fungua Microsoft Graph Explorer na uingie kwa akaunti ya kazi katika mazingira ya shirika yenye tovuti za SharePoint.
Chagua ruhusa zinazohitajika kusoma tovuti, kwa kawaida Sites.Read.All, kwa kutumia Badilisha ruhusa au Idhinisha ruhusa. Mwombe msimamizi wako wa Microsoft aidhinishe ufikiaji ikiwa shirika lako linahitaji hivyo.
Fungua kichupo cha Tokeni ya ufikiaji na unakili tokeni ya kutumia kwenye Microsoft Graph.

Kwa maagizo ya Microsoft, angalia Tumia Graph Explorer.

Tokeni ya Graph hutumika kupata vitambulisho vinavyolingana na URL za SharePoint. Ufunguo wa msimamizi wa ChatGPT husoma au kusasisha sera ya ChatGPT. Zana ya Cookbook inahitaji tokeni ya Graph kwa amri zinazotafuta vitambulisho vya URL pekee; kusoma au kufuta yaliyomo yote kwenye orodha iliyopo ya tovuti zinazoruhusiwa kunahitaji ufunguo wa msimamizi wa ChatGPT pekee.

Usiweke kitambulisho chochote kati ya hivyo kwenye mfumo wa udhibiti wa matoleo ya msimbo, hati zinazoshirikiwa, picha za skrini au kumbukumbu za mfumo.

Tafuta GUID ya mkusanyiko wa tovuti

Tumia URL ya tovuti ya SharePoint

Fungua tovuti ya SharePoint ukiwa umeingia kwenye Microsoft kwa akaunti yenye ruhusa ya kuifikia.
Ongeza /_api/site/id mwishoni mwa URL ya tovuti. Kwa mfano, tumia https://contoso.sharepoint.com/sites/Finance/_api/site/id.
Nakili GUID iliyorejeshwa kwenye jibu.

Kumbuka: Vikoa na vitambulisho vya mfano katika makala hii ni vya kuonyesha tu.

Tumia Microsoft Graph

Microsoft Graph hurejesha kitambulisho cha tovuti chenye sehemu tatu zilizotenganishwa kwa koma: jina la seva, GUID ya mkusanyiko wa tovuti na GUID ya tovuti. Tumia thamani ya katikati kwa kanuni ya mkusanyiko wa tovuti. URL tofauti za tovuti zinaweza kuelekeza kwenye GUID ileile ya mkusanyiko.

Kwa mifano ya utafutaji na vitambulisho, angalia Elewa vitambulisho vya tovuti za SharePoint. Ili kupata vitambulisho vya URL nyingi bila kubadilisha sera ya ChatGPT, tumia maagizo ya ukaguzi ya Cookbook na hati ya usimamizi ya Python.

Kwa mahitaji ya utafutaji ya Microsoft, angalia Pata tovuti ya SharePoint kwa kutumia njia yake.

Dhibiti mikusanyiko ya tovuti inayoruhusiwa na iliyozuiwa

Tumia vidhibiti vya eneokazi

Fungua Vidhibiti vya Usalama na Ulinzi vya programu ya SharePoint katika eneokazi lako.
Chini ya Hali ya ufikiaji, chagua Tovuti zinazoruhusiwa au Tovuti zilizozuiwa.
Ongeza mikusanyiko ya tovuti kwenye orodha iliyochaguliwa. Unaweza pia kutumia upakiaji wa CSV ulioelezwa hapa chini.
Hakiki mabadiliko yako na uchague Hifadhi.
Kagua sera iliyohifadhiwa na ujaribu usanidi wako.

Tovuti zilizoongezwa kupitia API ya usimamizi huonekana kwenye vidhibiti vya eneokazi. Tovuti zilizoongezwa kwenye kiolesura pia zinapatikana kupitia API. Unaweza kuongeza au kuondoa vipengee kupitia kiolesura au API; njia iliyotumika kuongeza tovuti haikulazimishi kuendelea kuitumia kwa tovuti hiyo.

Badilisha kati ya tovuti zinazoruhusiwa na zilizozuiwa

Orodha moja pekee ndiyo inayoweza kuwa na vipengee kwa wakati mmoja. Kabla ya kuongeza vipengee katika hali nyingine, futa yaliyomo yote kwenye orodha iliyopo na uhifadhi mabadiliko hayo. Kisha chagua hali nyingine, ongeza mikusanyiko iliyokusudiwa na uhifadhi tena.

Kufuta yaliyomo yote kwenye orodha inayotumika hubadilisha ufikiaji mara tu unapohifadhi. Kufuta yaliyomo yote kwenye orodha ya tovuti zinazoruhusiwa huondoa kizuizi chake cha tovuti; kufanya hivyo kwenye orodha ya tovuti zilizozuiwa huondoa vizuizi vyake. Panga mabadiliko haya pamoja na wasimamizi wengine kwa sababu muda kati ya kufuta yaliyomo kwenye orodha moja na kuhifadhi nyingine unaweza kuruhusu ufikiaji ambao sera yako ya mwisho itazuia.

Pakia mikusanyiko ya tovuti kutoka kwa CSV

Upakiaji wa CSV unakubali mikusanyiko ya tovuti pekee. Ili kuondoa faili kulingana na lebo ya unyeti, ongeza GUID za lebo chini ya Lebo za unyeti zisizo na usimbaji fiche za kuondoa faili.

Fungua Vidhibiti vya Usalama na Ulinzi na uchague Hali ya ufikiaji iliyokusudiwa.
Andaa CSV yenye GUID za mikusanyiko ya tovuti au vitambulisho vya tovuti vya Microsoft Graph vyenye sehemu tatu. Tumia umbizo moja la vitambulisho katika faili nzima.
Chagua Pakia faili ya CSV kisha uchague faili.
Hakiki matokeo ya uagizaji na orodha iliyochaguliwa. Rekebisha hitilafu au maonyo yoyote ya safu mlalo kabla ya kuendelea.
Chagua Hifadhi ili kutekeleza mabadiliko, kisha kagua orodha iliyohifadhiwa.

Mahitaji na namna CSV inavyofanya kazi:

Ukubwa wa juu wa faili: 1 MB.
Vichwa vya safu ni vya hiari.
Tumia GUID moja ya mkusanyiko kwa kila safu mlalo, au vitambulisho vya tovuti vya Graph vyenye sehemu tatu. Sehemu hizo tatu zinaweza kuwekwa ndani ya alama za kunukuu katika sehemu moja ya data au kugawanywa katika safu wima tatu.
Vitambulisho vya Graph vyenye sehemu tatu hubadilishwa kuwa GUID za mikusanyiko. Kuagiza kitambulisho chenye sehemu tatu hakuundi kanuni ya tovuti mahususi.
Uagizaji huongeza vipengee kwenye orodha iliyochaguliwa na kuhifadhi vilivyopo. Nakala za mikusanyiko inayojirudia huondolewa; idadi ya uagizaji huonyesha mikusanyiko mipya iliyoongezwa.
Miundo iliyochanganywa na safu mlalo zenye umbizo lisilo sahihi hukataliwa. Upakiaji ulio na URL za tovuti pekee huonyesha onyo na hauongezi tovuti. Kwanza tafuta GUID za mikusanyiko zinazolingana na URL.
Upakiaji hubadilisha rasimu ya orodha pekee. Hausasishi ufikiaji wa eneokazi hadi uchague Hifadhi.
Upakiaji wa CSV ulioelezwa hapa hudhibiti mikusanyiko ya tovuti. Sanidi uondoaji wa faili kwa lebo za unyeti kando.

Ikiwa una CSV yenye URL za SharePoint, mtiririko wa kazi wa CSV wa zana ya Cookbook unaweza kutafuta vitambulisho vyake na kudhibiti orodha ya tovuti zinazoruhusiwa kupitia API. Ingizo lake la site_url au url lina umbizo na mtiririko wa kazi tofauti na upakiaji wa vitambulisho kwenye kiolesura.

Elewa vikomo vya sera na maombi

Kikomo cha chaguomsingi cha sera ni mikusanyiko 10,000 ya tovuti. Vikomo vya juu zaidi vya sera ya eneokazi, hadi mikusanyiko 120,000 ya tovuti, vinahitaji kuwezeshwa na OpenAI; wasiliana na timu yako ya OpenAI kabla ya kupanga utekelezaji mkubwa zaidi.

Maombi binafsi ya mabadiliko ya API na hati ya sasa ya Cookbook hukubali hadi GUID 10,000 za mikusanyiko kwa kila ombi. Kikomo cha juu zaidi cha sera ya eneokazi hakiongezi kikomo hiki cha kila ombi. Hesabu mikusanyiko ya tovuti isiyojirudia, si URL za chanzo: URL nyingi zinaweza kurejelea mkusanyiko mmoja.

Tumia API ya usimamizi ya eneokazi

Tumia UUID ya eneokazi lako na ufunguo wa msimamizi wa eneokazi la ChatGPT kwenye https://api.chatgpt.com.

Kwa amri na mifano ya maombi ya orodha ya tovuti zinazoruhusiwa inayosasishwa, tumia Cookbook:

Soma orodha iliyopo ya tovuti zinazoruhusiwa.
Hakiki na uongeze mikusanyiko ya tovuti. Kuongeza mikusanyiko hakubadilishi mikusanyiko iliyopo inayoruhusiwa.
Ondoa mkusanyiko wa tovuti.
Futa yaliyomo yote kwenye orodha ya tovuti zinazoruhusiwa.

Hakiki sera ya sasa kabla ya kufanya mabadiliko, kisha uisome tena na ujaribu ufikiaji unaotokana nayo. Kuondoa mkusanyiko wa mwisho unaoruhusiwa au kufuta yaliyomo yote kwenye orodha ya tovuti zinazoruhusiwa huondoa kizuizi hicho cha tovuti. Usitume ombi tupu la kuongeza isipokuwa unakusudia kuondoa vizuizi vya orodha ya tovuti zinazoruhusiwa.

Zana ya Cookbook inayopatikana kwa umma kwa sasa hudhibiti orodha za tovuti zinazoruhusiwa pekee. Haidhibiti orodha za tovuti zilizozuiwa wala uondoaji wa faili kwa lebo za unyeti. Tumia vidhibiti vya eneokazi vilivyoelezwa hapo juu kwa kazi hizo.

Ondoa faili zenye lebo za unyeti

Tafuta GUID ya lebo

Mwombe msimamizi wako wa Microsoft 365 au Purview akupe GUID isiyobadilika ya lebo iliyokusudiwa. Tumia GUID, si jina lake la kuonyesha.

Msimamizi anaweza kuorodhesha lebo kupitia Microsoft Graph. Tokeni inahitaji ruhusa husika ya SensitivityLabel.Read au SensitivityLabels.Read.All. Linganisha jina la lebo iliyokusudiwa na kitambulisho chake na ukague mipangilio yake ya ulinzi.

Kwa mahitaji na mifano, angalia Orodhesha lebo za unyeti na Sifa za lebo ya unyeti. Ruhusa hizi za lebo ni tofauti na ruhusa ya kusoma tovuti inayotumika kutafuta vitambulisho vya URL za SharePoint.

Ongeza lebo za kuondoa faili

Fungua Vidhibiti vya Usalama na Ulinzi vya programu ya SharePoint.
Weka GUID ya kila lebo isiyo na usimbaji fiche chini ya Lebo za unyeti zisizo na usimbaji fiche za kuondoa faili.
Hifadhi usanidi na ujaribu faili inayotumika yenye lebo ya kuondoa faili.

Faili zenye lebo zinazotumika zinazolingana huondolewa kwenye matokeo ya programu ya SharePoint. Faili zenye lebo zinazoweka usimbaji fiche tayari huondolewa kwa chaguomsingi.

Jaribu usanidi wako

Tumia faili za majaribio na akaunti zilizoidhinishwa na shirika lako. Kabla ya kujaribu, thibitisha kuwa akaunti hiyo hiyo ya Microsoft inaweza kufikia kila faili moja kwa moja katika SharePoint.

Katika hali ya Tovuti zinazoruhusiwa yenye orodha isiyo tupu, kagua faili iliyo katika mkusanyiko unaoruhusiwa na faili iliyo katika mkusanyiko ambao haujaorodheshwa. Mkusanyiko unaoruhusiwa pekee ndio unapaswa kufikiwa kupitia programu.
Katika hali ya Tovuti zilizozuiwa, kagua faili iliyo katika mkusanyiko uliozuiwa na faili iliyo katika mkusanyiko ambao haujazuiwa. Mkusanyiko uliozuiwa haupaswi kupatikana; mkusanyiko ambao haujazuiwa unaendelea kutegemea ruhusa za Microsoft na vidhibiti vingine.
Kagua faili ya majaribio inayotumika yenye lebo ya unyeti ya kuondoa faili. Haipaswi kuonekana kwenye matokeo ya programu.
Baada ya mabadiliko kupitia API, linganisha orodha iliyohifadhiwa kwenye kiolesura na sera iliyorejeshwa na API.
Baada ya kupakia CSV, hifadhi mabadiliko na ufungue tena vidhibiti ili kuthibitisha kuwa mikusanyiko iliyokusudiwa imehifadhiwa.

Ikiwa matokeo yanatofautiana na sera iliyokusudiwa, kagua eneokazi, hali ya ufikiaji iliyochaguliwa, orodha iliyohifadhiwa, GUID za mikusanyiko, GUID za lebo, aina ya faili inayotumika na ruhusa za Microsoft za mtumiaji. Usifute yaliyomo yote kwenye orodha kama hatua ya kutatua tatizo isipokuwa unakusudia mabadiliko ya ufikiaji yatakayotokea.

Kwa usaidizi kuhusu vidhibiti visivyopatikana au ufikiaji usiotarajiwa, angalia: Kuwasiliana na Usaidizi wa OpenAI. Usijumuishe funguo za msimamizi au tokeni za Microsoft Graph katika ombi lako la usaidizi.

Elewa mipaka

Kanuni ya mkusanyiko inahusu mkusanyiko mzima wa tovuti. Haiwezi kudhibiti ufikiaji wa tovuti ndogo, folda au faili mahususi.
Vizuizi vya tovuti za SharePoint havizuii kiotomatiki ufikiaji wa OneDrive.
Uchujaji kwa lebo za unyeti hufanya kazi tu pale Microsoft Graph inapotoa metadata ya lebo zinazotumika, ikijumuisha hati za Office, PDF na faili za MP4 zinazotumika.
Aina za faili zisizotumia lebo za unyeti, kama vile TXT na CSV, huchukuliwa kuwa hazina lebo. Zinaendelea kufikiwa ikiwa ruhusa nyingine zinaruhusu. Kizuizi hiki cha aina ya faili hakihusiani na kupakia CSV ili kusanidi ufikiaji wa tovuti.
Upakiaji wa CSV na zana ya mfano inayopatikana kwa umma havisanidi uondoaji wa faili kwa lebo za unyeti. Makala hii haielezi API ya kudhibiti lebo kwa wingi.
Sera iliyohifadhiwa au jibu la API linaloonyesha mafanikio haliondoi hitaji la kujaribu ufikiaji kwa akaunti iliyokusudiwa.

Tumia zana ya usimamizi ya Python

Msimbo kamili wa mfano na amri huhifadhiwa na kusasishwa katika OpenAI Cookbook:

Tumia Python 3.10 au toleo jipya zaidi. Zana hii hutumia maktaba ya kawaida ya Python. Soma mwongozo kabla ya kuiendesha na uhakiki mabadiliko kwa majaribio yasiyotekeleza mabadiliko halisi.

Zana ya sasa husoma vitambulisho vya uthibitishaji kutoka kwa vigeu vya mazingira; tumia maagizo ya mwongozo ya kuviingiza kwa usalama. Inahitaji uthibitisho wa wazi ili kufuta yaliyomo yote kwenye orodha ya tovuti zinazoruhusiwa. Uondoaji unaweza kutekelezwa bila uthibitisho huo, kwa hivyo uhakiki kwanza kwa jaribio lisilotekeleza mabadiliko halisi.

Kwa maelezo kuhusu kujaribu tena na funguo za hiari za kuzuia utekelezaji unaorudiwa, angalia Jaribu tena kusasisha sera kwa usalama. Tumia funguo za kuzuia utekelezaji unaorudiwa tu ikiwa eneokazi linazikubali, na ukague sera ya sasa baada ya hitilafu yenye matokeo yasiyo wazi.

Zana hii haiwashi vipengele vya eneokazi wala kuthibitisha utekelezaji wa sera. Majaribio yake ya nje ya mtandao hutumia miito ya kuigiza ya Microsoft Graph na API ya usimamizi ya ChatGPT.

Mabadiliko yanayohusisha maombi mengi hayatekelezwi kama kitendo kimoja kisichogawanyika. Ikiwa uondoaji wa mikusanyiko mingi utashindwa katikati, baadhi ya mikusanyiko ya awali inaweza kuwa tayari imeondolewa. Soma sera ya sasa kabla ya kujaribu tena.

Maswali yanayoulizwa mara kwa mara

Je, vidhibiti vya tovuti vinachukua nafasi ya ruhusa za Microsoft?

Hapana. Programu inaendelea kutumia ruhusa za Microsoft za kila mtumiaji. OpenAI hutekeleza uchujaji wa tovuti uliosanidiwa kabla ya majibu kuonyeshwa kwa mtumiaji na muundo.

Je, orodha tupu ya tovuti zinazoruhusiwa huzuia tovuti zote?

Hapana. Orodha tupu ya tovuti zinazoruhusiwa haimaanishi “zuia zote.” Ikiwa orodha ya tovuti zilizozuiwa ina vipengee, mikusanyiko hiyo inaendelea kuzuiwa. Orodha zote mbili zikiwa hazina vipengee, ruhusa za Microsoft za watumiaji na vidhibiti vingine vilivyosanidiwa huamua ufikiaji.

Je, mabadiliko ya API ya usimamizi hurekodiwa?

Mabadiliko ya sera kupitia API ya usimamizi hurekodiwa katika kumbukumbu za ukaguzi na uzingatiaji za eneokazi.

Kudhibiti ufikiaji wa tovuti za SharePoint na uondoaji wa faili kwa lebo za unyeti