Difyn yhdistäminen Google Sheetsiin ja Google Driveen

Jos haluat tekoälyagenttiesi työskentelevän todellisten ja ajantasaisten tietojen kanssa, Yhdistä Dify Google Sheetsiin Se on yksi yksinkertaisimmista tavoista saavuttaa tämä. Laskentataulukko voi toimia pienenä tietovarastona, josta voi tehdä kyselyjä tuotteista, asiakkaista, tehtävistä tai muista sovelluksesi käyttämistä tietueista.

Tämä integraatio mahdollistaa Dify-työnkulun lukea eri alueita ja kirjoittaa uusia arvoja ilman manuaalista tietojen kopiointia. Voit esimerkiksi luoda ohjatun toiminnon, joka tarkistaa tilauksen tilan, luokittelee lomakkeen vastaukset tai päivittää taulukon pyynnön käsittelyn jälkeen.

Tähän on useita tapoja. Suorin reitti käyttää Google Sheets -laajennus ja Google Cloud -palvelutiliJos sinun on reagoitava muutoksiin automaattisesti, suoritettava ajoitettuja tehtäviä tai yhdistettävä taulukkolaskentaohjelma muiden sovellusten kanssa, voit käyttää myös välittäjäalustaa, kuten n8n.

Mitä tarvitset yhdistääksesi Difyn Google Sheetsiin

Ennen kuin aloitamme, on syytä selventää, että komplementti omluc/google_sheets Tämä Dify Marketplacessa saatavilla oleva yhteisölaajennus ei ole osa Dify-tiimin kehittämiä virallisia laajennuksia, vaikka sen voi asentaa heidän laajennuskauppapaikastaan.

Tämä laajennus sisältää tällä hetkellä kaksi päätyökalua:

• Erähaku: hakee tietoja yhdestä tai useammasta laskentataulukon alueesta.
• Eräpäivitys: päivittää useita alueita saman toiminnon sisällä.

Nämä funktiot voidaan lisätä työkaluiksi työnkulkuun tai asettaa agentin käyttöön tarpeen mukaan. Niiden määrittämiseen tarvitset:

• A Google-tili, jolla on pääsy Google Cloudiin.
• Un Google Cloudissa luotu projekti.
• La Google Sheets -sovellusliittymä käytössä.
• Palvelutili, jolla on avain JSON-muodossa.
• A jaettu taulukko kyseisen tilin sähköpostiosoitteella.

Palvelutili toimii erillisenä identiteettinä. Siksi Dify ei käytä suoraan henkilökohtaista Google-tiliäsi eikä se voi automaattisesti käyttää kaikkia laskentataulukoitasi. Sillä on pääsy vain niihin dokumentteihin, jotka jaat sen kanssa erikseen.

Palvelutilin luominen Google Cloudissa

Ensimmäinen vaihe on siirtyä Google Cloud Consoleen ja luoda uusi projekti tai valita olemassa oleva. Avaa projektissa API-rajapinnat ja palvelut -osio, siirry kirjastoon ja etsi... Google Sheets -sovellusliittymäNapauta sitten vaihtoehtoa ottaaksesi sen käyttöön.

Seuraavaksi, syötä IAM ja hallinta > Palvelutilit ja luo uusi tili. Voit antaa sille nimen, jonka avulla on helppo tunnistaa, mihin sitä käytetään, kuten "Dify Google Sheets".

Tämän prosessin aikana Google saattaa tarjota sinulle mahdollisuuden määrittää rooleja projektin sisällä. Tätä integraatiota varten sinun ei tarvitse määrittää yleistä omistajan tai muokkaajan roolia koko projektille. Tiettyjen taulukoiden käyttöoikeuksia hallitaan myöhemmin Google Sheetsin jakamisasetusten kautta.

Kun tili on luotu:

1. Avaa tietosi palvelutilit-osiosta.
2. Siirry välilehteen Avaimet.
3. Klikkaa Lisää avain > Luo uusi avain.
4. Valitse muoto JSON.
5. Lataa ja tallenna tiedosto turvallisessa paikassa.

JSON-tiedosto sisältää arkaluonteisia tietoja, mukaan lukien yksityisen avaimen. Et saa julkaista sitä, lähettää sitä sähköpostitse tai ladata sitä tietovarastoon. Kuka tahansa, joka saa avaimen haltuunsa, voi toimia palvelutilin käyttöoikeuksilla.

Kuinka asentaa ja määrittää laajennus Difyssä

Avaa Difyssä Plugin Marketplace ja etsi Google Sheets -lisäosa, jonka on julkaissut omlucTarkista tekijän nimi ennen asentamista, jotta et sekoita sitä muihin laajennuksiin, jotka saattavat tarjota eri toimintoja.

Asennuksen jälkeen avaa lisäosan tunnistetiedot. Lomake pyytää palvelutilin avainta. Avaa ladattu JSON-tiedosto tekstieditorilla. kopioi kaikki sen sisältö ja liitä se vastaavaan kenttään.

Älä kopioi erikseen vain sähköpostiosoitetta, projektitunnusta tai yksityistä avainta. Lisäosa vaatii koko JSON-rakenteen Google Sheetsiin tehtyjen pyyntöjen todentamiseen.

Tallenna seuraavaksi tunnistetiedot ja avaa haluamasi laskentataulukko. JSON-tiedostosta löydät kentän nimeltä client_email, jonka arvo näyttää tältä:

[email protected]

Klikkaa Jakaa Google Sheetsissä ja lisää kyseinen osoite aivan kuin se olisi toisen käyttäjän osoite:

• Myöntää luvan lukija jos Dify vain tutkii tietoja.
• Myöntää luvan toimittaja jos sinun on myös päivitettävä soluja.

Laskentataulukon jakamista julkisesti linkin kautta ei suositella. Palvelutilin avulla voit pitää asiakirjan yksityisenä ja rajoittaa sen käyttöoikeuden tietylle käyttäjälle.

Kuinka lukea tietoja Google Sheetsistä työnkulusta

Jos haluat hakea tietoja taulukosta, lisää työkalusolmu Dify-työnkulkuun ja valitse toiminto. ErähakuLisäosan avulla voit tehdä kyselyn useista alueista yhdellä toiminnolla, jolloin vältetään eri solmun luominen taulukon jokaiselle osalle.

Sinun on annettava laskentataulukon tunniste. Tämä näkyy sen verkko-osoitteessa, välissä /d/ y /editURL-osoitteessa, jossa on tämä rakenne:

https://docs.google.com/spreadsheets/d/IDENTIFICADOR/edit

Sinun on käytettävä vain arvoa, joka on merkitty tähdellä IDENTIFICADOR.

Sinun on myös määritettävä välilehden nimi ja alue Google Sheets -merkintäjärjestelmää käyttäen. Joitakin esimerkkejä:

Clientes!A2:D50
Productos!A:C
Pedidos!B2:B20

Huutomerkkiä edeltävä nimi vastaa sarkainta. Seuraavat kirjaimet ja numerot rajaavat noudettavat sarakkeet ja rivit.

Voit sitten välittää tuloksen LLM-solmulle sen yhteenvetoa, tietueen paikantamista tai vastauksen valmistelua varten. On suositeltavaa ohjeistaa mallia käyttämään vain noudettuja tietoja ja ilmoittaa selvästi, milloin se ei löydä osumaa, varsinkin jos taulukko sisältää asiakas-, varasto- tai tilaustietoja.

Solujen päivittäminen Difystä

Työkalu Eräpäivitys Sen avulla voit kirjoittaa arvoja eri alueille. Tätä voidaan käyttää esimerkiksi tehtävän tilan muuttamiseen, tekoälyn luoman luokituksen tallentamiseen tai pyynnön tuloksen lisäämiseen.

Ennen käyttöä varmista, että palvelutilillä on muokkausoikeudet dokumenttiin. Jos sillä on vain lukuoikeudet, kyselyt toimivat, mutta Google hylkää kirjoitusyritykset.

On myös suositeltavaa estää mallia valitsemasta vapaasti mitä tahansa aluetta tai arvoa. Turvallisempi kokoonpano koostuu seuraavista: Vahvista ensin tiedot, rajaa muokattavien sarakkeiden määrä ja rakenna alue käyttämällä kontrolloituja muuttujia. työnkulun kautta.

Voit esimerkiksi järjestää prosessin näin:

1. El käyttäjä syöttää tilausnumeron.
2. Erähaku palaa jonoon vastaava.
3. Ehdollinen solmu tarkista, onko tilaus olemassa.
4. Malli analysoi tai luokittelee tiedot.
5. Eräpäivitys kirjoittaa tuloksen tietyssä sarakkeessa.
6. Tulostussolmu vahvistaa, mitä tietuetta on muokattu.

Käytä asennuksen aikana aina kun mahdollista testitaulukkoa. Huonosti rakennettu päivitys voi korvata olemassa olevia tietoja, varsinkin jos alue kattaa aiottua enemmän rivejä tai sarakkeita.

Yleisiä virheitä Difyn ja Google Sheetsin yhdistämisessä

Jos kohtaat todennusvirheen, varmista, että olet liittänyt koko JSON-tiedoston ja että sen muotoa ei ole muutettu. Yksityiset avaimet sisältävät rivinvaihdot, jotka on säilytettävä dokumentin rakenteessa.

Kun Dify ilmoittaa, ettei se löydä tai pääse käsiksi taulukkoon, tarkista seuraavat kohdat:

• Google Sheets -sovellusliittymä on käytössä oikeassa projektissa.
• Taulukko on jaettu tarkalla arvolla client_email.
• Taulukon tunniste ei sisällä URL-osoitteen muita osia.
• Välilehden nimi täsmää, mukaan lukien isot kirjaimet, välilyönnit ja aksentit.
• Alue käyttää kelvollista merkintätapaa, kuten Datos!A2:C20.
• Tilillä on muokkausoikeudet, jos työnkulku yrittää kirjoittaa.

Jos olet poistanut tai deaktivoinut avaimen Google Cloudissa, sinun on luotava uusi ja korvattava Difyyn tallennetut tunnistetiedot. Sinun tulisi myös luoda uusi avain, jos epäilet, että JSON-tiedosto on vaarantunut.

Google Sheetsin ja Google Driven laajennusten erot

Google Sheetsiä ja Google Drivea ei tule käsitellä yhtenä integraationa. Sheets-yhteisölaajennus on tarkoitettu käytettäväksi tarkastella ja muokata solualueita palvelutilin kautta.

Virallinen Google Drive -laajennus, joka on saatavilla tietolähteenä, käyttää sitä vastoin OAuth 2.0Sen avulla voit selata kansioita, listata tiedostoja ja ladata niiden sisällön käsittelyä tai Dify-tietämysvirtaan liittämistä varten.

Drive-liitin on vain luku -tilassa: se ei luo tiedostoja, järjestele kansioita eikä muokkaa tai poista dokumentteja. Kun lataat natiivitiedostoja Google Workspacesta, se vie ne automaattisesti yhteensopiviin muotoihin. Google Sheets -tiedostot muunnetaan XLSX-tiedostoiksi, kun taas Google Docs ja Google Slides viedään PDF-tiedostoina.

Siksi sinun on valittava integrointi tehtävän mukaan:

• Käytä laajennusta tarkoitukseen Google-taulukot lukea tai kirjoittaa arvoja soluihin.
• Käytä tietolähdettä Google Drive tiedostojen paikantamiseen ja lataamiseen.
• Yhdistä molemmat vain, jos työnkulun on käsiteltävä soluja ja kokonaisia ​​asiakirjoja.

Integraation laajentaminen n8n:n avulla

Google Sheets -lisäosa on hyödyllinen seuraaville: suorita toimintoja DifyltäSe ei kuitenkaan kata kaikkia automaatioskenaarioita yksinään. Jos tarvitset käynnistimiä, ajoitettuja suorituksia tai yhteyksiä useisiin sovelluksiin, voit sijoittaa n8n välittäjänä.

Tässä arkkitehtuurissa Dify voi lähettää dataa n8n-webhookille HTTP-pyynnön kautta. n8n vastaanottaa pyynnön, Se suorittaa Google Sheets -solmunsa ja palauttaa tuloksen työnkulkuun..

Voit myös kääntää prosessin. Esimerkiksi n8n voi havaita uuden rivin, käsitellä sen arvot ja kutsua Difyssä julkaistun sovelluksen API:a. Tekoälyn luoma tulos voidaan sitten kirjoittaa saman taulukon toiseen sarakkeeseen.

Tämän järjestelmän avulla voit luoda automaatioita, kuten:

• Luokittele taulukkoon lisätyt vastaukset automaattisesti.
• Luo yhteenvetoja tiettyyn aikaan.
• Päivitä tiedot ja lähetä ilmoitus samanaikaisesti.
• Yhdistä Google Sheetsin tietoja sähköpostiin, CRM-järjestelmään tai muihin sovelluksiin.
• Suorita validoinnit ennen kuin annat tekoälyn muokata solua.

Vastineeksi kokoonpano on monimutkaisempi ja vaatii molempien palveluiden käyttämien webhookien, tunnistetietojen ja API-avainten suojaamista.

Yhdistämällä Difyn Google Sheetsiin voit muuntaa tavallisen laskentataulukon arvokkaaksi tietolähteeksi, johon asiakaspalvelijat tai työnkulut voivat päästä käsiksi. Yksinkertaisin tapa on ottaa käyttöön Sheets-rajapinta, luoda palvelutili, asentaa laajennus ja jakaa vain tarvittavat laskentataulukot sähköpostitse.

Sieltä, Batch Get -funktiolla voit tehdä kyselyitä alueista ja Batch Update -funktiolla voit kirjoittaa tulokset.Jos projektin on työskenneltävä kokonaisten dokumenttien kanssa, reagoitava tapahtumiin tai koordinoitava useita sovelluksia, voit täydentää tätä kokoonpanoa Google Drivella tai n8n:llä sekoittamatta työkalujen toimintoja.