სწრაფი დაწყება — AiHummer დოკუმენტაცია

ეს სწრაფი სტარტი გაგატარებთ თქვენს პირველ AiHummer-ის გაშვებას — ნულიდან პირველი აგენტის ჩატამდე პასუხისკენ. ეს დაწერილია იმისთვის, ვინც ამას პირველად აკეთებს. პირველად: თითოეული ნაბიჯი მთავრდება რაც თქვენ უნდა ნახოთ, და ბოლოს არის განყოფილება «თუ ეს არ გამოდგა».

პირველად აარჩიე შენი გზა

არსებობს ორი გზა AiHummer-ის მისაღებად (სრული შედარება შესავალი):

ღრუბელი — ჩვენ ვქმნით სერვერს, თქვენ გყავთ მზად მისამართი. არაფერი დასაყენებელი არ არის. → წასვლა წასასვლელად გზა A: ღრუბელი.
თავად განთავსებულია (თქვენს საკუთარ სერვერზე) — თქვენ აწარმოებთ AiHummer-ს თქვენს სერვერზე Linux-ზე ერთხელ გუნდად. → გადასვლა მიმდინარე გზა B: თქვენი საკუთარი სერვერი.

ორივე გზა საბოლოოდ მიერთდება საერთო ნაბიჯებზე — პირველი აგენტი და პირველი არხი.

გზა A: ღრუბელი

რას მოითხოვთ: ელფოსტის მისამართი, ტელეფონის ნომერი და ბანკის ბარათი (ტესტირებისთვის ბანკი ანვითარებს ₽1-ს და დაუბრუნებს მას მომენტალურად).

რეგისტრაცია my.aihummer.ru: შეიყვანეთ თქვენი ელ.ფოსტა, ტელეფონი და პაროლი, მიიღეთ ორივე თანხმობა. თქვენ დაინახავთ ანგარიშის დაჯერებას ეკრანი.
დაადასტურეთ ანგარიში — ზარის საშუალებით (შეიყვანეთ შემოსული ნომრის ბოლო ციფრები) ან ელექტრონული ფოსტის კოდით. ნახავთ, რომ შესვლა ავტომატურად დასრულდება და სამუშაოს დაწყების მეჩავის დეტალები გაიხსნა. დეტალებით: რეგისტრაცია და შესვლა.
ოსტატში აირჩიეთ ღრუბელი გზა, შემდეგ გეგმა (ყოველთვიური/ყოველწლიური). შესვლის გეგმა მოდის 10-დღიანი უფასო საცდელი ვერსია. დეტალები: გეგმები.
გთხოვთ შეავსოთ თქვენი გადახდის რეკვიზიტები (ფიზიკური პირი ან კომპანია/ინდივიდუალური საწარმოს მფლობელი) — ისინი საჭირო არის ანგარიშისა და აქტისთვის.
აირჩიე ქვე-მონახაზი სახელი (თქვენი მისამართი იქნება <name>.cloud.aihummer.ru) და გადახდა. თქვენ დაინახავთ სტატუსს „თქვენი ასისტენტის მომზადება“ შესრულების ინდიკატორით. დეტალები: შეკვეთა და გადახდა.
გაეცადო რესურსების მოწოდებას (ჩვეულებრივ რამდენიმე წუთს მოითხოვს). როცა სტატუსი შეიცვლება შენი დამხმარე მუშაობს, დააჭირეთ «თავფურცლის გახსნა» — თქვენი ადმინისტრატორის ვებინტერფეისი ნიმუში იხსნება. დეტალები: მაგისტრალის მართვის პანელი.

კონფიგურაცია გაგრძელდება ადმინისტრატორის ვებინტერფეისში — გადადით თქვენს პირველი აგენტიადმინისტრატორის პაროლი ღრუბლის მაგალთისთვის nustველდება პანელის პირველ გახსნაზე (აქ საჭირო არაა პაროლის ცალკე ფაილი, რომელიც გამოიყენება სელფ-ჰოსტინგ ვერსიაში).

მიმდინარე გზა B: თქვენი საკუთარი სერვერი

რას მოითხოვთ: ლინუქსის სერვერი (x86_64 ან arm64), sudo უფლებები და PostgreSQL (ან დაუშვით ინსტალატორს დააკონფიგუროს იგი). სრული სია: მოთხოვნები.

ხრიკი 1. მიიღეთ თქვენი პერსონალური ინსტალაციის ბმული

საჯარო ინსტალაციის სკრიპტი არ არსებობს — სია პირადი. დარეგისტრირდი my.aihummer.ru, გახსენით დაყენება ეკრანზე დააჭირეთ „მიიღეთ ჩემი პირადი ინსტალაციის ბმული“. თქვენ იხილავთ მზად მყოფ გუნდს კოპირების ღილაკთან ერთად.

ნაბიჯი 2. დააყენეთ ერთ ბრძანებით

შეასრულეთ გაკოპირებული ბრძანება სერვერზე:

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

ინიალისტრატორი განსაზღვრავს არქიტექტურას, იტვირთება და ამოწმებს ხელმოწერილ პაკეტს, აჩენს ინსტალაციის ძირითად ფოლდერს ~/.aihummer და რეგისტრირებს გეითვეის სერვისს systemd-ში. თქვენ იხილავთ ინსტალაციის ნაბიჯის ჟურნალს და საბოლოოდ სერვისის გაშვების შეტყობინებას. სრულად დეტალები (რელიზის არხები, საიდკარები, root-ის გარეშე ინსტალაცია): დაყენება.

გადადგმით 3. მიუთითეთ PostgreSQL-ზე

ერთადერთი მკაცრი დამოკიდებულება არის PostgreSQL-თან pgcrypto გაფართოება. ინსტალატორი გაკავშირებთ კავშირს თქვენთვის; მონაცემთა ბაზის ხელით დასაყენებლად გამოიყენეთ AIHUMMER_DATABASE_URL კონფიგურაციის პარამეტრი:

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

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

ბაზის მონაცემთა მიგრაციები ავტომატურად იწარმოება გაშვების დროს.

ნაბიჯი 4. სისტემაში პირველი შესვლა

სერვისი როგორც კი ჩაირთვება, გახსენით ადმინისტრატორის ვებს ინტერფეისი სერვერზე (პრაივატ პორტი) :8781 ნაგულისხმევი):

http://localhost:8781/

ცარიელ მონაცემთა ბაზაზე შესვლა admin შექმნილია და საწყისი პაროლი ჩაიწერა ~/.aihummer/etc/initial-admin-password.txtწაიკითხეთ ეს, შესვლეთ, შემდეგ გა შეცვალეთ პაროლი და დაუყოვნებლივ წაშალეთ ფაილი — ნაბიჯ-ნაბიჯში პირველი შესვლა.

ნაბიჯი: შექმენით თქვენი პირველი აგენტი

ეს ნაბიჯი გამოიყენება როგორც ღრუბელში, ისე თვითსაცხოვრებელ გარემოში. ადმინისტრატორის ვებინტერფეისში გახსენით აგენტები → შექმნა, დააწერეთ სახელი, პერსონაჟი (სისტემური მითითება) და სურვილის შემთხვევაში, გამოყოფილი მოდელი. თქვენ იხილავთ ახალ აგენტს სია-ბლოკში. სრული დეტალები, ხასიათისა და ქცევის კონფიგურაციით: აგენტები.

ქმედება: დაუკავშირდით თქვენს პირველ არხს

რომელიც შეტყობინებები AiHummer-მდე მივიდეს, დაამატეთ არხი:

ტელეგრამი — ყველაზე მზად წარმოებისთვის კონექტორი; დეტალური ნაბიჯ-ნაბიჯ მიმოხილვა „BotFather-იდან პირველ შეტყობინებამდე“ ნაბიჯები აღწერილია Telegram გვერდზე.
სესსია ვებინტერფეისში — ყველაზე სწრაფი გზა, გამოამოწმოთ აგენტი მისი დაკავშირებამდე გარე არხი.
მაქს — ასევე ხელმისაწვდომია რუსული მესინჯერიც.

კონექტორი დამონტაჟებულია პლაგინები/მარკეტპლეისი ეკრანი, შემდეგ დაყენებულია არხები ეკრანი, სადაც «ბოჭკოები» ბლოკები ადგენენ, რომელი აგენტი მართავს ამ არხს. გაუგზავნეთ შეტყობინება არხზე და დააკვირდით, როგორ სრულდება დინამიკის ნაკადი დასაწყისიდან ბოლომდე.

გააგრძელეთ კომუნიკაცია აგენტთან პირდაპირ ადმინისტრატორის ინტერფეისიდან

კანალი პირველი ტესტისთვის არ არის საჭირო: ის სესიები გვერდზე ღილაკი «ახალი სესია» გახსნის ჩატს აგენტთან პირდაპირ ადმინისტრატორის ინტერფეისში. კონსტრუქტორში შეგიძლიათ ფაილების მიმაგრება (სურათები და დოკუმენტები — მოდელი იღებს ამოღებულ ტექსტს), ხოლო ორი გადართვის ღილაკი ბრენჩის თავზე აჩვენებს ღირებულება ერთ მოძრაობაზე და ობიექტის გამოსვლა — მოსახერხებელია, რომ ნახოთ, რა აკეთებდა აგენტი ყოველ ნაბიჯზე.

[!TIP] თქვენ ასევე შეგიძლიათ პირდაპირ მიიპყროთ AiHummer მისი OpenAI API-სთან თავსებადი ინტერფეისის საშუალებით არხი მთლიანობაში:
POST /v1/chat/completions
Content-Type: application/json

{"model": "default", "messages": [{"role": "user", "content": "Hello"}]}
კომplekტი "stream": true SSE-ს პირდაპირი სტრიმინგისთვის.

გახსოვდეს ხუმრობის მოდელი

დე თხორ პოკავ ვი ნე პოდკლიუჩიტე რეალურ მოდელ, პასუხები მოზილდება დეტერმინირებული bốket — მოსახერხებელია არხების, მარშრუტიზაციისა და აგენტების ტესტირებისთვის მოდელის ხარჯების გარეშე. როგორ დაუკავშირდეთ რეალურ მომწოდებელს (OpenAI, Anthropic, YandexGPT, GigaChat, Codex ChatGPT გამოწერით და სხვები) მოცემულია მოდელები გვერდი.

[!NOTE] ამ მოდელი არასოდეს არის სავალდებულო: AiHummer მუშაობს უფასო/ადგილობრივ ვერსიაზე OpenAI-სთან თავსებადი საბოლოო წერტილები და ტრანსპორტი Codex/ChatGPT-ის გამოწერისთვის.

თუ ეს არ მუშაობს

გაყვანის გუნდი უშედეგო აღმოჩნდა — დარწმუნდით, რომ ამას Linux x86_64/arm64-ზე აწარმოებთ და რომ პირადი ბმული არ არის ვადაგასული (ის მოქმედებს 30 დღის განმავლობაში; მიიღეთ ახალი ეკრანი «დაყენება». დიაგნოსტიკა: დაყენება.
ადმინის ინტერფეისი ვერ იხსნება — ვებინტერფეისი იცის პირად პორტზე :8781, არა საზოგადოება :8780. შეამოწმეთ მომსახურება: systemctl status aihummer-gateway.
არ მიიღება თავდაპირველი პაროლის გამართლება — ეს მდებარეობს ~/.aihummer/etc/initial-admin-password.txt, ჟურნალებში არაა. შეხედეთ პირველი შესვლა.
ქლაუდური გადახდა ვერ შესრულდა — გამოწერის სტატუსი დაფის მართვაზე აჩვენებს საბაბი; სცადეთ თავიდან ან (კომპანიებისთვის) აირჩიეთ ანგარიშის მიხედვით გადახდა, ნახეთ შეკვეთა და გადახდა.
აგენტი არხში არ პასუხობს — დარწმუნდით, რომ არხი მიერთებულია პიროვნება ბლოკში „დაკავშირებები“, და რომ გამგზავნი სისტემას ცნობილია (გამო) პირველადი პარამეტრებით აგენტი პასუხობს მხოლოდ ცნობილ მომხმარებლებს), ნახ. არხები.

სად შემდეგ?

პროდუქციული ლოკალური განლაგება: დაყენება.
ქცევის მორგება მომხმარებლის ინტერფეისის საშუალებით: კონფიგურაცია.
დაცვა მიიღეთ პირველ შესვლაზე: პირველი შესვლა.
მოდელის ჩართვა: მოდელები.