Google Workspace için Slaytlar incelemeci eklentisini derleme, çalıştırma ve özelleştirme Bu kod projesinin bulunduğu Slaytlar. Haftada bir sunum yapıp yapmadığınıza ya da yılda bir kere, çoğumuz işleri tamamlamak için ufak bir yardım alabiliriz. Sence bir slayta çok fazla çok şey mi ekliyorsunuz? Belki sunumunuzu bölmeyi unutuyorsunuz görsellerle entegre oldu mu? Hatta kuruluşunuzdan alınan bir dizi yönerge, etkili sunumlar yapmanıza yardımcı olur. Bunları son zamanlarda okudunuz mu?
Slaytlar Danışmanı projesi, yapay zeka kullanan açık kaynaklı bir Google Workspace eklentisidir. yapay zeka teknolojisi ile sunumlarınızı inceleyebilir ve bunlar hakkında geri bildirimde bulunabilirsiniz. kısa bir ödeme yapabilirsiniz. Proje, Google'ın Gemini API görsel ve metnini kullanıyor Google Slaytlar sunularınızı bir dizi yönerge doğrultusunda analiz etmek için işleme özellikleri ve bu kurallara karşı ne durumda olduğunuzu gösterir. Daha da iyisi, bu yönergeleri kuruluşunuzun önerilerine uyacak şekilde özelleştirebilir veya belirlediğiniz kurallara göre sunularınızı geliştirmenizi hatırlatır kendiniz.
Analizler de dahil olmak üzere projeye ve projenin nasıl genişletileceğine dair genel bir bakış videosu için AI Slaytlar İncelemecisi - Build with Google Yapay zeka. Aksi takdirde, projenizi projeyi başlatmak için sabırsızlanabilirsiniz.
Şekil 1. Google Slaytlar için Slaytlar Danışmanı eklentisi, kenar çubuğu paneli olarak çalışır.
Proje ayarlama
Buradaki talimatlar Slaytlar Danışmanı projesinin kurulumunda size yol gösterecektir kullanmaya karar verebilir. Genel adımlar, Google Apps Komut dosyası projesi, API erişimi için Google Cloud projesi oluşturma ve komut dosyası özelliklerini girin.
Apps Komut Dosyası projesi oluşturma
Bu Slaytlar Danışmanı projesi şu şekilde çalışır: Eklenti: Google Slaytlar. Projeyi, Google Slaytlar web arayüzünü kullanarak oluşturursunuz ve kod için bir Apps Komut Dosyası projesi oluşturun.
Yeni bir Apps Komut Dosyası projesi oluşturmak için:
- Google için Slaytlar web uygulamasına gidin Çalışma alanı.
- Mevcut bir sunuyu açın veya yeni bir sunu oluşturun.
- Slaytlar sununuzda Uzantılar > Apps Komut Dosyası.
Bu adımları tamamladığınızda Untitled projeniz sunuya eklenen Apps Komut Dosyası web kullanıcı arayüzü. harika bir fırsat. Bulunmasını kolaylaştırmak için projeye bir ad verin.
Apps Komut Dosyası projesini adlandırmak için:
- Apps Komut Dosyası web arayüzünde Adsız proje metnini seçin.
- Projeyi Yeniden Adlandırın iletişim kutusunda
My Slides Advisor
yazın ve ardından Yeniden adlandır'ı seçin.
Proje dosyalarını hazırlama
Slaytlar Danışmanı projesinde 5 kod dosyası bulunur ve bu dosyaları sizin oluşturmanız gerekir . Bu bölüm projenin nasıl hazırlanacağını ve kodun nasıl alınacağını açıklar.
Proje dosyalarını hazırlamak için:
- Slaytlarım Danışmanı'nı içeren Apps Komut Dosyası web arayüzünü açın. belirler.
- Sol taraftaki menüden < > Düzenleyici görünümüne gidin.
- Code.gs dosyasını, fareyle üzerine gelerek main.gs olarak yeniden adlandırın.
Code.gs kod dosyasının adı, içerik menüsünden Yeniden adlandır'ı seçerek
main
giriliyor. Arayüz .gs uzantısını otomatik olarak ekler. - Şu seçeneği belirleyerek projenin appscript.json manifest dosyasını görünür hale getirin: soldaki menüden dişli simgesini (Proje Ayarları) ve ardından Show "appscript.json" dosyasını etkinleştirerek manifest file seçeneğidir.
- Apps Komut Dosyası web arayüzünde, sol taraftaki menüde < > Düzenleyici görünümüne gidin.
- Sağdaki + (artı) simgesini seçerek bir ui.gs kod dosyası oluşturun.
Files (Dosyalar) başlığının altında Script'i seçip
ui
yazın. slides.gs
veai.gs
oluşturmak için önceki adımı tekrarlayın emin olun.
Apps Komut Dosyası projenizde artık şu 5 kod dosyası bulunuyor: Çoğunlukla boş:
- appscript.json
- main.gs
- ui.gs
- slides.gs
- ai.gs
Sonraki adım için proje kodunu depodan alın ve kodu Apps Komut Dosyası projeniz.
Proje kodunu alma
Slaytlar Danışmanı projesinin kodu, bir kod deposunda barındırılır. Siz o kodu Apps Komut Dosyası projenize kopyalamanız gerekir. Bu bölümünde proje kodunun nasıl alınacağı açıklanmaktadır.
Proje kodunu almak için:
- Proje manifest dosyası için proje kodu deposuna gidin.
appsscript.json
- Bu kod dosyasının içeriğini panonuza kopyalayın.
- Apps Komut Dosyası web arayüzüne dönün, appsscript.json dosya adını girin ve kodu kod düzenleyiciye yapıştırın önceki kodun yerini alır.
- Diğer 4 kod dosyası için bu prosedürü tekrarlayın:
Google Cloud projesi bağla
Bu proje, Gemini yapay zeka modellerine erişmek için bir Google Cloud projesi kullanır. Google Bulut, kullanıcılara belirli veri gizliliği politikaların yanı sıra kullanıcı edinmeye yönelik birçok yararlı yazılım hizmeti ve diğer uygulamalar için kullanabilirsiniz. Eklenti kodunu Gemini API'ye bağlarsınız AI API erişimi olan bir Cloud projesi veya hizmet hesabı için bir anahtar oluşturur ve bu anahtarı dikkat edin.
Bir Cloud projesi yapılandırın
Gemini API'ye bağlanmak için kullandığınız Cloud projesinde Vertex AI'a sahip olması gerekir ve kimlik doğrulamasından geçmiş bir bağlantı oluşturmanız gerekir. bu projeye Slaytlar Danışmanı Eklentisi'ni ekleyeceksiniz. Vertex AI API için ayrıca faturalandırmayı, kullandığınız projelerde etkinleştirmelisiniz.
Vertex AI API erişimiyle bir Cloud projesini yapılandırmak için:
- Google Cloud Console'a gidin. ve gerekiyorsa oturum açın.
- Google Cloud konsolunda mevcut bir Cloud projesini seçin veya yeni bir hesap oluşturun.
- Konsolda Kontrol paneli sayfası: API'ler panelinde API'lere genel bakışa gidin'i seçin veya https://console.cloud.google.com/apis/ adresine gidin.
- API'ler ve Hizmetler sayfasında, sayfanın en üstündeki + API'LERİ VE HİZMETLERİ ETKİNLEŞTİRME.
- API Kitaplığı sayfasında
vertex ai api
araması yapın ve Vertex AI API'yi seçip Etkinleştir düğmesini seçin. - Henüz etkin değilse Google Cloud hesabınız için Faturalandırmayı etkinleştirmeniz gerekir. ve ardından sayfadaki Etkinleştir düğmesini seçerek AI API'yi Vertex AI API konsol sayfasına gidin.
- Şu adımları uygulayarak Vertex AI API'nin etkinleştirildiğini doğrulayın: API'ler ve Hizmetler sayfası için akılda kalıcı bir yolunu sunar. Bu sayfada Vertex AI API'nin listelendiğini göreceksiniz.
Hizmet hesabı oluşturma
Slaytlar Danışmanı eklentisi, Cloud Search Console'a kimliği doğrulanmış bir bağlantı gerektirir. Vertex AI API ve Gemini modellerine erişmek için Onu siz oluşturursunuz bağlantısını oluşturmak için öncelikle hizmet hesabı Vertex AI API'ye erişimi olan Cloud projenizde etkinleştirin. Slaytlar Danışmanı projesi bu hizmet hesabı kullanılarak bağlanır.
Slaytlar Danışmanı eklentisine yönelik bir hizmet hesabı oluşturmak için:
- Google Cloud konsolunda şu konuma gidin: API'ler ve Hizmetler sayfasını ziyaret edin.
- Sayfanın sol tarafında Credentials'ı (Kimlik bilgileri) seçin.
- Sayfanın üst tarafında, + KİMLİK BİLGİLERİ OLUŞTUR > Hizmet hesabı.
- Hizmet hesabı oluştur sayfasında, Hizmet hesabı ayrıntıları bölümünde bir hizmet hesabı adı, kimliği ve açıklaması girin.
- Oluştur ve Devam Et'i seçerek hizmet hesabını oluşturun.
- Bu hizmet hesabına projeye erişim izni ver bölümünde, Rol kontrolü.
- Filtre alanı arama bölümünde Vertex AI Kullanıcısı'nı seçin. belirleyip Devam'ı seçin.
- Bitti'yi seçerek bu hizmet hesabını oluşturma işlemini tamamlayın.
Hizmet hesapları oluşturma hakkında daha fazla bilgi için bkz. Google Cloud Hizmet hesapları oluşturma belgelerinden faydalanabilirsiniz.
Hizmet hesabı anahtarı oluşturma ve yükleme
Slaytlar Danışmanı projesinin, hizmet hesabının kimliğini doğrulayabilmesi gerekir adımları uygulayın. Bu kimlik doğrulamasını şu şekilde etkinleştirebilirsiniz: hizmet hesabı için bir anahtar oluşturma ve bu anahtarı Slaytlarınızda yapılandırma Komut Dosyası Mülkü olarak Advisor Apps Komut Dosyası projesi. Aşağıdaki prosedür projenizde anahtarın nasıl oluşturulacağı ve yapılandırılacağı açıklanır.
Bir hizmet hesabı anahtarı oluşturmak ve yapılandırmak için:
- Google Cloud konsolunda şu konuma gidin: API'ler ve Hizmetler sayfası için Google Cloud projenize de ekler.
- Sayfanın sol tarafında Credentials'ı (Kimlik bilgileri) seçin.
- Hizmet Hesapları bölümünde, kullandığınız hizmet hesabını bulun. hesap e-posta adresini veya kurşun kalem simgesini seçerek e-posta adresini düzenleyin.
- Hizmet hesabı düzenleme penceresinde, sayfanın üst kısmına yakın bir yerde bulunan KEYS sekmesi başlığı.
- Anahtarlar bölümünde Anahtar Ekle > Yeni anahtar oluştur.
- Şunun için özel anahtar oluştur... iletişim kutusunda JSON'yi seçin ve ardından Oluştur. Bu adımda projectid-hashcode.json adında bir anahtar dosyası oluşturulur. ve otomatik olarak bilgisayarınıza indirir.
- İndirdiğiniz projectid-hashcode.json dosyasını açın ve içeriği kopyalayın.
- Slaytlarım Danışmanı'nı içeren Apps Komut Dosyası web arayüzünü açın. projenize gidin ve soldaki menüden Ayarlar görünümünü seçin.
- Komut Dosyası Özellikleri bölümünde, Komut dosyasını düzenle özellikler düğmesini ve ardından Komut dosyası özelliği ekle düğmesini tıklayın.
- Yeni Mülk alanına
SERVICE_ACCOUNT_KEY
yazın ve Value (Değer) alanını kopyalayın, indirilen dosyanın içeriğini kopyalayın projectid-hashcode.json dosyası olmalıdır. - Komut dosyası özelliklerini kaydet düğmesini seçerek yeni mülkü kaydedin.
Hizmet hesabı anahtarları oluşturma hakkında daha fazla bilgi için Google Cloud Hizmet hesabı anahtarları oluşturma ve silme belgelerinden faydalanabilirsiniz.
Eklenti projesini test etme
Slaytlar Advisor projesini test etmek için bir test dağıtımı oluşturmanız gerekir ve bu test dağıtımını yüklemeniz gerekir. Bu testte yapılandırma gerekiyorsa proje yalnızca Google Slaytlar sunusunda Apps Komut Dosyası Ekleme projesini başlattığınız ve başka bir Slaytlar dosyası olmadan sunuları seçin. Eklentinizi daha geniş çapta kullanmak için dağıtmayla ilgili daha fazla bilgiyi şurada bulabilirsiniz: Google Workspace Apps Komut Dosyası belgelerini, Dağıtım oluşturma ve yönetme konu.
Apps Komut Dosyası proje kodunu dağıtmak ve test etmek için:
- Apps Komut Dosyası web arayüzünün en üstünde Dağıt > Test et dağıtımları başlıklı makaleyi inceleyin.
- Dağıtımları test et iletişim kutusunda, Tür seçin'in yanındaki dişli simgesi ve Google Workspace Eklentisi.
- Uygulamalar: Slaytlar başlığının yanındaki Yükle düğmesini seçin.
- En son kodu test et ayarına yönelik varsayılan ayarları değiştirmeyin ve Bitti'yi seçin.
- Apps Komut Dosyanıza bağlı Google Slaytlar sunusunda gezinme projenizi ve web sayfasını yeniden yükleyin.
- Slaytlar web uygulamasının sağ alt köşesinden < ) yan paneli açın, ardından siyah beyaz göz simgesini seçin ve Slaytlar Danışmanı panelini açın.
Bu adımı tamamlayıp Eklentiyi başarıyla çalıştırdıktan sonra farklı yönergeler kullanmak veya farklı bir iş akışı uygulamak için Bkz. yapacağınız bazı temel değişikliklerin nasıl yapılacağına ilişkin talimatlar için Slaytlar Danışmanı Eklentisi.
Yorum davranışını değiştirin
Slayt Danışmanı'nın inceleme davranışını, hem kullanıcı ve Gemini API'nin sağladığı kullanıcı arayüzünden aldığınız çıkış Proje kodunu değiştirerek eklenti. Bu eğitim, ve sunu slaytı inceleme davranışını değiştirmeye yönelik talimatları isteyen bir e-posta alırsınız. Örneğin, Apps Komut Dosyası'nı kullanarak Google Slaytlar kullanıcı arayüzünü genişletme hakkında daha fazla bilgi, bkz. Google Slaytlar'ın kapsamını genişletme.
Yorum kurallarını değiştir
Slaytlar Danışmanı, slayt inceleme yönergelerinden oluşan temel bir setle programlanır. sadelik, renk ve tipografi, yapı ve boşluk kategorileriyle grafikler ve simgeler bulunur. Yorum yönergeleri yalnızca metin içeren talimatlardan oluşur Gemini API aracılığıyla gönderilen bir istemde, bir öğenin anlık görüntüsüyle ve konuşmacı notlarını görebilirsiniz.
Metni değiştirerek eklentinin inceleme davranışını değiştirebilirsiniz bakın. Örneğin, Gemini modeline kategori derecelendirmesi, kategori başlığıyla aynı satırda olmalıdır veya bir kategorinin adını değiştirin.
Kategori puanı konumunu ve kategori adını değiştirmek için:
- Slaytlarım Danışmanı'nı içeren Apps Komut Dosyası web arayüzünü açın. belirler. Gerekirse, Google Slaytlar sunusunda Apps Komut Dosyası projesini içeren, Uzantılar > Apps Komut Dosyası.
- Sol taraftaki menüden < > Düzenleyici görünümüne gidin ve ardından ai.gs dosya adına sahip olmalıdır.
- ai.gs kod dosyasında
SYSTEM_PROMPT
dize sabitini bulun. ve talimatları kalın metinle aşağıdaki gibi değiştirin:const SYSTEM_PROMPT = ` ... For each of the following categories evaluate the given slide. Score each category on a scale of 0 to 100, show the score next to the category heading, and concisely explain the reasoning. Do not suggest improvements if the score is 80 or above.
- Aynı
SYSTEM_PROMPT
dize sabitindeSimplicity
değerini değiştirin kategori metniniMessage
olarak ayarlayın:const SYSTEM_PROMPT = ` ... * Message -- Slides should focus on one main idea per slide and ...
- ai.gs kod dosyasında yapılan değişiklikleri kaydedin.
- Apps Komut Dosyanıza bağlı Google Slaytlar sunusunda gezinme projenizi yükleyin, web sayfasını yeniden yükleyin ve yeniden çalıştırmayı öğreteceğim.
Slaytlar Advisor eklentisi için henüz bir test dağıtımı oluşturmadıysanız buradaki talimatları uygulayın: Eklenti projesini test edin.
Yorum kategorisi talimatlarını
İnceleme koşullarınızla eşleşecek SYSTEM_PROMPT
dize sabiti. Şunu istiyorsanız:
farklı inceleme istemi yaklaşımlarını denemek veya yorumun tamamını yeniden yazmak
isteminiz için Google AI Studio web'e göz atın.
bir uygulamadır. Bu uygulama, Gemini için istemlerin prototipini test edip test edip kaydetmenize olanak tanır:
kullanır ve Slaytlar Danışmanı ile aynı Gemini API'yi kullanır.
belirler. AI Studio'yu kullanma hakkında daha fazla bilgi için
AI Studio hızlı başlangıç kılavuzu.
Model davranış yapılandırmasını değiştirme
Gemini API, yanıt olarak modele ekleyebilirsiniz. Özellikle, sıcaklık modelin belirli bir yılda ne kadar varyasyona izin verileceğini 1 en yüksek değer, sıfır ise en düşük değer olacak şekilde bir yanıt oluşturun. Bu değerin ayarlanması çok tutarlı yanıtlar verir, ancak bu davranış tekrar ediyormuş gibi görünebilir ve yorum geri bildirimi alan kullanıcılar için daha az faydalıdır. Bu sorunu çözmek için sıcaklığının yüksek olduğunu unutmayın. Sıcaklık yükseldikçe daha tutarsız hale gelebilir. Bunu yaparken de ve hatta bazı talimatları tamamen göz ardı edebilirsiniz.
Yorum yanıtlarının sıcaklığını artırmak için:
- Slaytlarım Danışmanı'nı içeren Apps Komut Dosyası web arayüzünü açın. belirler.
- Sol taraftaki menüden < > Düzenleyici görünümüne gidin ve ardından ai.gs dosya adına sahip olmalıdır.
ai.gs kod dosyasında
analyzeSlides()
işlevini bulun vetemperature
değerini ayarlayarakgenerationConfig
sabitini değiştirin Hedef:0.3
function analyzeSlides(slide) { const generationConfig = { temperature: 0.3, maxOutputTokens: 1024 * 2, };
ai.gs kod dosyasında yapılan değişiklikleri kaydedin.
Apps Komut Dosyanıza bağlı Google Slaytlar sunusunda gezinme projenizi yükleyin, web sayfasını yeniden yükleyin ve yeniden çalıştırmayı öğreteceğim.
Model davranışı yapılandırma ayarları hakkında daha fazla bilgi için
için API dokümanları
GenerationConfig
.
Ek kaynaklar
Slaytlar Danışmanı projesi hakkında daha fazla bilgi için bkz. kod deposu'na gidin. Uygulamayı geliştirme konusunda yardıma ihtiyacınız varsa veya diğer geliştiriciler için Google Developers Community Discord sunucusu kullanılacak. Daha fazla Build with Google AI projesi için şuraya göz atın: video oynatma listesi.