Feishu Bot

Bir Multica agent'ını bir Feishu Bot olarak bağlayın; ekip üyeleri Feishu'da ona DM gönderebilir, bir grupta @ ile bahsedebilir veya iş oluşturmak için /issue kullanabilir. Konuşmalar ve çalıştırma kayıtları Multica çalışma alanında saklanmaya devam eder.

Her Bot, tam olarak bir agent'a eşlenir. Feishu'da birden çok agent kullanmak için, her biri için ayrı bir Bot bağlayın.

Bot bağlama

Agent'ın sahibi ile çalışma alanı sahipleri ve yöneticileri bir bağlantı başlatabilir:

1. Agent'lar'ı açın ve Feishu'ya bağlanacak agent'ı seçin.
2. Entegrasyonlar'a gidin ve Feishu'ya Bağla'ya tıklayın.
3. QR kodu Feishu ile tarayın ve yetkilendirmeyi onaylayın.
4. Multica'ya geri dönün. Sayfa Feishu'ya Bağlı gösterdiğinde, Bot hazırdır.

QR kod tek kullanımlık bir kimlik bilgisidir; süresi dolarsa yeni bir tane oluşturun. Zaten bağlı olan bir agent artık tarama giriş noktasını göstermez; Bot'u yeniden adlandırmak veya izinlerini ayarlamak için Feishu'da Yönet'e tıklayın.

İlk kullanım

Bir üye Bot'a ilk kez mesaj attığında, bir hesap bağlama bağlantısı alır:

1. Bağlantıyı açın ve Multica'ya giriş yapın.
2. Bağlanacak çalışma alanı hesabını onaylayın.
3. Feishu'ya geri dönün ve mesajı tekrar gönderin.

Multica, ancak bağlama yapıldıktan sonra bir mesajın hangi çalışma alanı üyesinden geldiğini onaylayabilir. Üye olmayanlar Bot'u kullanamaz.

Feishu'da agent'a iş verme

Doğrudan mesajlar

Bot'a doğrudan mesaj gönderin. Ardışık mesajlar aynı Multica konuşmasında kalır ve agent'ın yanıtları o konuşmaya geri döner.

Grup sohbetleri

Önce Bot'u gruba ekleyin, sonra @Bot yazıp neye ihtiyacınız olduğunu açıklayın. Bot yalnızca kendisinden açıkça @ ile bahsedilen mesajlara yanıt verir; çalıştığında geçerli oturumda okuyabildiği yakın zamandaki bağlamdan yararlanır.

İş oluşturma

Şunu gönderin:

/issue Fix the redirect after login
Safari stays on the login page after a successful sign-in.

İlk satır başlık olur, geri kalanı açıklama olur. Yalnızca /issue göndermek hiçbir şey oluşturmaz; Bot bunun yerine gerekli biçimi belirten bir yanıtla cevap verir.

Bağlantıları yönetme

Çalışma alanında bağlı Bot'ları görüntülemek için Ayarlar → Entegrasyonlar'ı açın. Çalışma alanı sahipleri ve yöneticileri burada bağlantılarını kesebilir; bir agent'ın sahibi de kendi Bot'unu o agent'ın Entegrasyonlar sayfasından yönetebilir.

Bağlantı kesildikten sonra, Bot yeni mesaj almayı durdurur. Mevcut konuşmalar ve denetim kayıtları silinmez.

Kendi sunucunuzda barındırma kurulumu

Multica Cloud ek bir yapılandırma gerektirmez. Kendi sunucunuzda barındırılan bir kurulum, önce Bot kimlik bilgilerini şifrelemek için kullanılan bir anahtar ayarlamalıdır:

MULTICA_LARK_SECRET_KEY=<base64-encoded 32-byte key>

Şöyle bir tane oluşturun:

openssl rand -base64 32

API sunucusunu yeniden başlatın, sonra Bot'u agent'ın Entegrasyonlar sayfasından bağlayın. Bu anahtarı uzun vadeli saklayın: döndürülür veya kaybolursa, mevcut kimlik bilgileri artık çözülemez ve Bot'un yeniden bağlanması gerekir.

MULTICA_LARK_HTTP_BASE_URL ve MULTICA_LARK_CALLBACK_BASE_URL yalnızca proxy'ler ve test gibi özel dağıtımlar için mevcuttur; normal çalışmada bunları ayarsız bırakın.

Sorun giderme

• Bağlama düğmesi yok: geçerli hesabın agent'ın sahibi veya bir çalışma alanı sahibi ya da yöneticisi olduğunu doğrulayın ve kendi sunucunuzda barındırma anahtarının yapılandırıldığını kontrol edin.
• QR kodun süresi doldu: iletişim kutusunu kapatın ve bağlantıyı yeniden başlatın.
• Bot hesap bağlama istiyor: bağlama bağlantısını açın ve o çalışma alanına ait Multica hesabıyla giriş yapın.
• Bot çalışmıyor: agent'ın arşivlenip arşivlenmediğini ve kullandığı runtime'ın çevrimiçi olup olmadığını kontrol edin.

Sırada

• Sohbet entegrasyonları — platform karşılaştırması, oturum izolasyonu ve hesap bağlama mekanikleri.
• Sohbet — Bot'un arkasındaki konuşma ve çalıştırma modeli.
• İşler — /issue'nun oluşturduğu iş birimi.