Başlarken
Markdown olarakİlk kurulum
Boş bir sunucudan çalışan bir yapay zeka ekibine. Adımlar ekranları sırayla izler.
1. İlk hesap (kurulum belirteci)
İlk hesabı Lumate'i kuran kişi açar. 2.16.0'dan beri herkes e-postasıyla giriş yapar (daha önce açılmış hesaplar kullanıcı adlarını korur).
- Sunucu sürümü: yükleyicinin sonunda yazdığı bağlantıyı açın. Kurulum belirtecini içinde taşır; yalnızca
adınızı, e-postanızı ve bir parola (en az 10 karakter) yazarsınız. Bağlantıyı mı kaybettiniz? Yükleyici belirteci
de yazdı;
sudo grep SETUP_TOKEN /opt/agentx/.envde gösterir: adresi açın ve belirteci yazın. Lumate Local: belirteç yoktur: ilk açılış penceresi ilk hesabı oluşturur. - Etkinleştirme: kurulumda lisans anahtarı verilmiş (
--key) bir kurulum zaten etkindir: hiçbir şey sorulmaz. Verilmemişse aynı form şirketin adını bir kez sorar ve OXS hesabınız aynı e-posta ve parolayla açılır: yalnızca OXS'in e-postayla gönderdiği altı haneli kodu yazarsınız (yeni hesap 14 günlük deneme başlatır). Lisans anahtarı ya da çevrimdışı dosya da olur; bkz. Lisanslama. E-postanın başka bir parolayla OXS hesabı varsa Lumate bunu söyler ve o parolayı ister. - Şirketi kim kuracak?
- I will (ben): aşağıdaki şirket kurulumuna geçersiniz.
- Someone else (başkası): yöneticinin e-postasını yazın. Lumate onun için bir bağlantı yapar (7 gün, bir kez); kopyalayıp gönderin. Yönetici hesabını bu bağlantıyla açar ve şirketi kurar. Siz o şirketin üyesi olmazsınız: Lumate size müşterilerini, mesajlarını ve aramalarını göstermez (sunucunun yedekleri yine de hepsini tutar; onları ve sunucuya kimin erişebildiğini güvende tutun). Sizin yeriniz Sunucu sayfasıdır (durum, tanılama, güncellemeler, yedekler, lisans ve o bağlantı; bkz. Sunucu sayfası).
Belirteç yalnızca ilk hesap oluşana kadar işe yarar. Bu ilk kişi kurulum yöneticisi olur.
2. Şirket (onboarding)
Şirket kurulumu üç adımdır ve her şeyi bir kez sorar:
| Adım | Ne girersiniz |
|---|---|
| Company | Adı (lisansınızın hesabından dolu gelir), web sitesi (Lumate şirketin ne yaptığını oradan öğrenir; isteğe bağlı) ve saat dilimi (örneğin Asia/Dubai: tüm programlar, arama saatleri ve raporlar bunu kullanır). Görev öneki (2–6 harf; RIC-12 gibi görev numaralarında kullanılır) addan önerilir. |
| Departments | Şirketin ne yaptığı: departmanları (Real estate, Any business, Recruiting; ekibi kadar, ilki ana departman) ekiplerini, kişilerini ve sayfalarını getirir; ülkesi (Birleşik Arap Emirlikleri, Türkiye veya başka bir ülke) arama kurallarını belirler. Create company şirketi oluşturur. İkisi de sonra Settings → Departments bölümünden değiştirilebilir (bkz. Departmanlar ve ülkeler). |
| Connections | Claude ve OpenAI anahtarı tek ekranda, her biri çalışıp çalışmadığını söyler. Sunucu sürümünde şirketin Claude anahtarı ya da belirteci (veya sunucuda sudo agentx claude-login); kaynaktan kurulmuş bir sunucuda burada bir çalıştırıcı anahtarı üretilir. OpenAI anahtarı aramalar içindir. İkisini de atlayabilirsiniz: eksik olan, gelene kadar panelde yazar. |
Sonra Claude yanıt verir vermez kurulum görüşmesi açılır: Lumate şirketi sorar ve departmanlarını, ajanlarını ve uygulamalarını önerir (bkz. Lumate ile kurulum). Verdiğiniz departmanları ve web sitesini zaten bilir ve bir daha sormaz. Lumate Local'in ilk açılış penceresi departmanları yalnızca Choose departments yourself düğmesine basarsanız (veya birlikte gelen ekip paketi belirtiyorsa) sorar.
3. Claude'u bağlayın (çalıştırıcı)
Çalıştırıcı şirketin kendi Claude'unu kullanır: bir Anthropic API anahtarı ya da bir Claude hesabının oturum belirteci.
- Anthropic API anahtarı (işletmeler için önerilir): Ticari koşullar geçerlidir ve veri eğitim için kullanılmaz. Anahtarı Anthropic Console'da oluşturun.
- Şirketin Claude hesabı: Sunucu sürümünde
sudo agentx claude-loginhesabı sunucuda oturum açar (bkz. Sunucu sürümü). Bir Claude hesabının uzun ömürlü belirteci de çalışır: Claude Code olan herhangi bir bilgisayarda şirketin Claude hesabıyla oturum açın veclaude setup-tokenkomutunu çalıştırın;sk-ant-oat01-…yazdırır.
Nereye girilir:
- Sunucu sürümü: Settings → Runners → Claude for the runners (sahipler ve yöneticiler; şifreli saklanır, bir daha gösterilmez) ya da
sudo agentx claude-login. İlk şirket oluşunca çalıştırıcı kendini kurar. - Lumate Local: İlk açılış penceresinin Claude adımı, sonra Settings → General → Claude. Çalıştırıcı uygulamanın parçasıdır.
Settings → Runners çalıştırıcıyı birkaç saniye içinde çevrimiçi gösterir. Orada daha fazla anahtar üretebilir (örneğin başka bir bilgisayardaki çalıştırıcı için) ve iptal edebilirsiniz.
Deneyin: Chats → Lumate bölümünü açın ve "Merhaba, neler yapabilirsin?" yazın. Birkaç saniyede gelen yanıt çalıştırıcının çalıştığını gösterir.
4. İnsanları davet edin
Settings → Members:
- Bir rol (admin veya member) seçin ve kişinin e-postasını yazın. Her bağlantı yalnızca o kişi içindir, bir kez çalışır ve 7 gün sonra geçersiz olur. Settings → Email kuruluysa Lumate e-postayla gönderir (siz de kopyalayabilirsiniz); değilse bağlantıyı kopyalayıp gönderin. Kişi e-postasını bir kez onaylar (ilk sayfası bunu önerir, ya da Settings → Your account → Email); böylece Forgot password? onun için çalışır.
- Kişi bağlantıyı açar, adını ve bir parola yazar; bundan sonra o e-postayla giriş yapar. E-postanın burada zaten bir hesabı varsa giriş yapıp onunla katılır: kimsenin ikinci hesabı olmaz. Sonra kendisine ait olanla (masa telefonunun dahilisi) kısa bir karşılama görür; şirketin kurulum görüşmesini hiç görmez.
- Rolleri değiştirmek veya kişileri çıkarmak için aynı sayfayı kullanın. En az bir sahip her zaman kalır.
| Rol | Yapabilecekleri |
|---|---|
| Sahip / Yönetici | Şirketteki her şey: ayarlar, gizli anahtarlar, numaralar, üyeler, WhatsApp, tarayıcı kuralları, ajan izinleri |
| Üye | Günlük iş: sohbetler, görevler, müşteriler, randevular, mesajlar, ilanlar |
5. Ses (OpenAI)
Settings → Secrets →
OPENAI_API_KEYekleyin: şirketin OpenAI anahtarı. Değeri şifrelenir, bir daha gösterilmez ve ajanlara hiç verilmez.Settings → Voice:
Ayar Anlamı Voice model Gerçek zamanlı ses modeli Backend model Sesin araçlarının arkasındaki model Thinking Sesin ne kadar düşündüğü Talks with you in Sesin ekibinizle konuşurken kullandığı dil Calls in Müşteri aramalarında kullandığı dil Her ajanın bir Voice sekmesi vardır: sesi ve konuşma şekli.
Deneyin: bir ajanın sohbetini açıp mikrofona basın ya da Playground'a gidin.
6. Telefon numaraları (isteğe bağlı)
Telefon ve Asterisk bölümünü izleyin:
- OpenAI proje kimliği;
- webhook gizli anahtarı (
OPENAI_WEBHOOK_SECRET); - numaralar ve her birini hangi ajanın yanıtladığı;
- aktarma numarası;
- giden aramalar için hat ve
SIP_TRUNK_PASSWORD.
7. Müşteri panosu
Settings → Board:
| Ayar | Varsayılan | Anlamı |
|---|---|---|
| Hand to the manager after this many unanswered calls | 2 | Kart "Yöneticiye" sütununa taşınır |
| Minutes before calling again | 120 | "Cevap yok" kartının ne zaman yeniden aranacağı |
| Daily report time (company time) | 19:30 | Koordinatörün günün raporunu yazdığı saat |
| Who takes appointments by default | — | Yeni randevu isteklerinin gittiği kişi |
Panoyu hemen denemek için: Customers → ⋯ → Add sample customers 25 örnek müşteri ekler. Sonra aynı menüden kaldırabilirsiniz.
8. Bildirim telefonunuz
Settings → Your account → "Your phone for notifications". WhatsApp bağlıyken bu bildirimler WhatsApp'a da gelir:
- devirler ("Raj'ın size ihtiyacı var");
- randevu istekleri;
- günlük rapor;
- yeni WhatsApp mesajları (müşteri başına en fazla 30 dakikada bir).
9. WhatsApp (isteğe bağlı)
Settings → WhatsApp → QR kodla (ya da eşleştirme koduyla) bağlayın. Ayrı bir numara kullanın. Bkz. WhatsApp.
10. Ofis tarayıcısı (isteğe bağlı)
- Settings → Browser → eklentiyi indirin ve ofis bilgisayarına kurun.
- CRM'i izinli sitelere ekleyin.
- Ofis tarayıcısına ihtiyacı olan ajanlar için, her ajanın Settings sekmesinde Can use the office browser seçeneğini açın. Emlak şablonundan oluşan ajanlarda (Lumate ve Araştırmacı) bu zaten açıktır; daha önce oluşturduğunuz ajanlarda açmanız gerekir.
Bkz. Ofis tarayıcısı ve ilanlar.
11. Beceriler ve bilgi
- Beceriler: Kategorilere göre hazır katalog. Becerileri şirkete ekleyin ve ajanlara verin. GitHub'dan içe aktarmak da mümkündür.
- Bilgi: Ajanların öğrendikleri kaynağıyla birlikte burada görünür.
Bir ajana bir şey öğretmek için ona söylemeniz yeter ("Ofisimiz cuma günleri saat 6'da kapanır") ya da bir dosya paylaşın (fiyat listesi, broşür). Ajan hatırlar.
Kontrol listesi
- HTTPS çalışıyor ve
SESSION_SECRET,SECRETS_KEYayarlı - İlk hesap ve şirket var; şablonun ajanları orada
- Çalıştırıcı çevrimiçi ve Lumate bir sohbette yanıt veriyor
- Üyeler doğru rollerle davet edildi
-
OPENAI_API_KEYkayıtlı; bir ajanla konuşma çalışıyor - Pano ayarları ve varsayılan randevu sahibi ayarlı
- İsteğe bağlı: numaralar, WhatsApp, ofis tarayıcısı