# Ajanlar ve şirket

## Ajanlar ve şirket

### Ajanlar (Agents)
Organizasyon şeması ve her ajan. Bir ajanın sayfasında (2.13.0'dan beri) solda profili (durum, rol, kime bağlı olduğu,
açık işler, son çalışma ve **Background work**: her rutin bir anahtarla), **Try it** (yan panelde onunla gerçek bir
sohbet) ve şu sekmeler vardır:

| Sekme | İçindekiler |
|---|---|
| Overview | Tuval: onu besleyenler (rutinler, onu uyandıranlar, kanallar, bellek ve kütüphane) ve kullandıkları (gruplara göre araçlar, beceriler, ekibi), kartına bağlı; her kart ayrıntılarını ve nerede değiştiğini açar |
| Activity | Çalışmaları: çalışanlar, sizi bekleyenler, bitenler; her biri adımlarına açılır |
| Skills | Kullandığı beceriler |
| Calendar | Önümüzdeki yedi günü: rutinlerinin çalışmaları ve ayarladığı randevular |
| Identity | Talimatları; geçmişi ve geri yüklemesiyle sürümlenir |
| Files | Başvuru dosyaları (her zaman erişebilir) |
| Memory | Hatırladıkları |
| Voice | Sesi ve konuşma tarzı, ve **call lessons** (arama dersleri; her birini kapatın veya açın, geri alın, kaldırın, ekleyin) |
| Settings | Ad, unvan, simge, yönetici, günlük çalışma sayısı, Claude **model** ve **effort** (ya da şirketin varsayılanı), kullanabileceği gizli anahtarlar, **Can propose new agents**, **Can use the office browser**, duraklatma, kaldırma |

**Add agent**, hazır bir ayardan veya sıfırdan bir ajan oluşturur. Bir koordinatör de bir tane önerebilir; Inbox'ta onayınızı bekler.

**Model ve effort (2.14.0'dan beri).** Her ajan Claude ile çalışır. Settings → Runners → **The agents' Claude**, tüm
ajanların modelini (Opus, Sonnet, Haiku, Fable ya da başka bir kimlik) ve effort düzeyini (Low, Medium, High, Extra
high) belirler; bir ajanın kendi Settings sekmesi farklısını seçebilir (sahipler ve yöneticiler seçer; üyeler görür).
Yüksek effort daha uzun düşünür ve şirketin
Claude planından daha çok kullanır; hızlı ve sık bir iş (günlük rapor) Haiku ya da Low ile iyi gider. Değişiklik
ajanın bir sonraki çalışmasından itibaren geçerlidir.

### Lumate kendi hakkında ne bilir (2.6.0'dan beri)
Lumate çalıştığı sürümü ve son sürümlerin neler eklediğini bilir ve nasıl yapılır sorularını bu rehberden yanıtlar
(sohbette ve sesle `product_help` aracı): "WhatsApp'ı nasıl bağlarım?", "yenilik ne?". Bir güncellemeden sonra sahip ve
yöneticilere bir Inbox bildirimi gelir ve Help → What's new her sürümün değişikliklerini listeler.

### Bilgi (Knowledge)
Ekibin hatırladıkları. Her bellek kaynağını (bir mesaj, bir dosya, bir çalışma), kimin oluşturduğunu ve durumunu gösterir.
Birini seçin; sağda tüm sürümleriyle tamamını okursunuz (2.13.0'dan beri). **Ask the library**, sorunuzla Librarian
ile (yoksa Lumate ile) bir sohbet başlatır.
- **Correct:** bir ajana söyleyin veya belleği burada yenisiyle değiştirin.
- **Disputed:** bir şeyin çeliştiği bellek, siz karar verene kadar disputed olarak işaretlenir.

### Beceriler (Skills)
Kategoriye göre yerleşik katalog, şirketin becerileri ve GitHub veya skills.sh'den içe aktarmalar: sabitlenmiş, önizlemeli, yalnızca talimat. **Try**, bir beceriyi bir ajan üzerinde çalıştırır. Katalog güncellemeleri uygulayabileceğiniz yeni revizyonlar olarak görünür.

### Entegrasyonlar (Integrations)
Üstte (2.13.0'dan beri) bağlantılar ve durumları: WhatsApp, OpenAI, Claude, ofis tarayıcısı, telefon, e-posta ve uç
noktalar; her biri kurulduğu yere götürür. Altında, dış sistemlerin çağırdığı uç noktalar. Örneğin bir Bitrix24 otomasyon kuralı yeni bir potansiyel müşteri gönderir.
- **Her çağrı:** bir ajan için görev olur; veri dış bilgi olarak işaretlenir.
- **Birini açmak:** bir yönetici uç noktayı açar, adresini ve belirtecini (token) bir kez alır ve test edebilir.
- **Activity:** her çağrı listelenir.

### Etkinlik (Activity)
**Runs** (2.13.0'dan beri): her ajanın her çalışması, **Running**, **Needs you** ve **Done** olarak sayılır (her biri
bir filtre); bir çalışma adımlarına ve her adımın süresine açılır; işi sizi bekleyen bir çalışma **Review** sunar. Bir
çalışmanın kendi sayfası adımlarını bir zaman çizelgesi olarak gösterir. **Log**, olan her şeyi en yenisi başta tutar:
- ajan araç çağrıları;
- ayar değişiklikleri;
- tarayıcı değişiklikleri;
- WhatsApp bağlantıları;
- eşleştirme.

### Sunucu sayfası (2.16.0'dan beri)

Lumate'i bir sunucuya kuran kişi (kurulum yöneticisi) için: şirket menüsünde **Server** ya da `/server` adresi. Hiçbir
şirkete ait değildir; yalnızca sunucuyu yöneten biri şirketlerin adlarını ve System status'ta her birinin parçalarının
çalışıp çalışmadığını görür; Lumate içlerindeki hiçbir şeyi göstermez (sunucunun yedekleri ise her şeyi tutar: onları
güvende tutun).

| Bölüm | Ne yapar |
|---|---|
| **Companies** | Şirketlerin adları. Lisans izin verdikçe **Add a company**. |
| **Company set-up link** | Bir yöneticiye verilen bağlantı (ilk kurulumda "Someone else"): kimin için, ne zamana kadar, **New link**, **Revoke**; kullanıldıktan sonra kimin aldığı ve hangi şirketi kurduğu. Bağlantıyı alan yöneticinin şirketi kurmak için bir haftası vardır; o zamana kadar **Take it back** yine geri alır. Şirketi kurulunca form bir sonraki şirket için yeniden görünür. Önce Lumate etkinleştirilmelidir: duraklatılmış bir kurulumda yönetici hiçbir şey yapamaz. |
| **System status** | Sunucunun ve her şirketin her parçası (aşağıya bakın). |
| **Send diagnostics to OXS** | Aşağıya bakın. |
| **Updates**, **Backups**, **Licence** | Sunucunun kendisininkiler (sunucu sürümünde bir şirketin ayarlarında değil, burada). |

### Durum ve tanılama (2.16.0'dan beri)

**System status** her parça için bir satır gösterir; durumu kelimeyle ve ne yapılacağıyla: sunucu ve veritabanı,
lisans, güncellemeler, yedekler; her şirket için Claude'un çalıştırıcısı (bir saattir görülmüyorsa kırmızı), WhatsApp,
masa telefonu hattı (ve onu taşıyan bağlı bilgisayar), ofis tarayıcısı ve OpenAI anahtarı. Lumate'i kuran kişi Sunucu
sayfasında görür; bir şirketin sahipleri ve yöneticileri kendilerininkini **Settings → Status**'ta görür.

**Send diagnostics to OXS**, bir şey çalışmadığında OXS'in bakması içindir:

1. İsterseniz bir not yazın ("arama listesi 10:20'de durdu").
2. **Preview**, gidecek her kelimeyi gösterir: sürüm, her parçanın durumu (şirketler adla değil numarayla), haftanın
   hataları tür ve koddaki yere göre sayılmış, ve notunuz yazdığınız gibi. Asla bir isim, telefon numarası, mesaj, döküm
   ya da dosya; asla bir hatanın kendi metni.
3. **Send to OXS**, önizlemenin gösterdiğini aynen ve bir kez, kurulumun lisansıyla gönderir (önizleme çeyrek saat
   tutulur; sonra yeniden bakın). Her yer günde en çok beş kez gönderir: Sunucu sayfası ve her şirketin Settings →
   Status sayfası. OXS Cloud'a bağlanmayan bir kurulum ya da OXS'in alamadığı bir an bunu söyler: **Download file** aynı
   şeyi başka bir yoldan göndermek için kaydeder.

### Ayarlar (Settings)
Sayfalar solda gruplanmıştır; telefonda üstteki listeden birini seçin.

| Grup | Sayfa | Ne için |
|---|---|---|
| Company | General | Şirket adı, önek, saat dilimi |
| | Sector | Şirketin sektörü ve ülkesi (sahip önizlemeyle değiştirir) |
| | Members | Davetler, roller, kişileri kaldırma |
| | Your account | Görünen adınız, parolanız, e-postanız ve hangi bildirimlerin oraya gideceği, bildirim telefonu ve **My desk phone** (kendi dahili numaranız; 2.15.0'dan itibaren) |
| Voice & phone | Voice | Ses modelleri ve diller; **Coach analyses every rehearsal** |
| | Desk phone | Şirket ağındaki, bir ajanla konuşan IP telefon ve bağlantının nerede çalıştığı (aşağıda) |
| | Phone | OpenAI projesi, numaralar, gelen arama senaryosu, aktarma, incelemeler, giden hat, aranmak istemeyenler listesi (Lumate Local'de yok) |
| | Call center | Yapay zeka dialer'ı, **Who calls** ve **Broker access** |
| Channels | WhatsApp | Bir numara bağlayın (QR veya eşleştirme kodu), durumu, bağlantıyı kaldırma, **Write out voice notes**, **Personal chats** |
| | Email | Lumate'in e-postasını gönderen şirket posta kutusu: Microsoft 365, Google Workspace veya başka bir sunucu, gönderen, sınırlar ve test (bkz. [Email](/tr/docs/email)) |
| | Browser | Ofis tarayıcısı: kurulum (ya da **On a linked PC** → **Use this PC**), durum, izinli siteler (ajanlar bir sohbetten de isteyebilir), duraklatma, bağlantıyı kesme, **Reconnect**; LinkedIn'in izin verdikleri ve ajanların bir güvenlik kontrolünde durduğu siteler |
| Team | Runners | Çalıştırıcı (runner) anahtarları, hangi çalıştırıcıların çevrimiçi olduğu, **The agents' Claude** (her ajanın, kendine ait bir seçimi yoksa çalıştığı model ve effort; 2.14.0'dan beri), Claude Code güncellemeleri; sunucu sürümünde **Claude for the runners** (şirketin Anthropic API anahtarı veya Claude oturum belirteci; sahipler ve yöneticiler ayarlar, bir daha gösterilmez) |
| | Secrets | Şirket gizli anahtarları: yalnızca yazılır, şifrelidir, her birinin hangi sunuculara gönderilebileceğiyle birlikte |
| | Team package | Ekibi dosya olarak kaydedin veya içe aktarın (aşağıda) |
| | Usage | On iki haftalık günlük ajan çalışmaları bir ısı haritası ve tablo olarak (sahipler ve yöneticiler; 2.13.0'dan beri) |
| | Apps | Arşivlenenler dahil her uygulama: açma, geri getirme ya da silme (sahipler ve yöneticiler; 2.14.0'dan beri) |
| System | Board | Pano kuralları, günlük rapor saati, varsayılan randevu sahibi |
| | Backups | Sunucu sürümü: her gün, her güncellemeden önce ve istendiğinde bir yedek; her biri indirilebilir ve bir kovaya (bucket) kopya (bkz. [The server edition](/tr/docs/install-server#backups)) |
| | Updates | Kanal, bakım penceresinde otomatik kurulumlar, yeni sürümler, **Update now** ve **Go back**; Lumate Local'in güncelleme klasörü, sunucu sürümünün çevrimdışı paketi (bkz. [Lumate Local](/tr/docs/install-windows#updates-and-backups) ve [The server edition](/tr/docs/install-server#updates)) |
| | Linked PCs | Sunucu sürümü: yöneticilerin bir kodla bağladığı, Lumate çalışan ofis bilgisayarları; her birinin çevrimiçi olup olmadığı, ne yaptığı (ofis tarayıcısı, masa telefonu), yeniden adlandırma, bağı kaldırma (2.15.0'dan itibaren; bkz. [Bir Lumate sunucusuna bağlanmak](/tr/docs/install-windows#connecting-to-a-lumate-server)) |

#### Masa telefonu (Desk phone)

Bir masa telefonu (şirket ağındaki bir IP telefon) bir ajanla konuşabilir. Telefonu açıp ajanı arayın ya da ajanın sizi aramasını sağlayın.

**Hattı bağlamak**
- **Company PBX:** BT, Lumate için bir dahili oluşturur ve size santral adresini, dahiliyi ve parolasını verir. Lumate o dahili olarak kaydolur. Masa telefonunuzdan onu arar, ajan cevaplar; ajan da dahilinizi çaldırabilir.
- **Phone directly:** santral yoksa telefonun adresini girin. Ajan telefonu çaldırabilir, ama telefon ajanı arayamaz.

Lumate UDP üzerinden bağlanır (varsayılan port 5060).

**Arayanı bağlamak** (2.17.0'dan beri). Hattaki her aktarım danışmalıdır: Lumate arayanı tutar, meslektaşın dahilisini
kendisi çaldırır ve meslektaş açınca santralden iki aramayı birleştirmesini ister (Replaces ile SIP REFER; 3CX ve
Asterisk bunu destekler). Bunu reddeden bir santralde de çalışır: Lumate o zaman iki arama arasındaki sesi kendisi
taşır ve onlar kapatana kadar hat meşgul kalır. BT, Lumate'in dahilisinin diğer dahilileri aramasına izin verir; bunun
için dış hat yetkisi gerekmez.

**Aramayı ayarlamak**
- Cevaplayan **ajan**.
- **Mod:**
  - **Talk:** ajanla bir sohbetteki Talk düğmesindeki gibi konuşursunuz. Döküm yeni bir sohbete düşer. Uygulamadan başlattığınız bir aramada (**Desk phone**) ajan isteklerinizi çalışan tarafına aktarabilir. Masa telefonundan ajanı aradığınızda yalnızca konuşur ve arayanlar için ekibin paylaştıklarından yanıt verir, çünkü arayanın numarası tek başına kimin konuştuğunu kanıtlamaz.
  - **Rehearsal:** ajan bir arama senaryosunu yürütür ve müşteriyi siz oynarsınız. Arama Playground geçmişine düşer.
- **Who may call:** dahililer veya numaralar. Başka kimse cevaplanmaz.
- **Call me at:** dahiliniz (veya doğrudan modda telefonunuzun adresi).

**Açmak ve kapatmak**
- **Test line**, bağlantıyı kontrol eder ve neyin yanlış olduğunu sade bir dille söyler.
- **Anahtar** hattı açar, yalnızca Test line geçtikten sonra. Bağlantıyı değiştirmek onu yeniden kapatır.
- Kapatmak, sürmekte olan aramanın önce bitmesine izin verir.

**Uygulamadan aramak.** Hat açıkken bir ajanın sohbetinde Talk'un yanında bir **Desk phone** düğmesi, Playground'da ise **On the desk phone** görünür. Masa telefonunuzu o ajanla veya o ajan ve senaryoyla çaldırırlar.

**Kendi masa telefonunuz** (2.15.0'dan itibaren). Herkes masasındaki telefonun dahili numarasını Settings → **Your
account** → **My desk phone**'a yazar. Böylece:
- **Call me**, **Hand over** ve **Take over** düğmeye basan kişinin telefonunu çaldırır. Numara yazmamış olanlar için hattın
  **Call me at** numarası çalar.
- Kendi telefonunuzdan, **Who may call** listesine eklenmeden ajanı arayabilirsiniz. (Who may call, kimseye ait olmayan
  telefonlar için kalır; örneğin bir toplantı odası.)

**Bağlantının çalıştığı yer** (2.15.0'dan itibaren, sunucu sürümü). Lumate santralle, çalıştığı makineden konuşur. Sunucu
ofiste değilse (örneğin internette), ofisin santraline ulaşamaz. O zaman ofisteki **bağlanmış bir bilgisayar** hattı
taşır (bkz. [Bir Lumate sunucusuna bağlanmak](/tr/docs/install-windows#connecting-to-a-lumate-server)):
1. Settings → Desk phone → **Connection runs on**: bağlanmış bilgisayarı seçin.
2. **Test line**'a basın (bilgisayar santrale kaydolur), sonra hattı açın.
3. O bilgisayarı açık tutun. Kapalıyken hat **The bridge PC is offline** (köprü bilgisayar çevrimdışı) gösterir; Call me ve
   çağrı merkezi bekler. Bilgisayar giderse süren bir arama birkaç saniye içinde biter.

Gerisi ofisteki bir sunucuda olduğu gibi çalışır: ajan cevaplar, insanları arar, aramaları aktarır ve mesaj alır. Ses ve
ajanın işi sunucuda kalır; bilgisayar yalnızca sesi taşır.

#### Ekip paketi (Team package)

Bir ekip paketi (team package), bir ekibi Lumate kurulumları arasında taşır; örneğin bir yöneticinin PC'sinden sisteminizi kuran kişilere ya da bir demodan yeni bir şirkete. Yalnızca yöneticiler kullanabilir.

**Export** tek bir `.lumate-team` dosyası kaydeder.
- **İçerdikleri:** seçilen ajanların profilleri, talimatları, sesleri, becerileri ve arama senaryoları ve kullandıkları gizli anahtarların **adları**.
- **Asla içermedikleri:**
  - müşteriler, sohbetler, görevler, aramalar, ilanlar veya randevular;
  - bir gizli anahtarın değeri.
- **İsteğe bağlı eklentiler:** ajanların dosyaları ve bellekleri yalnızca işaretlerseniz girer, çünkü şirket veya müşteri bilgisi içerebilirler.
- **Şirket adı:** bir yer tutucu olur.
- **Preview**, kaydedilecek her şeyi ve şirket adınızın değiştirildiği her yeri listeler.

**Import**, bir şey değişmeden önce önizleme gösterir.
- **Her ajan** yeni, değişmiş (talimat değişiklikleriyle) veya aynı olarak listelenir.
- **Yeni ajanlar**, atlamazsanız eklenir.
- **Zaten sahip olduğunuz bir ajan için** şunu seçersiniz:
  - **Keep ours**;
  - **Update ours:** talimatlar yeni bir sürüm olur, eskisi geçmişinde kalır ve izinleri olduğu gibi kalır;
  - **Add as a separate agent**.
- **Şirkette olmayan gizli anahtarlar** adıyla oluşturulur ve bir değer bekler.
  - Değerleri içe aktarmanın hemen ardından ya da sonra Settings → Secrets altında girin; orada **Value needed** görünür.
  - Yöneticiler için bunlarla ilgili bir Inbox öğesi de açılır.

## Klavye kısayolları

| Tuşlar | Eylem |
|---|---|
| `⌘ K` veya `/` | Ara ve git |
| `c` | New task |
| `[` / `]` | Kenar çubuğunu / özellikler panelini aç veya kapat |
| `g` sonra `d`, `i`, `t`, `c`, `a` | Dashboard, Inbox, Tasks, Chats, Agents |
| `Enter` / `Shift Enter` | Gönder / yeni satır |
| `?` | Kısayolları göster |