Квикстарт — AiHummer Адокументациа

Абри квикстарт инарбагалоит AiHummer актәи аусура — анинсталл аҟынтә актәи агент аканал аҟны ахьаҭакуа аҟынӡа. Сҭр зегьы иамоуп хазы адаҟьа ишьҭоу адетал зегьы рыманы, ишәышьҭуа аиԥш илинкуп.

Иашәдыргыла AiHummer

Аинсталл иалагоит ахаҭалатә кабинет аҟны: иашәырегистрир my.aihummer.ru аҿы, иаартла «Аинсталл» аэкран насгьы ишәоу шәхаҭалатә инсталл линк. Акабинет иаанарԥшуеит иархиоу команда — иашәышьҭ асервер аҿы sudo аиԥш (root ада инсталлгьы иадгылоуп — иашәырба Аинсталл):

curl -fsSL "<хаҭалатә инсталл линк>" | sudo bash

Анинсталлер иадырбалоит шәара шәархитектура, инанагоит насгьы иҵабыргуеит иархиоу бандл, иаргылоит инсталл рут насгьы иаргистрироит гейтуэй аусура systemd иаҵаҟа. Адетал зегьы рзы — хаҭалатә линк, арелизтә каналқәа, сайдкарқәа риалхра, аҵабыргра — иашәырба Аинсталл.

Иашәпинтә PostgreSQL ахь

Иҵабыргу аамҭакала иҟоу адгылара ауп PostgreSQL pgcrypto ариагара иаргылоу аманы. Анинсталлер инарҿиоит adatabaza аиԥшра автоматтә. Шәара иашәдыргылар adatabaza напыкала, иашәхархәа 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;

Adatabaza амигразқәа иргылоит автоматтә анадыргылараан.

Иаартла аадминистраторатә UI

Аусура анышьҭихакь, иаартла аадминистраторатә Web UI асервер аҿы. Уи аусуеит хатәы приваттә листенер аҟны (стандарттә :8781, AIHUMMER_WEBUI_ADDR), ианаҭоит рут ныҟәара / аҟны — гейтуэй публикатә порт аҟны акымкуа:

http://localhost:8781/

Adatabaza иҭаку акәзар, гейтуэй иаргылоит admin алогин насгьы иаҩнытәи пароль иаҩуеит файл ~/.aihummer/etc/initial-admin-password.txt аҟны. Иашәԥхьа, иалогинтә, аразнак апароль иашәаԥсах насгьы афайл иашәыхкит — адетал азы иашәырба Актәи алогин.

Иашәацҵа актәи аканал

Аадминистраторатә 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-иадгылоу эндпоинтқәа насгьы Codex/ChatGPT-абонементтә транспорт. Шәара иашәхымоу провайдер аҿаҵаразы (BYOK), иаргылатә AIHUMMER_LLM_* аиҿартәаратә опциақәа — ари иалкаауп. Иашәырба Аҭахрақәа.

Иахьынтә ашьҭахь

Апродукшн дислои: Аинсталл.
Иашәырҿиа аҟазшьа UI аҟынтә: Аиҿартәара.
Иашәырхьча актәи алогин: Актәи алогин.