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

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

დააინსტალირეთ AiHummer

ინსტალაცია იწყება პირად კაბინეტში: დარეგისტრირდით my.aihummer.ru-ზე, გახსენით ეკრანი «ინსტალაცია» და მიიღეთ ინსტალაციის პერსონალური ბმული. კაბინეტი გაჩვენებთ მზა ბრძანებას — გაუშვით ის სერვერზე sudo-თი (ინსტალაცია root-ის გარეშეც მხარდაჭერილია — იხ. ინსტალაცია):

curl -fsSL "<ინსტალაციის პერსონალური ბმული>" | sudo bash

ინსტალერი ამოიცნობს თქვენს არქიტექტურას, ჩამოტვირთავს და გადაამოწმებს ხელმოწერილ ნაკრებს, აწყობს ინსტალაციის ფესვს და არეგისტრირებს gateway სერვისს systemd-ის ქვეშ. სრული დეტალისთვის — პერსონალური ბმული, გამოშვების არხები, sidecar-ების არჩევა, გადამოწმება — იხ. ინსტალაცია.

მიამართეთ 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;

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

გახსენით ადმინ UI

როცა სერვისი ამოვა, გახსენით ადმინ UI სერვერზე:

http://localhost:8781/

ცარიელ მონაცემთა ბაზაზე იბეჭდება ერთჯერადი ადმინ პაროლი. იხ. პირველი შესვლა იმისთვის, თუ როგორ მიიღოთ ის და დაუყოვნებლივ შეცვალოთ.

დააკავშირეთ პირველი არხი

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

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

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

ადმინ UI-ში შექმენით აგენტი: მიეცით მას პერსონა და, არასავალდებულოდ, თითო აგენტზე მოდელი. მიამაგრეთ ის არხს, რომელიც ახლახან დაამატეთ (ბლოკი «მიბმები» გვერდზე «არხები»), რომ მარშრუტიზატორმა იცოდეს, სად გააგზავნოს შეტყობინებები. გააგზავნეთ შეტყობინება არხის გავლით და უყურეთ სვლის ბოლომდე გაშვებას.

ესაუბრეთ აგენტს პირდაპირ ადმინ UI-დან

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

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

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

გაითვალისწინეთ mock მოდელი

ვიდრე რეალურ მოდელს დააკავშირებთ, პასუხები მოდის დეტერმინისტული mock-დან — სასარგებლო არხების, მარშრუტიზაციისა და აგენტების შესამოწმებლად ნებისმიერი მოდელის ხარჯის გარეშე.

[!NOTE] რეალური მოდელი არასოდეს არის საჭირო: AiHummer მუშაობს უფასო/ლოკალურ OpenAI-თავსებად endpoint-ებსა და Codex/ChatGPT-ხელმოწერის ტრანსპორტზე. თქვენი საკუთარი პროვაიდერის (BYOK) დასაკავშირებლად დააყენეთ AIHUMMER_LLM_* კონფიგურაციის ვარიანტები — ეს არასავალდებულოა. იხ. მოთხოვნები.

სად შემდეგ

წარმოების განთავსება: ინსტალაცია.
გასაწყობად ქცევა UI-დან: კონფიგურაცია.
დაიცავით პირველი შესვლა: პირველი შესვლა.