Confluence Düğümü (Node)
Confluence node'u, SkyStudio workflow'larında Atlassian Confluence ile entegrasyon sağlar. Confluence sayfalarını, alanlarını ve blog yazılarını okuyabilir; AI destekli doğal dil sorguları çalıştırabilirsiniz.
🎬 Videoyu izlemek için tıklayın →
Bağlantı Kurulumu ve Yönetimi
Confluence node'unu kullanabilmek için önce bir Atlassian bağlantısı oluşturmanız gerekir.
Yeni Bağlantı Ekleme
- SkyStudio'nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
- Yeni Bağlantı Ekle butonuna tıklayın.
- Aşağıdaki bilgileri doldurun:
| Alan | Açıklama | Örnek |
|---|---|---|
| Bağlantı adı | Bu bağlantıya vermek istediğiniz isim | Şirket Confluence |
| Sağlayıcı | Bağlantı türü | Confluence |
| Confluence Cloud alan adı | Atlassian hesabınızın subdomain'i | sirketim.atlassian.net |
| E-posta | Atlassian hesabınıza kayıtlı e-posta | kullanici@sirket.com |
| API Token | Atlassian API token'ı | ATATT3xFfGF0... |
API Token Oluşturma
- id.atlassian.com/manage-profile/security/api-tokens adresine gidin.
- Create API token butonuna tıklayın.
- Token'a bir etiket verin (örn.
SkyStudio) ve oluşturun. - Oluşturulan token'ı kopyalayıp SkyStudio'daki API Token alanına yapıştırın.
Not: API token yalnızca bir kez görüntülenebilir. Hemen kopyalamayı unutmayın.
Bağlantıyı Node'a Atama
Confluence node'unu canvas'a sürükledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden daha önce oluşturduğunuz bağlantıyı seçin. Manuel mod seçildiğinde bağlantı bilgilerini doğrudan alana girebilirsiniz.
Operasyonlar
Confluence node'u 7 operasyon sunmaktadır:
| Operasyon | Kategori | Açıklama |
|---|---|---|
| Alanları listele | Öne Çıkan | Confluence'daki tüm alanları (space) listeler |
| Confluence AI Asistan | Öne Çıkan | Doğal dil sorgusuyla Confluence verilerini sorgular |
| Sayfaları listele | Standart | Belirli bir alandaki sayfaları listeler |
| Sayfaları İçeriğini Getir | Standart | ID ile tek bir sayfanın içeriğini getirir |
| Alt Sayfaları Getir | Standart | Bir sayfanın alt sayfalarını getirir |
| Sayfa Tarihçesini Getir | Standart | Bir sayfanın revizyon tarihçesini getirir |
| Blog Sayfalarını Getir | Standart | Belirli bir alandaki blog yazılarını getirir |
Alanları Listele
Confluence hesabınızdaki tüm alanları (space) döndürür. Hangi alanlara erişiminiz olduğunu keşfetmek ve Space Key değerlerini öğrenmek için kullanılır.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Confluence bağlantısı |
| Space Type | Hayır | Alan türü filtresi (global, personal vb.) |
| Get All (Auto Paginate) | Hayır | Tüm sonuçları otomatik sayfalayarak getirir |
| Limit | Hayır | Getirilecek maksimum kayıt sayısı |
Örnek Çıktı
{
"results": [
{
"id": "123456",
"key": "TECH",
"name": "Teknik Dokümantasyon",
"type": "global",
"status": "current"
}
]
}
Confluence AI Asistan
Doğal dil kullanarak Confluence verilerini sorgulamanızı sağlar. Karmaşık Confluence sorgularını yazmadan bilgiye ulaşmak için idealdir.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Confluence bağlantısı |
| Query | Evet | Doğal dilde arama sorusu |
| System Prompt | Hayır | AI asistanının davranışını özelleştiren sistem talimatı |
Kullanım Örneği
Query: "Onboarding süreciyle ilgili sayfaları bul"
System Prompt: "Yalnızca son 6 ayda güncellenen sayfaları dikkate al"
İpucu: System Prompt ile AI asistanına belirli bir alan, yazar veya zaman dilimi gibi kısıtlamalar tanımlayabilirsiniz.
Sayfaları Listele
Belirli bir Confluence alanındaki (space) sayfaların listesini döndürür.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Confluence bağlantısı |
| Space Key | Hayır | Sayfa listesinin alınacağı alan anahtarı (örn. TECH) |
| Expand Fields | Hayır | Yanıtta genişletilecek ek alanlar |
| Get All (Auto Paginate) | Hayır | Tüm sonuçları otomatik sayfalayarak getirir |
| Limit | Hayır | Getirilecek maksimum sayfa sayısı |
| File Path | Hayır | Sonucun kaydedileceği dosya yolu |
Örnek Çıktı
{
"results": [
{
"id": "98765",
"title": "API Entegrasyon Rehberi",
"space": { "key": "TECH" },
"version": { "number": 5 },
"_links": { "webui": "/spaces/TECH/pages/98765" }
}
]
}
Sayfaları İçeriğini Getir
Sayfa ID'si ile Confluence'daki bir sayfanın tam içeriğini getirir.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Confluence bağlantısı |
| Page ID | Evet | İçeriği alınacak sayfanın Confluence ID'si |
| Body Format | Hayır | İçerik formatı (storage, view, export_view vb.) |
| File Path | Hayır | Sonucun kaydedileceği dosya yolu |
Page ID Nasıl Bulunur?
Confluence'da sayfayı açın. URL'deki /pages/ kısmından sonra gelen sayısal değer Page ID'dir.
Örnek: https://sirketim.atlassian.net/wiki/spaces/TECH/pages/98765 → Page ID: 98765
Body Format Seçenekleri
- storage — Confluence'ın iç XML formatı (varsayılan)
- view — HTML görünüm formatı
- export_view — Dışa aktarım için optimize edilmiş HTML
Alt Sayfaları Getir
Bir üst sayfanın (parent page) doğrudan veya tüm hiyerarşik alt sayfalarını getirir. Sayfa ağaçlarını haritalamak için kullanışlıdır.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Confluence bağlantısı |
| Page ID | Evet | Alt sayfaları listelenecek üst sayfanın ID'si |
| Recursive (All Children) | Hayır | Etkinleştirilirse tüm hiyerarşideki alt sayfaları getirir |
| Limit | Hayır | Getirilecek maksimum alt sayfa sayısı |
| File Path | Hayır | Sonucun kaydedileceği dosya yolu |
Recursive Modu Hakkında
Recursive (All Children) seçeneği kapalıyken yalnızca bir seviye aşağıdaki doğrudan alt sayfalar döner. Açık olduğunda tüm hiyerarşi (torunlar dahil) getirilir.
Sayfa Tarihçesini Getir
Bir Confluence sayfasının tüm revizyon geçmişini döndürür. Kim, ne zaman değiştirdi bilgisiyle denetim ve takip senaryoları için uygundur.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Confluence bağlantısı |
| Page ID | Evet | Tarihçesi alınacak sayfanın Confluence ID'si |
| File Path | Hayır | Sonucun kaydedileceği dosya yolu |
Örnek Çıktı
{
"results": [
{
"number": 7,
"when": "2024-11-15T10:23:00.000Z",
"by": { "displayName": "Ahmet Yılmaz" },
"message": "Kurulum adımları güncellendi"
}
]
}
Blog Sayfalarını Getir
Belirli bir Confluence alanındaki blog yazılarını (blog posts) listeler.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Confluence bağlantısı |
| Space Key | Hayır | Blog yazılarının alınacağı alan anahtarı (örn. TEAM) |
| Limit | Hayır | Getirilecek maksimum blog yazısı sayısı |
| File Path | Hayır | Sonucun kaydedileceği dosya yolu |
Hızlı Başlangıç Örnekleri
Örnek 1: Teknik Dokümantasyon Arama Asistanı
Kullanıcının doğal dilde sorduğu soruya Confluence'dan cevap bulan bir workflow:
Metin Girişi → Confluence AI Asistan → Metin Çıktısı
Confluence AI Asistan ayarları:
- Query:
{{input.text}} - System Prompt:
"Yalnızca TECH alanındaki sayfalara bak. Cevabı Türkçe ver."
Örnek 2: Haftalık Dokümantasyon Raporu
Her hafta güncellenen sayfaları listeleyip ekibe rapor gönderen workflow:
Schedule → Sayfaları Listele → LLM (özetle) → Slack Mesajı
Sayfaları Listele ayarları:
- Space Key:
TECH - Get All (Auto Paginate): Açık
- Limit:
50
Örnek 3: Sayfa Hiyerarşisi Çıkarma
Ana dokümantasyon sayfasının altındaki tüm sayfaları listeleyen workflow:
Metin Girişi (Page ID) → Alt Sayfaları Getir → JSON'dan Tabloya → Tablo Çıktısı
Alt Sayfaları Getir ayarları:
- Page ID:
{{input.text}} - Recursive (All Children): Açık
Sık Karşılaşılan Hatalar
| Hata | Olası Neden | Çözüm |
|---|---|---|
401 Unauthorized | Geçersiz API token veya e-posta | Bağlantı ayarlarını kontrol edin, token'ı yenileyin |
403 Forbidden | Sayfaya erişim izni yok | Atlassian'da kullanıcı izinlerini kontrol edin |
404 Not Found | Geçersiz Page ID veya Space Key | ID/Key değerlerini Confluence URL'sinden doğrulayın |
429 Too Many Requests | API istek limiti aşıldı | İstekler arasına gecikme ekleyin veya limit değerini düşürün |
Space not found | Yanlış Space Key | Alan listesini "Alanları Listele" ile kontrol edin |
Notlar
- File Path parametresi, büyük veri döndüren operasyonlarda sonucu doğrudan bir dosyaya kaydetmek için kullanılır. Workflow içinde daha sonra bu dosyayı işleyebilirsiniz.
- Get All (Auto Paginate) seçeneği çok sayıda kayıt olan alanlarda yavaşlamaya yol açabilir; Limit ile birlikte kullanmanız önerilir.
- Confluence Cloud ve Confluence Server API'leri farklıdır; bu node Confluence Cloud (Atlassian Cloud) için tasarlanmıştır.