Greitas pradžia
Šis greitas pradžios vadovas veda jus per pirmąjį AiHummer paleidimą — nuo nulio iki pirmojo agente atsakymo kanale. Jis parašytas tiems, kurie tai daro pirmą kartą. pirmą kartą: kiekvienas žingsnis baigiasi ką turėtum matyti, o pabaigoje yra skyrius „Jei tai nepasiteisino“.
Pirmiausia pasirink savo kelią
Yra du būdai gauti AiHummer (viso palyginimo rasite Įvadas):
- Debesis — mes valdome serverį, jūs gaunate paruoštą adresą. Nereikia nieko įdiegti. → eiti į Kelias A: debesys.
- Savostalė (jūsų paties serveris) — jūs įdiegiate AiHummer savo Linux serveryje su viena komanda. → eiti į B kelias: jūsų pats serveris.
Abu keliai tada susilieja ties bendraisiais žingsniais — pirmasis agentas ir pirmasis kanalas.
Kelias A: debesys
Ko jums reikės: el. pašto adresas, telefono numeris ir banko kortelė (bandomajam laikotarpiui bankas nuskaito 1 ₽ ir iš karto jį gražina).
- Užsiregistruoti my.aihummer.ru: įveskite savo el. paštą, telefoną ir slaptažodį, sutikite su dvejais sutikimais. Jūs pamatysite paskyros patvirtinimą ekranas.
- Patvirtinkite paskyrą – skambučiu (įveskite gaunančio numerio paskutinius skaičius) arba su el. laiške esančiu kodu. Pamatysite, kad prisijungimas įvyko automatiškai ir atsidarė diegimo vedlys. Išsamiai: Registracija ir prisijungimas.
- Vedlyje pasirinkite Debesis kelią, tada planą (mėnesinį / metinį). įėjimo planas pateikiamas su 10 dienų nemokamas bandomasis periodas. Išsamiai: Planai.
- Užpildykite savo atsiskaitymo duomenys (asmuo arba įmonė/individuali įmonė) — jie reikalingi sąskaitai faktūrai ir aktui.
- Pasirinkti apakodomeno pavadinimas (jūsų adresas bus
<name>.cloud.aihummer.ru) ir mokėti. Matysite būseną „Jūsų asistento rengimas“ su pažanga. Detalės: Užsakymas ir mokėjimas. - Palaukite, kol bus paruošta (paprastai kelioms minutėms). Kai būsena pasikeis Tavo asistentas veikia, spustelėkite “Atidaryti skydelį” — jūsų interneto administravimo vartotojo sąsaja instancija atsidaro. Detalės: Instancijos informacijos suvestinė.
Konfigūracija tęsiasi internetinėje administravimo sąsajoje — eikite į savo pirmasis agentas. Debesies instancijos administratoriaus slaptažodis nustatomas pirmą kartą atidarius valdymo skydelį (čia nereikia atskiro slaptažodžių failo, naudojamo savarankiškai talpinamose sistemose).
B kelias: jūsų pats serveris
Ko jums reikės: Linux serveris (x86_64 arba arm64), sudo teisės ir PostgreSQL (arba leiskite diegimo programai jį įdiegti). Pilnas sąrašas: Reikalavimai.
1 veiksmas. Gaukite savo asmeninę diegimo nuorodą
Viešojo diegimo scenarijaus nėra — nuoroda yra asmeninis. Užsiregistruoti my.aihummer.ru, atidarykite Įdiegti ekrane ir spustelėkite „Gauti mano asmeninę diegimo nuorodą“. Pamatysite paruoštą komandą su kopijavimo mygtuku.
2 veiksmas. Įdiekite viena komanda
Paleiskite nukopijuotą komandą serveryje:
curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh
Diegimo programa nustato architektūrą, atsisiunčia ir patikrina pasirašytą paketą, nustato diegimo šaknį adresu ~/.aihummer ir registruoja vartų paslaugą sistemoje systemd. Jūs pamatysite įdiegimo žingsnio žurnalą ir, pabaigoje, pranešimą apie paslaugos paleidimą. Išsamūs duomenys (leidimų kanalai, šoninės programos, diegimas be root teisių): Įdiegimas.
3 veiksmas. Nukreipkite į PostgreSQL
Vienintelė griežta priklausomybė yra PostgreSQL su pgcrypto plėtinys. Diegimo programa sujungia ryšį už jus; norėdami nustatyti duomenų bazę rankiniu būdu, naudokite AIHUMMER_DATABASE_URL konfigūracijos parinktis:
AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer?sslmode=disable
-- once, in the target database
CREATE EXTENSION IF NOT EXISTS pgcrypto;
Duomenų bazės migracijos taikomos automatiškai paleidimo metu.
4 žingsnis. Pirmas prisijungimas
Kai paslauga bus paleista, atidarykite administratoriaus žiniatinklio sąsają serveryje (privatus portas :8781 pagal numatytuosius nustatymus):
http://localhost:8781/
Tuščioje duomenų bazėje prisijungimas admin yra sukuriamas ir pradinio slaptažodžio įrašas į ~/.aihummer/etc/initial-admin-password.txt. Perskaitykite tai, prisiregistruokite, tada pakeiskite slaptažodį ir ištrinkite failą nedelsiant — žingsnis po žingsnio į Pirmas prisijungimas.
Žingsnis: sukurkite savo pirmąjį agentą
Šis žingsnis yra bendras tiek debesies, tiek savarankiškai talpinamoms sistemoms. Atidarykite žiniatinklio administravimo sąsajoje “Agentai” → “+ Kurti”, nustatykite pavadinimą, asmenybę (sistemos komandą) ir, pageidautina, skirtą modelį. Pamatysite naują agentą kaip plytelę sąraše. Išsami informacija, su charakterio ir elgesio nustatymais: Agentai.
Žingsnis: prijunkite savo pirmąjį kanalą
Norint, kad žinutės pasiektų AiHummer, pridėkite kanalą:
- Telegrama — daugiausiai gamybai paruoštas jungtis; nuoseklus viso proceso vadovas “nuo BotFather iki pirmos žinutės” yra Telegrama.
- Seansai interneto sąsajoje — pats greičiausias būdas išbandyti agentą prieš jį prijungiant išorinis kanalas.
- MAKS — taip pat prieinamas Rusijos pasiuntinys.
Jungtis įdiegta ant Įskiepiai/Rinkos vieta ekranas, tada sukonfigūruotas ant Kanalai ekranas, kur “Sąsajos” blokuoja nustatymus, kuris agentas valdo tą kanalą. Siųskite žinutę į kanalą ir stebėkite, kaip srautas vyksta nuo pradžios iki pabaigos.
Kalbėkite su agentu tiesiai iš administratoriaus sąsajos
Pirmam bandymui kanalas nėra būtinas: ant “Sesijos” puslapyje mygtukas „+ Nauja sesija“ atidaro pokalbį su agentu tiesiogiai administravimo sąsajoje. Kompozitoriuje galite pridėti failus (vaizdai ir dokumentai — modelis gauna išgautą tekstą), ir dvi perjungimo parinktys virš siūlo atskleidžia kaina už ėjimą ir įrankio išvestis — patogu matyti, ką agentas atliko kiekviename žingsnyje.
[!TIP] Taip pat galite skambinti AiHummer tiesiogiai per jo su OpenAI suderinamą API be kanalas iš viso:
POST /v1/chat/completions Content-Type: application/json {"model": "default", "messages": [{"role": "user", "content": "Hello"}]}Rinkinys
"stream": trueSSE srautui.
Prisiminkite bandomąjį modelį
Kol neprijungsite tikro modelio, atsakymai ateina iš deterministinis maketas — patogu testuoti kanalus, maršrutizavimą ir agentus be modelio sąnaudų. Kaip prijungti tikrą tiekėją (OpenAI, Anthropic, YandexGPT, GigaChat, Codex per ChatGPT prenumeratą ir daugiau) pateikta Modeliai puslapis.
[!NOTE] Tikras modelis niekada nėra privalomas: AiHummer veikia nemokamai/vietoje OpenAI suderinami galiniai taškai ir Codex/ChatGPT prenumeratos transportas.
Jeigu tai neveiktų
- Diegimo komanda nepavyko — patikrinkite, kad jį vykdytumėte Linux x86_64/arm64 ir kad asmeninė nuoroda nebūtų pasenusi (ji galioja 30 dienų; gaukite naują „Įdiegti“ ekranas). Diagnostika: Įdiegimas.
- Administratoriaus vartotojo sąsaja neatidarys — žiniatinklio sąsaja klauso privačiame porte
:8781, ne visuomenė:8780. Patikrinkite paslaugą:systemctl status aihummer-gateway. - Negaliu rasti pradinio slaptažodžio — tai yra viduje
~/.aihummer/etc/initial-admin-password.txt, ne žurnaluose. Žr. Pirmas prisijungimas. - Debesų mokėjimas nepavyko — prenumeratos būsena prietaisų skydelyje rodo priežastis; bandyti dar kartą, arba (įmonėms) pasirinkti mokėjimą sąskaita, žr. Užsakymas ir mokėjimas.
- Agentas neatsako kanale — įsitikinkite, kad kanalas yra susietas su agentas bloke „Sąsajos“, ir kad siuntėjas yra žinomas sistemai (pagal pagal numatytuosius nustatymus agentas atsako tik žinomiems vartotojams), žr. Kanalai.
Kur toliau
- Gamybos savarankiško diegimo: Įdiegimas.
- Reguliuoti elgesį iš vartotojo sąsajos: Konfigūracija.
- Apsaugokite pirmą prisijungimą: Pirmas prisijungimas.
- Prijungti modelį: Modeliai.