Πώς να συνδέσετε το Dify με τα Φύλλα Google και το Google Drive

Αν θέλετε οι πράκτορες τεχνητής νοημοσύνης σας να εργάζονται με πραγματικές και ενημερωμένες πληροφορίες, σύνδεση του Dify με τα Υπολογιστικά Φύλλα Google Είναι ένας από τους απλούστερους τρόπους για να το πετύχετε αυτό. Το υπολογιστικό φύλλο μπορεί να λειτουργήσει ως ένα μικρό αποθετήριο δεδομένων από το οποίο μπορείτε να υποβάλλετε ερωτήματα για προϊόντα, πελάτες, εργασίες ή οποιαδήποτε άλλη εγγραφή που χρησιμοποιείται από την εφαρμογή σας.

Αυτή η ενσωμάτωση επιτρέπει σε μια ροή εργασίας Dify να διαβάζει διαφορετικά εύρη και να γράφει νέες τιμές χωρίς να απαιτείται χειροκίνητη αντιγραφή δεδομένων. Για παράδειγμα, μπορείτε να δημιουργήσετε έναν οδηγό που ελέγχει την κατάσταση της παραγγελίας, κατηγοριοποιεί τις απαντήσεις σε φόρμες ή ενημερώνει έναν πίνακα μετά την επεξεργασία ενός αιτήματος.

Υπάρχουν διάφοροι τρόποι για να το κάνετε αυτό. Η πιο άμεση διαδρομή χρησιμοποιεί ένα Πρόσθετο για τα Υπολογιστικά Φύλλα Google και λογαριασμός υπηρεσίας Google CloudΕάν χρειάζεται να αντιδράτε αυτόματα σε αλλαγές, να εκτελείτε προγραμματισμένες εργασίες ή να συνδυάζετε το υπολογιστικό φύλλο με άλλες εφαρμογές, μπορείτε επίσης να χρησιμοποιήσετε μια ενδιάμεση πλατφόρμα όπως το n8n.

Σχετικό άρθρο:

Πώς να εγκαταστήσετε και να ρυθμίσετε το Dify με το Docker βήμα προς βήμα

Τι χρειάζεστε για να συνδέσετε το Dify με τα Υπολογιστικά Φύλλα Google

Πριν ξεκινήσουμε, αξίζει να διευκρινίσουμε ότι το πρόσθετο omluc/google_sheets Διαθέσιμο στο Dify Marketplace, αυτό είναι ένα πρόσθετο κοινότητας. Δεν αποτελεί μέρος των επίσημων πρόσθετων που αναπτύχθηκαν από την ομάδα Dify, αν και μπορεί να εγκατασταθεί από την αγορά επεκτάσεων.

Αυτό το πρόσθετο ενσωματώνει αυτήν τη στιγμή δύο κύρια εργαλεία:

• Παρτίδα Λήψης: Ανακτά δεδομένα από ένα ή περισσότερα εύρη σε ένα υπολογιστικό φύλλο.
• Μαζική ενημέρωση: ενημερώνει πολλαπλά εύρη εντός της ίδιας λειτουργίας.

Αυτές οι συναρτήσεις μπορούν να προστεθούν ως εργαλεία σε μια ροή εργασίας ή να διατεθούν σε έναν εκπρόσωπο για χρήση όπως απαιτείται. Για να τις διαμορφώσετε, θα χρειαστείτε:

• ΕΝΑ Λογαριασμός Google με πρόσβαση στο Google Cloud.
• Un έργο που δημιουργήθηκε στο Google Cloud.
• La API Υπολογιστικών Φύλλων Google ενεργοποιήθηκε.
• Ένας λογαριασμός υπηρεσίας με κλειδί σε μορφή JSON.
• ΕΝΑ κοινόχρηστο φύλλο με τη διεύθυνση email αυτού του λογαριασμού.

Ο λογαριασμός υπηρεσίας λειτουργεί ως ξεχωριστή ταυτότητα. Επομένως, το Dify δεν χρησιμοποιεί απευθείας τον προσωπικό σας λογαριασμό Google, ούτε μπορεί να έχει αυτόματη πρόσβαση σε όλα τα υπολογιστικά σας φύλλα. Θα έχει πρόσβαση μόνο στα έγγραφα που κοινοποιείτε ρητά σε αυτό.

Πώς να δημιουργήσετε έναν λογαριασμό υπηρεσίας στο Google Cloud

Το πρώτο βήμα είναι να μεταβείτε στην Κονσόλα Google Cloud και να δημιουργήσετε ένα νέο έργο ή να επιλέξετε ένα υπάρχον. Μέσα στο έργο, ανοίξτε την ενότητα API και Υπηρεσίες, μεταβείτε στη βιβλιοθήκη και αναζητήστε... API Υπολογιστικών Φύλλων GoogleΣτη συνέχεια, πατήστε την επιλογή για να την ενεργοποιήσετε.

Στη συνέχεια, εισαγάγετε IAM και διοίκηση > Λογαριασμοί υπηρεσιών και δημιουργήστε έναν νέο λογαριασμό. Μπορείτε να του δώσετε ένα όνομα που να διευκολύνει την αναγνώριση του για τον οποίο χρησιμοποιείται, όπως "Dify Google Sheets".

Κατά τη διάρκεια αυτής της διαδικασίας, η Google ενδέχεται να σας προσφέρει την επιλογή να αναθέσετε ρόλους εντός του έργου. Για αυτήν την ενσωμάτωση, δεν χρειάζεται να αναθέσετε έναν γενικό ρόλο κατόχου ή συντάκτη για ολόκληρο το έργο. Η πρόσβαση σε συγκεκριμένα φύλλα ελέγχεται αργότερα μέσω των επιλογών κοινής χρήσης των Υπολογιστικών Φύλλων Google.

Μόλις δημιουργηθεί ο λογαριασμός:

1. Ανοίξτε τα στοιχεία σας από την ενότητα λογαριασμών υπηρεσίας.
2. Μετάβαση στην καρτέλα Κλειδιά.
3. Κάντε κλικ στο Προσθήκη κλειδιού > Δημιουργία νέου κλειδιού.
4. Επιλέξτε τη μορφή JSON.
5. Λήψη και αποθήκευση του αρχείου σε ασφαλές μέρος.

Το αρχείο JSON περιέχει ευαίσθητες πληροφορίες, συμπεριλαμβανομένου ενός ιδιωτικού κλειδιού. Δεν επιτρέπεται να το δημοσιεύσετε, να το στείλετε μέσω email ή να το ανεβάσετε σε αποθετήριο. Οποιοσδήποτε αποκτήσει αυτό το κλειδί θα μπορούσε να ενεργήσει με τα δικαιώματα του λογαριασμού υπηρεσίας.

Πώς να εγκαταστήσετε και να ρυθμίσετε το πρόσθετο στο Dify

Στο Dify, ανοίξτε το Plugin Marketplace και αναζητήστε το πρόσθετο των Υπολογιστικών Φύλλων Google που δημοσιεύτηκε από ομλούκΕλέγξτε το όνομα του δημιουργού πριν το εγκαταστήσετε για να αποφύγετε τη σύγχυση με άλλες επεκτάσεις που ενδέχεται να προσφέρουν διαφορετικές λειτουργίες.

Μετά την εγκατάσταση, ανοίξτε τις ρυθμίσεις διαπιστευτηρίων του πρόσθετου. Η φόρμα θα ζητήσει το κλειδί λογαριασμού υπηρεσίας. Ανοίξτε το αρχείο JSON που κατεβάσατε με ένα πρόγραμμα επεξεργασίας κειμένου. αντιγράψτε όλο το περιεχόμενό του και επικολλήστε το στο αντίστοιχο πεδίο.

Μην αντιγράφετε μόνο τη διεύθυνση ηλεκτρονικού ταχυδρομείου, το αναγνωριστικό έργου ή το ιδιωτικό κλειδί ξεχωριστά. Το πρόσθετο απαιτεί την πλήρη δομή JSON για τον έλεγχο ταυτότητας αιτημάτων που υποβάλλονται στα Υπολογιστικά Φύλλα Google.

Στη συνέχεια, αποθηκεύστε τα διαπιστευτήρια και ανοίξτε το υπολογιστικό φύλλο που θέλετε να χρησιμοποιήσετε. Μέσα στο αρχείο JSON, θα βρείτε ένα πεδίο με το όνομα client_email, του οποίου η τιμή θα έχει παρόμοια εμφάνιση με αυτήν:

[email protected]

Κάντε κλικ στο Μερίδιο μέσα στα Υπολογιστικά Φύλλα Google και προσθέστε αυτήν τη διεύθυνση σαν να ήταν κάποιος άλλος χρήστης:

• Χορηγεί άδεια σε αναγνώστης αν το Dify θα συμβουλεύεται μόνο δεδομένα.
• Χορηγεί άδεια σε συντάκτης αν χρειάζεται επίσης να ενημερώσετε τα κελιά.

Δεν συνιστάται η δημόσια κοινή χρήση του υπολογιστικού φύλλου μέσω συνδέσμου. Ο λογαριασμός υπηρεσίας σάς επιτρέπει να διατηρείτε το έγγραφο ιδιωτικό και να περιορίζετε την πρόσβαση σε έναν συγκεκριμένο χρήστη.

Πώς να διαβάσετε δεδομένα από τα Υπολογιστικά Φύλλα Google από μια ροή εργασίας

Για να ανακτήσετε πληροφορίες από το φύλλο, προσθέστε έναν κόμβο εργαλείου στη ροή εργασίας Dify και επιλέξτε την ενέργεια Παρτίδα ΛήψηςΤο πρόσθετο σάς επιτρέπει να υποβάλλετε ερωτήματα σε πολλαπλά εύρη με μία μόνο λειτουργία, αποφεύγοντας την ανάγκη δημιουργίας διαφορετικού κόμβου για κάθε ενότητα του πίνακα.

Θα χρειαστεί να δώσετε το αναγνωριστικό του υπολογιστικού φύλλου. Αυτό εμφανίζεται στη διεύθυνση ιστού του, μεταξύ /d/ y /editΣε μια διεύθυνση URL με αυτήν τη δομή:

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

Πρέπει να χρησιμοποιήσετε μόνο την τιμή που έχει επισημανθεί ως IDENTIFICADOR.

Θα χρειαστεί επίσης να καθορίσετε το όνομα της καρτέλας και το εύρος χρησιμοποιώντας τη σημειογραφία των Υπολογιστικών Φύλλων Google. Μερικά παραδείγματα θα ήταν:

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

Το όνομα πριν από το θαυμαστικό αντιστοιχεί στον στηλοθέτη. Τα γράμματα και οι αριθμοί που ακολουθούν οριοθετούν τις στήλες και τις γραμμές που θα ανακτηθούν.

Στη συνέχεια, μπορείτε να μεταβιβάσετε το αποτέλεσμα σε έναν κόμβο LLM για να το συνοψίσει, να εντοπίσει μια εγγραφή ή να προετοιμάσει μια απάντηση. Συνιστάται να δώσετε εντολή στο μοντέλο να χρησιμοποιεί μόνο τα ανακτημένα δεδομένα και να υποδεικνύει με σαφήνεια πότε δεν βρίσκει αντιστοιχία, ειδικά εάν το φύλλο περιέχει πληροφορίες πελάτη, αποθέματος ή παραγγελίας.

Πώς να ενημερώσετε κελιά από το Dify

Το εργαλείο Μαζική ενημέρωση Σας επιτρέπει να γράφετε τιμές σε διάφορα εύρη. Αυτό μπορεί να χρησιμοποιηθεί, για παράδειγμα, για να αλλάξετε την κατάσταση μιας εργασίας, να αποθηκεύσετε μια ταξινόμηση που δημιουργείται από τεχνητή νοημοσύνη ή να προσθέσετε το αποτέλεσμα ενός αιτήματος.

Πριν από τη χρήση, επαληθεύστε ότι ο λογαριασμός υπηρεσίας έχει δικαιώματα επεξεργασίας στο έγγραφο. Εάν έχει μόνο δικαιώματα ανάγνωσης, τα ερωτήματα θα λειτουργούν, αλλά η Google θα απορρίπτει τις προσπάθειες εγγραφής.

Συνιστάται επίσης να αποτρέψετε το μοντέλο από το να επιλέγει ελεύθερα οποιοδήποτε εύρος ή τιμή. Μια πιο ασφαλής διαμόρφωση αποτελείται από Αρχικά, επικυρώστε τα δεδομένα, περιορίστε τις τροποποιήσιμες στήλες και δημιουργήστε το εύρος χρησιμοποιώντας ελεγχόμενες μεταβλητές. μέσω της ροής εργασίας.

Για παράδειγμα, μπορείτε να οργανώσετε τη διαδικασία ως εξής:

1. El ο χρήστης εισάγει έναν αριθμό παραγγελίας.
2. Η παρτίδα Get επιστρέφει στη σειρά αντίστοιχος.
3. Ένας υπό όρους κόμβος ελέγξτε αν η παραγγελία υπάρχει.
4. Το μοντέλο αναλύει ή ταξινομεί τις πληροφορίες.
5. Η μαζική ενημέρωση γράφει το αποτέλεσμα σε μια συγκεκριμένη στήλη.
6. Ο κόμβος εξόδου επιβεβαιώνει ποια εγγραφή έχει τροποποιηθεί.

Όποτε είναι δυνατόν, χρησιμοποιήστε ένα δοκιμαστικό υπολογιστικό φύλλο κατά τη ρύθμιση. Μια κακώς κατασκευασμένη ενημέρωση μπορεί να αντικαταστήσει τις υπάρχουσες πληροφορίες, ειδικά όταν το εύρος καλύπτει περισσότερες γραμμές ή στήλες από ό,τι προβλέπεται.

Συνηθισμένα λάθη κατά τη σύνδεση του Dify με τα Υπολογιστικά Φύλλα Google

Εάν αντιμετωπίσετε σφάλμα ελέγχου ταυτότητας, επαληθεύστε ότι έχετε επικολλήσει ολόκληρο το αρχείο JSON και ότι η μορφή του δεν έχει τροποποιηθεί. Τα ιδιωτικά κλειδιά περιέχουν αλλαγές γραμμής που πρέπει να διατηρούνται μέσα στη δομή του εγγράφου.

Όταν το Dify υποδεικνύει ότι δεν μπορεί να βρει ή να έχει πρόσβαση στο φύλλο, ελέγξτε τα εξής σημεία:

• Το API των Υπολογιστικών Φύλλων Google είναι ενεργοποιημένο στο σωστό έργο.
• Το φύλλο έχει κοινοποιηθεί με την ακριβή τιμή του client_email.
• Το αναγνωριστικό φύλλου δεν περιέχει πρόσθετα μέρη της διεύθυνσης URL.
• Το όνομα της καρτέλας ταιριάζει, συμπεριλαμβανομένων των κεφαλαίων γραμμάτων, των κενών και των τόνων.
• Το εύρος χρησιμοποιεί μια έγκυρη σημειογραφία, όπως π.χ. Datos!A2:C20.
• Ο λογαριασμός έχει δικαιώματα επεξεργασίας εάν η ροή εργασίας επιχειρήσει εγγραφή.

Εάν έχετε διαγράψει ή απενεργοποιήσει το κλειδί στο Google Cloud, θα πρέπει να δημιουργήσετε ένα νέο και να αντικαταστήσετε τα διαπιστευτήρια που είναι αποθηκευμένα στο Dify. Θα πρέπει επίσης να δημιουργήσετε ένα νέο κλειδί εάν υποψιάζεστε ότι το αρχείο JSON έχει εκτεθεί.

Διαφορές μεταξύ των προσθηκών των Υπολογιστικών Φύλλων Google και του Google Drive

Τα Υπολογιστικά Φύλλα Google και το Google Drive δεν θα πρέπει να αντιμετωπίζονται ως μία ενιαία ενσωμάτωση. Το πρόσθετο κοινότητας των Υπολογιστικών Φύλλων προορίζεται για προβολή και τροποποίηση περιοχών κελιών μέσω λογαριασμού υπηρεσίας.

Αντίθετα, το επίσημο πρόσθετο Google Drive που διατίθεται ως πηγή δεδομένων χρησιμοποιεί OAuth 2.0Σας επιτρέπει να περιηγείστε σε φακέλους, να παραθέτετε αρχεία και να κατεβάζετε το περιεχόμενό τους για επεξεργασία ή ενσωμάτωση σε μια ροή γνώσης Dify.

Η εφαρμογή σύνδεσης Drive είναι μόνο για ανάγνωση: δεν δημιουργεί αρχεία, δεν οργανώνει φακέλους ή δεν τροποποιεί ή διαγράφει έγγραφα. Όταν κάνετε λήψη εγγενών αρχείων από το Google Workspace, τα εξάγει αυτόματα σε συμβατές μορφές. Τα Υπολογιστικά φύλλα Google μετατρέπονται σε αρχεία XLSX, ενώ τα Έγγραφα Google και οι Παρουσιάσεις Google εξάγονται ως PDF.

Επομένως, πρέπει να επιλέξετε την ενσωμάτωση ανάλογα με την εργασία:

• Χρησιμοποιήστε το πρόσθετο για Υπολογιστικά φύλλα Google για να διαβάσετε ή να γράψετε τιμές σε κελιά.
• Χρησιμοποιήστε την πηγή δεδομένων του Google Drive για να εντοπίσετε και να κατεβάσετε αρχεία.
• Συνδυάστε και τα δύο μόνο εάν η ροή εργασίας πρέπει να λειτουργεί με κελιά και ολόκληρα έγγραφα.

Πώς να επεκτείνετε την ενσωμάτωση χρησιμοποιώντας το n8n

Το πρόσθετο των Υπολογιστικών Φύλλων Google είναι χρήσιμο για εκτέλεση ενεργειών από το DifyΩστόσο, δεν καλύπτει όλα τα σενάρια αυτοματισμού από μόνο του. Εάν χρειάζεστε εναύσματα, προγραμματισμένες εκτελέσεις ή συνδέσεις με πολλές εφαρμογές, μπορείτε να τοποθετήσετε n8n ως ενδιάμεσος.

Σε αυτήν την αρχιτεκτονική, Το Dify μπορεί να στείλει τα δεδομένα σε ένα webhook n8n μέσω ενός αιτήματος HTTP. Το n8n λαμβάνει το αίτημα, Εκτελεί τους κόμβους του στα Υπολογιστικά Φύλλα Google και επιστρέφει το αποτέλεσμα στη ροή εργασίας.

Μπορείτε επίσης να αντιστρέψετε τη διαδικασία. Για παράδειγμα, το n8n μπορεί να εντοπίσει μια νέα γραμμή, να επεξεργαστεί τις τιμές της και να καλέσει το API μιας εφαρμογής που έχει δημοσιευτεί στο Dify. Το αποτέλεσμα που δημιουργείται από την τεχνητή νοημοσύνη μπορεί στη συνέχεια να εγγραφεί σε μια άλλη στήλη στο ίδιο φύλλο.

Αυτό το σύστημα σάς επιτρέπει να δημιουργείτε αυτοματισμούς όπως:

• Αυτόματη ταξινόμηση των απαντήσεων που προστίθενται σε ένα φύλλο.
• Δημιουργήστε συνόψεις σε συγκεκριμένη χρονική στιγμή.
• Ενημερώστε τα αρχεία και στείλτε μια ειδοποίηση ταυτόχρονα.
• Συνδυάστε δεδομένα από τα Υπολογιστικά Φύλλα Google με email, CRM ή άλλες εφαρμογές.
• Εφαρμόστε επικυρώσεις πριν επιτρέψετε στην Τεχνητή Νοημοσύνη να τροποποιήσει ένα κελί.

Σε αντάλλαγμα, η διαμόρφωση είναι πιο περίπλοκη και απαιτεί την προστασία των webhooks, των διαπιστευτηρίων και των κλειδιών API που χρησιμοποιούνται και από τις δύο υπηρεσίες.

Η σύνδεση του Dify με τα Φύλλα Google σάς επιτρέπει να μετατρέψετε ένα τυπικό υπολογιστικό φύλλο σε μια εύκολα προσβάσιμη πηγή πληροφοριών για εκπροσώπους ή ροές εργασίας. Η πιο άμεση προσέγγιση είναι να ενεργοποιήσετε το API των Φύλλων, να δημιουργήσετε έναν λογαριασμό υπηρεσίας, να εγκαταστήσετε την προσθήκη και να κοινοποιήσετε μόνο τα απαραίτητα φύλλα με τη διεύθυνση email σας.

Από εκεί, Η λειτουργία Batch Get σάς επιτρέπει να υποβάλλετε ερωτήματα σε εύρη και η λειτουργία Batch Update γράφει αποτελέσματα.Εάν το έργο χρειάζεται να λειτουργήσει με πλήρη έγγραφα, να αντιδράσει σε συμβάντα ή να συντονίσει πολλαπλές εφαρμογές, μπορείτε να συμπληρώσετε αυτήν τη ρύθμιση με το Google Drive ή το n8n χωρίς να συγχέετε τις λειτουργίες κάθε εργαλείου.

Σχετικό άρθρο:

Πώς να δημιουργήσετε έναν βοηθό τεχνητής νοημοσύνης χωρίς να γράψετε ούτε μία γραμμή κώδικα χρησιμοποιώντας το Dify

Αλμπέρτο ​​Ναβάρο

Είμαι λάτρης της τεχνολογίας που έχει μετατρέψει τα «γκικ» ενδιαφέροντά του σε επάγγελμα. Έχω περάσει περισσότερα από 10 χρόνια της ζωής μου χρησιμοποιώντας τεχνολογία αιχμής και ασχολούμαι με όλα τα είδη προγραμμάτων από καθαρή περιέργεια. Τώρα έχω ειδικευτεί στην τεχνολογία υπολογιστών και στα βιντεοπαιχνίδια. Αυτό οφείλεται στο γεγονός ότι για περισσότερα από 5 χρόνια εργάζομαι γράφοντας για διάφορους ιστότοπους σχετικά με την τεχνολογία και τα βιντεοπαιχνίδια, δημιουργώντας άρθρα που επιδιώκουν να σας δώσουν τις πληροφορίες που χρειάζεστε σε μια γλώσσα κατανοητή από όλους.

Αν έχετε απορίες, οι γνώσεις μου κυμαίνονται από οτιδήποτε σχετίζεται με το λειτουργικό σύστημα Windows καθώς και με Android για κινητά τηλέφωνα. Και η δέσμευσή μου είναι απέναντί ​​σας, είμαι πάντα πρόθυμος να αφιερώσω λίγα λεπτά και να σας βοηθήσω να επιλύσετε τυχόν απορίες που μπορεί να έχετε σε αυτόν τον κόσμο του Διαδικτύου.