Bu kod projesiyle Google Workspace Slaytlar için slayt inceleme eklentisi oluşturun, çalıştırın ve özelleştirin. İster haftada bir ister yılda bir sunum yapın, çoğumuz sunumun doğru yapılması için biraz yardım alabiliriz. Bir slayda çok fazla mı koyuyorsunuz? Belki sunumunuzu görsellerle bölmeyi unutmayın. Etkili sunumlarla ilgili olarak kurumunuzun bir dizi yönergesi olabilir. Son zamanlarda bu belgeleri okudunuz mu?
Slides Advisor, açık kaynaklı bir Google Workspace eklentisidir. Yapay zeka (AI) teknolojisini kullanarak ihtiyaç duyduğunuzda sunularınızı inceleyip geri bildirimde bulunur. Proje, Google Slaytlar'ınızı bir dizi yönergeye göre analiz etmek için Google'ın Gemini API resim ve metin işleme özelliklerini kullanır ve bu yönergelere göre ne durumda olduğunuzu bilmenizi sağlar. Hatta bu yönergeleri kuruluşunuzun önerilerini izleyecek şekilde özelleştirebilir veya kendiniz için belirlediğiniz kurallara göre sunularınızı iyileştirmenizi hatırlatabilirsiniz.
Projeye ve projenin kapsamını genişletmeye yönelik genel bakış videosu için AI Slaytlar İncelemecisi - Google AI ile Derleme adlı kursa göz atın. Yoksa aşağıdaki talimatları uygulayarak projeyi genişletmeye başlayabilirsiniz.
Şekil 1. Kenar çubuğu paneli olarak çalışan Google Slaytlar için Slaytlar Danışmanı Eklentisi.
Proje ayarlama
Bu talimatlar, geliştirme ve test için Slaytlar Danışmanı projesini ayarlamanıza yardımcı olacaktır. Genel adımlar; Google Apps Komut Dosyası projesinin oluşturulması, API erişimi için bir Google Cloud projesinin ayarlanması ve proje için bazı Komut Dosyası özelliklerinin ayarlanmasıdır.
Apps Komut Dosyası projesi oluşturma
Bu Slaytlar Danışmanı projesi, Google Slaytlar için bir Eklenti olarak çalıştırılır. Projeyi Google Slaytlar web arayüzünü kullanarak ve kod için bir Apps Komut Dosyası projesi oluşturuyorsunuz.
Yeni bir Apps Komut Dosyası projesi oluşturmak için:
- Google Workspace için Slaytlar web uygulamasına gidin.
- Mevcut bir sunuyu açın veya yeni bir sunu oluşturun.
- Slaytlar sununuzda Uzantılar > Apps Komut Dosyası'nı seçin.
Bu adımları tamamladığınızda, Apps Komut Dosyası web kullanıcı arayüzünde, başladığınız sunuya eklenmiş yeni bir Adsız projeniz olacaktır. Daha kolay bulabilmek 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 kutusuna
My Slides Advisoryazın ve Yeniden adlandır'ı seçin.
Proje dosyalarını hazırlama
Slaytlar Danışmanı projesinde 5 kod dosyası vardır. Kodu yeni Apps Komut Dosyası projenize kopyalamadan önce bu dosyaları oluşturmanız gerekir. Bu bölümde projenin nasıl hazırlanacağı ve kodun nasıl alınacağı açıklanmaktadır.
Proje dosyalarını hazırlamak için:
- Slaytlar Danışmanım projesini içeren Apps Komut Dosyası web arayüzünü açın.
- Sol taraftaki menüde < > Düzenleyici görünümünü seçin.
- Code.gs dosyasını main.gs olarak yeniden adlandırın. Bunun için, fareyle Code.gs kod dosyası adının üzerine gelin, içerik menüsünden Yeniden Adlandır'ı seçin ve
maindeğerini girin. Arayüz .gs uzantısını otomatik olarak ekler. - Soldaki menüde dişli simgesini (Proje Ayarları) seçip "appscript.json" manifest dosyasını göster seçeneğini etkinleştirerek projenin appscript.json manifest dosyasını görünür hale getirin.
- Apps Komut Dosyası web arayüzünde, sol taraftaki < > Düzenleyici görünümünü seçin.
- Dosyalar başlığının sağındaki + (artı) simgesini, ardından Komut dosyası'nı seçip
uiyazarak bir ui.gs kod dosyası oluşturun. slides.gsveai.gskod dosyalarını oluşturmak için önceki adımı tekrarlayın.
Apps Komut Dosyası projeniz artık çoğunlukla boş olan aşağıdaki 5 kod dosyasını içeriyor olmalıdır:
- appscript.json
- main.gs
- ui.gs
- slides.gs
- ai.gs
Sıradaki adım için, proje kodunu depodan alın ve Apps Komut Dosyası projenize kopyalayın.
Proje kodunu alma
Slaytlar Danışmanı projesinin kodu, bir kod deposunda barındırılır. Bu kodda çalışmak için kodu Apps Komut Dosyası projenize kopyalamanız gerekir. Bu bölümde proje kodunun nasıl edinileceği 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ı seçin ve kodu, önceki kodlarla değiştirerek kod düzenleyici paneline yapıştırın.
- Diğer 4 kod dosyası için de bu işlemi tekrarlayın:
Google Cloud projesini bağla
Bu proje, Gemini AI modellerine erişmek için bir Google Cloud projesi kullanır. Google Cloud, özel veri gizliliği politikalarının yanı sıra Slaytlar Advisor gibi uygulamalar derlemek için birçok faydalı yazılım hizmeti sunar. AI API erişimi olan bir Cloud projesi oluşturarak, proje için hizmet hesabı oluşturarak, hizmet hesabı için bir anahtar oluşturarak ve bu anahtarı Eklenti projenize yükleyerek Eklenti kodunu Gemini API'ye bağlarsınız.
Cloud projesi yapılandırın
Gemini API'ye bağlanmak için kullandığınız Cloud projesinde Vertex AI API hizmeti etkinleştirilmiş olmalıdır ve bu projeye Slaytlar Danışmanı eklentisinden kimliği doğrulanmış bağlantı oluşturmanız gerekir. Vertex AI API'yi kullandığınız projelerde faturalandırmanın da etkinleştirilmiş olması gerekir.
Vertex AI API erişimi olan bir Cloud projesi yapılandırmak için:
- Google Cloud Console'a gidin ve gerekirse oturum açın.
- Google Cloud konsolunda mevcut bir Cloud projesini seçin veya yeni proje oluşturun.
- Projenizin konsolunun Kontrol paneli sayfasında, API'ler panelinde API'lere genel bakışa git'i seçin veya https://console.cloud.google.com/apis/ adresine gidin.
- API'ler ve Hizmetler sayfasının üst kısmında + API'LERİ VE HİZMETLERİ ETKİNLEŞTİR'i seçin.
- API Library sayfasında
vertex ai apiaraması yapıp Vertex AI API seçeneğini belirleyin, ardından Etkinleştir düğmesini seçin. - Etkin değilse Google Cloud projeniz için faturalandırmayı etkinleştirmelisiniz. Ardından Vertex AI API konsol sayfasındaki Etkinleştir düğmesini seçerek AI API'yi etkinleştirmeniz gerekir.
- Projenizin API'ler ve Hizmetler sayfasına giderek Vertex AI API'nin etkinleştirildiğini doğrulayın. Bu sayfada artık Vertex AI API'nin listelendiğini göreceksiniz.
Hizmet hesabı oluşturma
Slaytlar Danışmanı Eklentisi, Vertex AI API ve Gemini modellerine erişmek için Cloud projenize kimliği doğrulanmış bağlantı gerektirir. Bu bağlantıyı, önce Cloud projenizde Vertex AI API'ye erişimi olan bir hizmet hesabı oluşturarak oluşturursunuz. Slaytlar Danışmanı projesi bu hizmet hesabı kullanılarak bağlanır.
Slaytlar Danışmanı Eklentisi için bir hizmet hesabı oluşturmak üzere:
- Google Cloud konsolunda Cloud projenizin API'ler ve Hizmetler sayfasına gidin.
- Sayfanın sol tarafında Credentials'ı (Kimlik bilgileri) seçin.
- Sayfanın en üstünde + KİMLİK BİLGİLERİ OLUŞTUR > Hizmet hesabı'nı seçin.
- 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.
- Grant this service account access to project (Bu hizmet hesabına projeye erişim izni ver) bölümünde Rol denetimini seçin.
- Filter field search (Filtre) alanında Vertex AI User izin grubunu ve ardından Continue'yu (Devam) seçin.
- Bitti'yi seçerek bu hizmet hesabı oluşturma işlemini tamamlayın.
Hizmet hesapları oluşturma hakkında daha fazla bilgi için Google Cloud Hizmet hesapları oluşturma belgelerine bakın.
Hizmet hesabı anahtarı oluşturun ve yükleyin
Slaytlar Danışmanı projesinin önceki prosedürde oluşturduğunuz hizmet hesabının kimliğini doğrulayabilmesi gerekir. Hizmet hesabı için bir anahtar oluşturup bu anahtarı Slaytlar Advisor Apps Komut Dosyası projenizde Komut Dosyası Mülkü olarak yapılandırarak bu kimlik doğrulamasını etkinleştirebilirsiniz. Aşağıdaki prosedürde, anahtarın nasıl oluşturulacağı ve projenizde nasıl yapılandırılacağı açıklanmaktadır.
Hizmet hesabı anahtarı oluşturmak ve yapılandırmak için:
- Google Cloud konsolunda Cloud projenizin API'ler ve Hizmetler sayfasına gidin.
- Sayfanın sol tarafında Credentials'ı (Kimlik bilgileri) seçin.
- Hizmet Hesapları bölümünde, oluşturduğunuz hizmet hesabını bulun, hesabın e-posta adresini veya kalem simgesini seçerek düzenleyin.
- Hizmet hesabı düzenleme penceresinde, sayfanın üst kısmına yakın bir yerde bulunan ANAHTARLAR sekme başlığını seçin.
- Anahtarlar bölümünde Anahtar Ekle > Yeni anahtar oluştur'u seçin.
- Create private key for... iletişim kutusunda JSON'u ve ardından Create'i (Oluştur) seçin. Bu adımda projectid-hashcode.json adlı bir anahtar dosyası oluşturulur ve dosya otomatik olarak bilgisayarınıza indirilir.
- İndirilen projectid-hashcode.json dosyasını açın ve içeriğini kopyalayın.
- Slaytlar Danışmanım projesini içeren Apps Komut Dosyası web arayüzünü açın ve soldaki menüden Ayarlar görünümünü seçin.
- Komut Dosyası Özellikleri bölümünde, Komut dosyası özelliklerini düzenle düğmesini ve ardından Komut dosyası özelliği ekle düğmesini seçin.
- Yeni Property (Özellik) alanına
SERVICE_ACCOUNT_KEYyazın ve Value (Değer) alanına, indirilen projectid-hashcode.json dosyasının içeriğini kopyalayın. - Komut dosyası özelliklerini kaydet düğmesini seçerek yeni özelliği kaydedin.
Hizmet hesabı anahtarları oluşturma hakkında daha fazla bilgi için Google Cloud Hizmet hesabı anahtarları oluşturma ve silme belgelerine bakın.
Eklenti projesini test etme
Slide Advisor projesini test etmek için, eklenti kodu için bir test dağıtımı oluşturmanız ve bu test dağıtımını yüklemeniz gerekir. Bu test yapılandırmasında, proje yalnızca Apps Komut Dosyası Eklentisi projesine başladığınız Google Slaytlar sunusunda ve başka hiçbir Slaytlar sunusunda kullanılamaz. Google Workspace Apps Komut Dosyası dokümanlarındaki Dağıtım oluşturma ve yönetme konusunda Eklentinizi daha kapsamlı kullanım için dağıtma hakkında daha fazla bilgi edinebilirsiniz.
Apps Komut Dosyası proje kodunu dağıtmak ve test etmek için:
- Apps Komut Dosyası web arayüzünün üst kısmında, Dağıt > Dağıtımları test et'i seçin.
- Dağıtımları test et iletişim kutusunda, Tür seç'in yanındaki dişli simgesini ve Google Workspace Eklentisi'ni seçin.
- Uygulamalar: Slaytlar başlığının yanındaki Yükle düğmesini seçin.
- Son kodu test et varsayılan ayarlarını değiştirmeden Bitti'yi seçin.
- Apps Komut Dosyası projenize bağlı Google Slaytlar sunusuna gidin ve web sayfasını yeniden yükleyin.
- Slaytlar web uygulamasının sağ alt köşesinde yan paneli açmak için ( < ) simgesini seçin ve ardından Slaytlar Danışmanı panelini açmak için siyah beyaz göz simgesini seçin.
Bu adımı tamamlayıp Eklentiyi başarıyla çalıştırdıktan sonra, farklı yönergeler kullanmak veya farklı bir iş akışı izlemek için eklentiyi değiştirmeye başlayabilirsiniz. Slides Advisor Eklentisinde bazı temel değişikliklerin nasıl yapılacağıyla ilgili talimatlar için sonraki bölümlere bakın.
Yorum davranışını değiştirme
Slaytlar Danışmanının inceleme davranışını, eklentinin proje kodunu değiştirerek hem Gemini API'den aldığınız çıkışı hem de eklentinin sağladığı kullanıcı arayüzü açısından değiştirebilirsiniz. Bu eğitim, sunu slaytı inceleme davranışını değiştirmek için istem talimatlarını değiştirmeye odaklanmaktadır. Apps Komut Dosyası'nı kullanarak Google Slaytlar kullanıcı arayüzünü genişletme hakkında daha fazla bilgi için Google Slaytlar dosyalarını genişletme bölümüne bakın.
Yorum kurallarını değiştir
Slaytlar Danışmanı basitlik, renk ve tipografi, yapı ve boşluk kategorileri, grafikler ve simgeler içeren bir dizi temel slayt inceleme yönergesiyle programlanmıştır. İnceleme yönergeleri, Gemini API aracılığıyla gönderilen bir isteme, seçili bir slaydın anlık görüntüsüyle ve konuşmacı notlarına eklenen metin talimatlarından ibarettir.
Metin talimatlarını değiştirerek Eklentinin inceleme davranışını değiştirebilirsiniz. Örneğin, Gemini modeline, kategori derecelendirmesi kategori başlığıyla aynı satırda olacak şekilde yorumun çıkışını verebilir veya bir kategorinin adını değiştirebilirsiniz.
Kategori puanı konumunu ve kategori adını değiştirmek için:
- Slaytlar Danışmanım projesini içeren Apps Komut Dosyası web arayüzünü açın. Gerekirse Apps Komut Dosyası projesini içeren Google Slaytlar sunusunu açıp Uzantılar > Apps Komut Dosyası'nı seçerek proje penceresine gidin.
- Soldaki menüde < > Düzenleyici görünümünü ve ardından ai.gs dosya adını seçin.
- ai.gs kod dosyasında
SYSTEM_PROMPTdize sabitini bulun ve kalın metinle birlikte talimatları 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_PROMPTdize sabitinde,Simplicitykategori metniniMessageolarak değiştirin: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 Dosyası projenize bağlı Google Slaytlar sunusuna gidin, web sayfasını yeniden yükleyin ve Eklentiyi yeniden çalıştırarak değişiklikleri test edin.
Slaytlar Danışmanı Eklentisi için henüz bir test dağıtımı oluşturmadıysanız Eklenti projesini test etme bölümündeki talimatları uygulayın.
İnceleme şartlarınıza uyacak şekilde SYSTEM_PROMPT dizesi sabit değerindeki yorum kategorisi talimatlarını kaldırabilir, değiştirebilir veya yeniden yazabilirsiniz. Farklı inceleme istemi yaklaşımlarını denemek veya yorum isteminin tamamını yeniden yazmak isterseniz Google AI Studio web uygulamasına göz atın. Gemini istemlerinin prototipini oluşturmanıza, test etmenize ve kaydetmenize olanak tanıyan bu uygulama, Slaytlar Advisor projesiyle aynı Gemini API'sini kullanır. AI Studio'yu kullanma hakkında daha fazla bilgi için AI Studio hızlı başlangıç kılavuzuna bakın.
Model davranışı yapılandırmasını değiştirme
Gemini API, bir istek istemine yanıt olarak modelin genel işlemini değiştirmek için çeşitli ayarlar sağlar. Özellikle, modelin sıcaklık ayarı, sıfır en düşük ve 1 en yüksek olmak üzere modelin bir yanıtta ne kadar varyasyona izin verileceğini ayarlamanıza olanak tanır. Bu değerin 0,1 olarak ayarlanması çok tutarlı yanıtlar üretir, ancak bu davranış tekrarlanan ve yorum geri bildirimi alan kullanıcılar açısından daha az yararlı görünebilir. Sıcaklık değerini daha yüksek bir değere ayarlamayı düşünün. Sıcaklık ne kadar yüksek olursa sonuçlarınızın o kadar tutarsız olabileceğini unutmayın. Bu duruma, talimatların farklı şekilde uygulanması, hatta bazı talimatların tamamen yoksayılması da dahil olabilir.
Yorum yanıtlarının sıcaklığını artırmak için:
- Slaytlar Danışmanım projesini içeren Apps Komut Dosyası web arayüzünü açın.
- Soldaki menüde < > Düzenleyici görünümünü ve ardından ai.gs dosya adını seçin.
ai.gs kod dosyasında
analyzeSlides()işlevini bulun vetemperaturedeğerini0.3olarak ayarlayarakgenerationConfigsabitini değiştirin:function analyzeSlides(slide) { const generationConfig = { temperature: 0.3, maxOutputTokens: 1024 * 2, };ai.gs kod dosyasında yapılan değişiklikleri kaydedin.
Apps Komut Dosyası projenize bağlı Google Slaytlar sunusuna gidin, web sayfasını yeniden yükleyin ve Eklentiyi yeniden çalıştırarak değişiklikleri test edin.
Model davranışı yapılandırma ayarları hakkında daha fazla bilgi için GenerationConfig ile ilgili Gemini API dokümanlarına bakın.
Ek kaynaklar
Slaytlar Danışmanı projesi hakkında daha fazla bilgi için kod deposunu inceleyin. Uygulamayı oluşturma konusunda yardıma ihtiyacınız varsa veya diğer geliştiricilerle ortak çalışma yapmak istiyorsanız Google Developers Community Discord sunucusuna göz atın. Daha fazla Build with Google AI projesi için video oynatma listesine göz atın.