AiHummer
Suomi▾
Kirjaudu sisäänTili
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Aloittaminen/Pikaopas

Pikaopas

v1.0.x · päivitetty 2026-07-20

Tämä pikaopas ohjaa sinut ensimmäisen AiHummer-suorituksesi läpi — nollasta ensimmäiseen agenttiin, joka vastaa kanavassa. Se on kirjoitettu henkilölle, joka tekee tämän ensimmäinen kerta: jokainen askel päättyy mitä sinun pitäisi nähdä, ja lopussa on “Jos se ei onnistunut” -kohta.

Ensiksi, valitse polkusi

On kaksi tapaa saada AiHummer (täydellinen vertailu löytyy Johdanto):

  • Pilvi — me pyöritämme palvelinta, saat valmiin osoitteen. Ei asennettavaa. → mennä Polku A: pilvi.
  • Itse isännöity (oma palvelin) — asennat AiHummerin Linux-palvelimellesi yhdellä komennolla. → mene Polku B: oma palvelimesi.

Molemmat polut sitten yhtyvät yhteisille askelmille — ensimmäinen agentti ja ensimmäinen kanava.

Polku A: pilvi

Tarvitset: sähköpostiosoite, puhelinnumero ja pankkikortti (kokeilua varten pankki veloittaa 1 ₽ ja palauttaa sen välittömästi).

  1. Rekisteröidy my.aihummer.ru: syötä sähköpostisi, puhelimesi ja salasana, hyväksy kaksi suostumusta. Näet tilin vahvistuksen näyttö.
  2. Vahvista tili — puhelimitse (syötä saapuvan numeron viimeiset numerot) tai koodilla sähköpostista. Näet että kirjautuminen tapahtui automaattisesti ja perehdytysvelho avautui. Tiedot: Rekisteröityminen ja kirjautuminen.
  3. Valitse ohjatussa toiminnossa Pilvi-polku ja sitten suunnitelma (kuukausittain/vuosittain). sisäänpääsyplan mukana tulee 10 päivän ilmainen kokeilu. Yksityiskohdat: Suunnitelmat.
  4. Täytä oma laskutustiedot (yksityishenkilö tai yritys/toiminimi) — he tarvitaan laskua ja asiakirjaa varten.
  5. Valitse yksi alihakun nimi (osoitteesi tulee olemaan <name>.cloud.aihummer.ru) ja maksaa. Näet tilan “Valmistellaan avustajasi” yhdessä edistymisen kanssa. Yksityiskohdat: Tilaus ja maksu.
  6. Odota käyttöönottoa (yleensä muutama minuutti). Kun tila muuttuu Sinun avustaja on käynnissä, napsauta Avaa paneeli — verkkosivuston hallinta-UI:si instanssi avautuu. Tiedot: Instanssin hallintapaneeli.

Määritykset jatkuvat verkkohallintakäyttöliittymässä — siirry kohtaan ensimmäinen agentti. Pilvipalveluesimerkin ylläpitäjän salasana asetetaan, kun avaat hallintapaneelin ensimmäisen kerran (itsenäisesti isännöitävässä järjestelmässä käytetty erillinen salasana tiedosto ei ole tarpeen tässä).

Polku B: oma palvelimesi

Tarvitset: Linux-palvelin (x86_64 tai arm64), sudo oikeudet ja PostgreSQL (tai anna asennusohjelman luoda se). Koko lista: Vaatimukset.

Vaihe 1. Hanki henkilökohtainen asennuslinkkisi

Julkista asennusskriptiä ei ole — linkki on henkilökohtainen. Rekisteröidy osoitteessa my.aihummer.ru, avaa Asentaa näyttö ja klikkaa “Hae henkilökohtainen asennuslinkkini”. Näet valmiin komennon kopiointipainikkeella.

Vaihe 2. Asenna yhdellä komennolla

Suorita kopioitu komento palvelimella:

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

Asentaja havaitsee arkkitehtuurin, lataa ja vahvistaa allekirjoitetun paketin, määrittää asennuksen juuren kohdassa ~/.aihummer ja rekisteröi porttipalvelun systemdin alle. Näet asennusvaiheen lokin ja lopuksi palvelun käynnistysviestin. Täydet tiedot (julkaisukanavat, sivuohjelmat, rootless-asennus): Asennus.

Vaihe 3. Osoita PostgreSQL:ää

Ainoa tiukka riippuvuus on PostgreSQL:n kanssa pgcrypto laajennus. Asentaja kytkee yhteyden puolestasi; asettaaksesi tietokannan manuaalisesti, käytä AIHUMMER_DATABASE_URL asetuksen valinta:

AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer?sslmode=disable
-- once, in the target database
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Tietokannan migraatiot otetaan käyttöön automaattisesti käynnistyksen yhteydessä.

Vaihe 4. Ensimmäinen kirjautuminen

Kun palvelu on käynnissä, avaa palvelimen hallinta-Web-käyttöliittymä (yksityinen portti :8781 oletuksena):

http://localhost:8781/

Tyhjälle tietokannalle kirjautuminen admin luodaan ja alkuperäinen salasana kirjoitetaan ~/.aihummer/etc/initial-admin-password.txt. Lue se, kirjaudu sisään, sitten vaihda salasana ja poista tiedosto välittömästi — askel askeleelta sisään Ensimmäinen kirjautuminen.

Vaihe: luo ensimmäinen agenttisi

Tämä vaihe jaetaan pilven ja itseisännöidyn välillä. Avaa web-hallintaliittymässä “Agentit” → + Luo, määritä nimi, persoona (järjestelmän kehotus) ja tarvittaessa oma malli. Näet uuden agentin laatikkona listassa. Täydelliset tiedot, hahmon ja käyttäytymisen säätö mukana: Agentit.

Vaihe: yhdistä ensimmäinen kanavasi

Jotta viestit tavoittaisivat AiHummerin, lisää kanava:

  • Telegram — tuotantovalmiin liittimen paras; päästä päähän ohjattu läpikäynti ”BotFatherista ensimmäiseen viestiin” on Telegram.
  • Istunnot verkkokäyttöliittymässä — nopein tapa testata agenttia ennen sen yhdistämistä ulkoinen kanava.
  • MAX — myös saatavilla venäläinen sanansaattaja.

Liitin on asennettu päälle Laajennukset/Markkinapaikka näyttö, sitten määritettynä Kanavat näyttö, missä Sitoja lohko määrittää, mikä agentti ohjaa sitä kanavaa. Lähetä viesti kanavalle ja katso, kuinka vuoro etenee päästä päähän.

Keskustele agentin kanssa suoraan ylläpitäjän käyttöliittymästä

Kanava ei ole vaadittu ensimmäistä testissä varten: on “Istunnot” Sivulle “+ Uusi istunto” -painike avaa keskustelun agentin kanssa suoraan ylläpitäjän käyttöliittymään. Säveltäjässä voit liittää tiedostoja (kuvat ja asiakirjat — malli vastaanottaa poimitun tekstin), ja kaksi kytkintä ketjun yläpuolella paljastavat vuoron hinta ja työkalun tuloste — kätevä nähdä, mitä agentti teki kussakin vaiheessa.

[!TIP] Voit myös soittaa AiHummerille suoraan sen OpenAI-yhteensopivan API:n kautta ilman kanava lainkaan:

POST /v1/chat/completions
Content-Type: application/json

{"model": "default", "messages": [{"role": "user", "content": "Hello"}]}

Asettaa "stream": true SSE-suoratoistoa varten.

Muista mallin jäljitelmä

Kunnes yhdistät oikean mallin, vastaukset tulevat deterministinen mokki — kätevä kanavien, reitityksen ja agenttien testaamiseen ilman mallikustannuksia. Kuinka liittää todellinen palveluntarjoaja (OpenAI, Anthropic, YandexGPT, GigaChat, Codex ChatGPT-tilauksen kautta ja muut) löytyy Mallit sivu.

[!NOTE] Todellinen malli ei ole koskaan pakollinen: AiHummer toimii ilmaisella/paikallisella OpenAI-yhteensopivat päätelaitteet ja Codex/ChatGPT-tilauskuljetus.

Jos se ei toiminut

  • Asennuskomento epäonnistui — tarkista, että suoritat sen Linux x86_64/arm64:lla ja että henkilökohtainen linkki ei ole vanhentunut (se on voimassa 30 päivää; hanki uusi Asennus-näyttö). Diagnostiikka: Asennus.
  • Hallintakäyttöliittymä ei avaudu — verkkokäyttöliittymä kuuntelee yksityistä porttia :8781, ei yleisö :8780. Tarkista palvelu: systemctl status aihummer-gateway.
  • Ei löydä alkuperäistä salasanaa — se on sisällä ~/.aihummer/etc/initial-admin-password.txt, ei lokitiedoissa. Katso Ensimmäinen kirjautuminen.
  • Pilvimaksu epäonnistui — tilauksen tila kojelaudassa näyttää syy; yritä uudelleen, tai (yrityksille) valitse laskulla maksaminen, katso Tilaus ja maksu.
  • Agentti ei vastaa kanavassa — varmista, että kanava on sidottu johonkin agentti ”Sitomukset”-lohkossa, ja että lähettäjä on järjestelmälle tuttu ( oletusarvoisesti agentti vastaa vain tunnetuille käyttäjille), katso Kanavat.

Minne seuraavaksi