Hızlı Başlangıç — AiHummer Belgeler

Bu hızlı başlangıç, sizi sıfırdan bir kanal içinde yanıt veren ilk ajana kadar ilk AiHummer çalıştırmanızı gerçekleştirmenize götürür. Bu, bunu yapan biri için yazılmıştır ilk kez: her adım ile sona erer ne görmen gerektiği, ve sonunda ‘Eğer işe yaramadıysa’ bölümü var.

Önce, yolunu seç

AiHummer’ı elde etmenin iki yolu vardır (tam karşılaştırma için Giriş):

Bulut — sunucuyu biz çalıştırıyoruz, siz hazır bir adres alıyorsunuz. Yüklenecek hiçbir şey yok. → gitmek Yol A: bulut.
Kendi sunucunuzda barındırılan — Linux sunucunuza AiHummer kurarsınız bir komutla. → git Yol B: kendi sunucunuz.

Sonra her iki yol da ortak adımlarda birleşir — ilk ajan ve ilk kanal.

Yol A: bulut

İhtiyacınız olanlar: bir e-posta adresi, bir telefon numarası ve bir banka kartı (deneme için banka 1 ₽ tahsil eder ve hemen geri öder).

Kaydol my.aihummer.ru: e-posta adresinizi, telefonunuzu girin ve şifreyi girin, iki onayı kabul edin. Hesap doğrulamasını göreceksiniz ekran.
Hesabı doğrulayın — arama ile (gelen numaranın son rakamlarını girin) veya e-postadaki kodla. Oturum açmanın otomatik olarak gerçekleştiğini göreceksiniz ve onboarding sihirbazı açıldı. Detaylar: Kayıt ve giriş.
Sihirbazda seçin Bulut yol, sonra bir plan (aylık/yıllık). giriş planı ile birlikte gelir 10 günlük ücretsiz deneme. Detaylar: Planlar.
Kendi … doldurun fatura detayları (birey ya da firma/şahıs işletmesi) — onlar fatura ve işlem için gereklidir.
Seç alt alan adı (adresiniz olacaktır <name>.cloud.aihummer.ru) ve ödemek. Asistanınızı hazırlıyor durumunu ilerleme ile birlikte göreceksiniz. Detaylar: Sipariş ve ödeme.
Tahsis edilmesini bekleyin (genellikle birkaç dakika sürer). Durum değiştiğinde Senin asistan çalışıyor, tıkla Paneli aç — web yönetici kullanıcı arayüzünüz örnek açılır. Detaylar: Örnek pano.

Yapılandırma web yönetim kullanıcı arayüzünde devam eder — kendi ilk ajan. Bir bulut örneği için yönetici şifresi, paneli ilk açtığınızda belirlenir (kendi kendine barındırılan sürümde kullanılan ayrı şifre dosyasına burada ihtiyaç yoktur).

Yol B: kendi sunucunuz

İhtiyacınız olanlar: bir Linux sunucusu (x86_64 veya arm64), sudo haklar ve PostgreSQL (veya yükleyicinin bunu sağlamasına izin verin). Tam liste: Gereksinimler.

Adım 1. Kişisel kurulum bağlantınızı alın

Herkese açık bir kurulum betiği yok — bağlantı şudur kişisel. Kayıt ol my.aihummer.ru, aç Yükle ekrana gidin ve “Kişisel kurulum bağlantımı al”a tıklayın. Bir kopyala düğmesiyle hazır bir komut göreceksiniz.

Adım 2. Tek bir komutla yükleyin

Kopyalanan komutu sunucuda çalıştırın:

curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh

Yükleyici mimariyi tespit eder, indirir ve imzalı paketi doğrular, yükleme kökünü şurada gösterir ~/.aihummer ve ağ geçidi servisini systemd altında kaydeder. Kurulum adımı günlüğünü göreceksiniz ve sonunda bir servis başlatıldı mesajı. Tam ayrıntılar (sürüm kanalları, yan konteynerler, köksüz kurulum): Kurulum.

Adım 3. PostgreSQL’e işaret edin

Tek zorunlu bağımlılık PostgreSQL’dir pgcrypto uzantı. Yükleyici bağlantıyı sizin için yapar; veritabanını manuel olarak ayarlamak için şunu kullanın AIHUMMER_DATABASE_URL yapılandırma seçeneği:

AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer?sslmode=disable

-- once, in the target database
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Veritabanı geçişleri başlatıldığında otomatik olarak uygulanır.

Adım 4. İlk giriş

Hizmet başladıktan sonra, sunucuda yönetici Web UI’sini açın (özel port) :8781 varsayılan olarak):

http://localhost:8781/

Boş bir veritabanında bir oturum açma admin oluşturulur ve başlangıç şifresi yazılır ~/.aihummer/etc/initial-admin-password.txt. Oku, giriş yap, sonra şifreyi değiştir ve dosyayı hemen sil — adım adım içeri İlk giriş.

Adım: ilk temsilcinizi oluşturun

Bu adım bulut ve kendi sunucusunda barındırılan tarafından paylaşılmaktadır. Web yönetici kullanıcı arayüzünde açın “Ajanlar” → “+ Yarat”, bir isim, bir kişilik (sistem komutu) ve isteğe bağlı olarak özel bir model belirleyin. Yeni ajanı listede bir kutucuk olarak göreceksiniz. Karakter ve davranış ayarlarıyla tam ayrıntı: Ajanlar.

Adım: ilk kanalınızı bağlayın

Mesajların AiHummer’a ulaşmasını sağlamak için bir kanal ekleyin:

Telegram — en üretime hazır konektör; baştan sona bir yürütme “BotFather’dan ilk mesaja kadar” içinde Telegram.
Web UI’deki Oturumlar — bir ajanı bağlamadan önce test etmenin en hızlı yolu dış kanal.
MAKS — ayrıca mevcut olan bir Rus habercisi.

Bağlayıcı üzerine takılmıştır Eklentiler/Pazar Yeri ekran, sonra üzerinde yapılandırıldı Kanallar ekran, burada “Bağlamalar” Hangi ajan kanal çalıştıracağını belirleyen blok setleri. Kanala bir mesaj gönderin ve bir dönüşün baştan sona nasıl aktığını izleyin.

Admin kullanıcı arayüzünden doğrudan ajanla konuşun

İlk test için bir kanal gerekmez: üzerinde “Oturumlar” sayfa “Yeni oturum” düğmesi, yönetici kullanıcı arayüzünün içinde doğrudan bir temsilciyle sohbet açar. Kompozitörde şunları yapabilirsiniz dosyaları ekle (resimler ve belgeler — model çıkarılan metni alır) ve konu başlığının üstündeki iki geçişi gösterir hamle başına maliyet ve araç çıktısı — ajanın her adımda ne yaptığını görmek için kullanışlı.

[!TIP] Ayrıca AiHummer’ı OpenAI uyumlu API’si üzerinden doğrudan arayabilirsiniz, hiçbir kanal hiç:
POST /v1/chat/completions
Content-Type: application/json

{"model": "default", "messages": [{"role": "user", "content": "Hello"}]}
Set "stream": true SSE akışı için.

Sahte modeli hatırla

Gerçek bir modeli bağlayana kadar yanıtlar şuradan geliyor deterministik sahte — model maliyeti olmadan kanalları, yönlendirmeyi ve ajanları test etmek için kullanışlı. Gerçek bir sağlayıcıya (OpenAI, Anthropic, YandexGPT, GigaChat, ChatGPT aboneliği üzerinden Codex ve daha fazlası) nasıl bağlanılacağı hakkında bilgiler şurada Modeller sayfa.

[!NOTE] Gerçek bir model asla zorunlu değildir: AiHummer ücretsiz/yerel olarak çalışır OpenAI uyumlu uç noktalar ve bir Codex/ChatGPT-abonelik taşıması.

Eğer işe yaramadıysa

Yükleme komutu başarısız oldu — Linux x86_64/arm64 üzerinde çalıştırdığınızı kontrol edin ve kişisel bağlantının süresinin dolmadığı (30 gün yaşar; yenisini almak için “Yükle” ekranı). Tanılama: Kurulum.
Yönetici arayüzü açılmıyor — Web UI özel portta dinliyor :8781, halk değil :8780. Servisi kontrol et: systemctl status aihummer-gateway.
Başlangıç parolasını bulamıyor — içindedir ~/.aihummer/etc/initial-admin-password.txt, günlüklerde değil. Bakın İlk giriş.
Bulut ödemesi başarısız oldu — kontrol panelindeki abonelik durumu gösteriyor sebep; yeniden dene veya (şirketler için) fatura ile ödeme seç, bak Sipariş ve ödeme.
Ajan bir kanalda cevap vermiyor — kanalın bir şeye bağlı olduğundan emin olun “Bindings” bloğundaki ajan ve gönderenin sistem tarafından bilindiği (tarafından) varsayılan olarak ajan yalnızca bilinen kullanıcılara cevap verir), bakınız Kanallar.

Sonra nereye?

Üretim kendi kendine barındırılan dağıtım: Kurulum.
Davranışı kullanıcı arayüzünden ayarlayın: Yapılandırma.
İlk girişi güvence altına alın: İlk giriş.
Bir model bağlayın: Modeller.