Markdown izdanje

AI-translated from English; not yet reviewed by a fluent editor.

# Hy Memory 2.0 nudi agentima tri načina da zadrže kontekst

> Tencent-ov SDK Hy Memory 2.0.1 razdvaja prisećanje u ćaskanju, radu i programiranju. Njegova aplikacija MemHub ima izvorni kod, ali još nema javne artefakte izdanja; integracijama su i dalje potrebne krajnje tačke modela i jasne granice pristupa.

By BIG CHANGE Editorial

Published: 2026-10-16T14:13:14.740Z
Updated: 2026-10-16T14:13:14.740Z
Canonical: https://bigchange.ai/blog/hy-memory-2-sdk-chat-work-coding-context

![Conceptual charcoal illustration of a three-drawer cabinet: blank conversation slips, tool tokens and layered revision strips sit in separate drawers.](https://bigchange.ai/api/media/file/hy-memory-three-scopes-v1.png)
AI-generated conceptual illustration by BIG CHANGE; not a Hy Memory product interface or tested result.

Tencent je objavio `hy-memory==2.0.1`, Python SDK za čuvanje i pronalaženje konteksta iz sesija ćaskanja, rada i programiranja. Kod je javan; prateća aplikacija MemHub još je izvorni kod koji čeka javne artefakte izdanja. Programeri koji procenjuju zajednički sloj memorije već mogu da koriste SDK, ali moraju da obezbede krajnje tačke modela i ugrađivanja i odluče koje zapise sesija svaki agent sme da čita.

U [dnevniku izmena projekta](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/CHANGELOG.md) Hy Memory 2.0.1 je datiran na 16. oktobar 2026. [PyPI](https://pypi.org/project/hy-memory/2.0.1/) beleži otpremanje paketa 15. oktobra, a povezani [rad o modelu](https://arxiv.org/abs/2610.22196) predat je istog dana. To su zasebni zapisi objavljivanja, a ne dokaz da je desktop proizvod isporučen.

## Velika promena

- **Šta se promenilo:** Objavljeni SDK pruža zasebne putanje memorije za ćaskanje, rad i programiranje preko `add()` i `search()`, uz filtere izvora i radnog prostora koje aplikacija koja ga integriše može da koristi.
- **Kako radi:** Ćaskanje organizuje razgovore u slojeve memorije. Rad iz traga alata izdvaja činjenicu o sesiji i, kada je opravdano, ponovno upotrebljiva iskustva. Programiranje dodaje lanac verzija izmena koda. Pozivalac obezbeđuje izvorni materijal, identitete, podešavanja skladištenja i usluge modela.
- **Zašto je važno:** Okruženje koje pokreće agenta može da preuzme sažet zapis prethodnih razgovora ili odluka o zadacima umesto da u svaku novu sesiju prosleđuje celu istoriju. Da li je taj zapis tačan, odobren i koristan i dalje zavisi od onoga što okruženje šalje i od toga koja sećanja dopušta da se vrate u upit modelu.

## Izaberite tok rada pre integracije

Dokument [SDK README](https://github.com/Tencent-Hunyuan/Hy-Memory) opisuje tri vrednosti parametra `scene`. `chat` prihvata običan tekst ili nizove poruka, a zatim vraća kanale prisećanja `profile`, `normal` i `proactive`. U režimu `lite` čuva sirov tekst za pretragu po ugrađivanjima, bez izdvajanja pomoću LLM-a. `pro` dodaje izdvajanje i usklađivanje; `ultra` može da izvrši dodatni prolaz evolucije preko `evolve()`.

Za `working` ulaz mora da sadrži trag poziva alata. Sesija proizvodi jednu činjenicu o zadatku, pristupu i rezultatu, uz nula ili više ponovno upotrebljivih iskustava koja prelaze prag vrednosti mehanizma. `coding` koristi ista dva sloja i dodaje lanac evolucije verzija za izmenjeni kod. README navodi da lanac može da koristi lokalne Git razlike ako je podešen `MEMORY_CODING_CHAIN_REPO_ROOT`, ili determinističke radnje zamene u tragu alata. U režimu `lite` SDK zanemaruje razliku između radnog i programerskog scenarija i čuva sirovu memoriju.

Ovi oblici izlaza služe različitim pitanjima. Preferencija iz razgovora pripada scenariju `chat`; završen zadatak sa rezultatima alata pripada režimu `working`; izmena koda čija ranija revizija može biti važna pripada režimu `coding`. To je dokumentovana razlika u usmeravanju, a ne BIG CHANGE test performansi.

## Dokumentovan put za upotrebu SDK-a

Sledeći niz koraka zasnovan je na [brzom početku u repozitorijumu](https://github.com/Tencent-Hunyuan/Hy-Memory) i [MemHub-ovom vodiču za podešavanje SDK-a](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/MEMORY.md). BIG CHANGE nije pokretao paket niti slao pozive modelima.

Koristite Python 3.9 ili noviji i instalirajte fiksiranu verziju SDK-a:

```bash
pip install hy-memory==2.0.1
```

ChromaDB i Kuzu su deo osnovnog skupa zavisnosti; Qdrant, FAISS, Neo4j, MySQL keš i lokalni model za ponovno rangiranje imaju zasebne dodatke. Okruženje za razvoj izvornog koda MemHub-a je drugačije: zahteva Node.js 24, pnpm 11, Python 3.12 i uv.

Podesite i krajnju tačku LLM-a i krajnju tačku za ugrađivanja pre inicijalizacije klijenta. README navodi `MEMORY_LLM_API_KEY`, `MEMORY_LLM_BASE_URL`, `MEMORY_LLM_MODEL` i odgovarajuće promenljive `MEMORY_EMBEDDER_*`, uz `MEMORY_EMBEDDING_DIMS`; takođe dokumentuje podrazumevanu vrednost `OPENAI_API_KEY`. Obezbedite sopstvene URL adrese krajnjih tačaka, nazive modela, ključeve i odgovarajuće dimenzije ugrađivanja. To su interfejsi kompatibilni sa OpenAI-jem, a ne zahtev da se koristi Tencent-ov zasebni model Hy-Memory-30B. Ne uključujte akreditive u tragove koji se čuvaju.

Sledeći primer ćaskanja koristi dokumentovane API-je `MemoryConfig.from_env()`, `HyMemoryClient`, `add()` i `search()`. Aplikacija koja poziva mora da obezbedi `authorized_messages` kao običan tekst ili poruke u OpenAI formatu, stabilan odobreni identifikator `user_id` i upit `query`. Primer prikazuje povratnu vrednost bez tvrdnje o određenom rezultatu:

```python
from hy_memory import HyMemoryClient, MemoryConfig

def write_and_recall(authorized_messages, user_id, query):
    config = MemoryConfig.from_env()  # Caller supplies LLM and embedding settings.
    client = HyMemoryClient(config=config, mode="pro")
    try:
        client.add(authorized_messages, user_id=user_id)
        return client.search(query, user_ids=[user_id], limit=10)
    finally:
        client.close()
```

Za rad ili programiranje prosledite trag poruka koji sadrži poziv alata ili stavku `role="tool"` i izričito podesite `scene`. Podesite `workspace_id` da izdvojite materijal projekta; `branch` ga zahteva. Podesite `source` pri upisu, a `include_sources` ili `exclude_sources` pri pretrazi kada su granice aplikacije pozivaoca važne. Pretraga ćaskanja vraća kanale memorije; pretraga rada ili programiranja vraća `facts` i `experiences`, uz `chain_block` za programiranje. Pregledajte vraćene zapise pre nego što ih predate okruženju koje pokreće agenta. `list_memories`, `get`, `update` i `delete` omogućavaju upravljanje pojedinačnim zapisima.

Uspešna integracija imala bi sačuvan zapis iz odobrenog ulaza i rezultat pretrage u zadatom opsegu koji odgovara na predviđeno pitanje prisećanja. README dokumentuje povratna polja, ali nemamo posmatrano izvršavanje na osnovu kog bismo tvrdili da su izdvajanje ili prisećanje uspeli. Ako je pretraga rada ili programiranja prazna, prvo proverite da je upis sadržao rezultate alata i koristio `pro` ili `ultra`, pa proverite iste vrednosti `user_id`, `workspace_id`, `branch` i filtere izvora. Ako menjate model ili dimenzije ugrađivanja, [MemHub-ov vodič za podešavanje](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/MEMORY.md) upozorava da se postojeća kolekcija ne može jednostavno ponovo koristiti sa drugačijom širinom vektora.

## MemHub i model su zasebni izbori

MemHub je predloženi desktop i CLI proizvod izgrađen na SDK-u. Njegov [README](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/README.md) opisuje upravljano lokalno izvršno okruženje, konektore izvora i integracije sa okruženjima domaćinima. Njegov [dnevnik izmena](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/CHANGELOG.md) preciznije opisuje dostupnost: postoji izvorna verzija 1.0.0, izdanje 4, ali su npm objava i GitHub artefakti izdanja još na čekanju. [Vodič za instalaciju](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/docs/INSTALLATION.md) navodi Linux i macOS kao ciljne platforme i kaže da Windows nije podržan; njegov niz npm instalacionih koraka uslovljen je objavljivanjem tih artefakata. Za sada taj niz tretirajte kao planiran put instalacije.

Lokalno skladištenje takođe ne znači da svaki korak obrade ostaje lokalan. MemHub-ov [dokument o privatnosti](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/PRIVACY.md) razdvaja dozvolu za čitanje izvora razgovora, dozvolu za slanje odobrenog materijala izabranoj usluzi modela treće strane i dozvolu da okruženje koje pokreće agenta preuzme memoriju. Navodi da se sirovi izvorni dokazi čuvaju u lokalnom direktorijumu podataka i da spoljna usluga modela, kada je izabrana, dobija odobren sadržaj potreban za odabrani zadatak. Integrator koji neposredno koristi SDK mora da sprovede sopstvene kontrole saglasnosti za izvore, pristupa modelima i prisećanja u okruženju domaćina; MemHub-ov [vodič za integraciju](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/MEMORY.md) kaže da njegov proizvodni most dodaje te korake upravljanja umesto da samo poziva SDK.

Tencent je objavio i [Hy-Memory-30B-A3B](https://huggingface.co/tencent/Hy-Memory-30B-A3B), model obučen za upisivanje memorije, uz [tehnički izveštaj](https://arxiv.org/abs/2610.22196) predat 15. oktobra. Izveštaj tvrdi da model prednjači nad uporednim sistemima na fiksnim poduzorcima testova. To je ocena modela koju navodi dobavljač, a ne nezavisan dokaz da ovaj SDK ili MemHub poboljšavaju odgovore agenta u upotrebi. SDK prihvata druge kompatibilne usluge modela.

Trenutni [fajl licence](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/LICENSE) repozitorijuma i metapodaci projekta navode Apache-2.0. Dnevnik izmena kaže da je usvojen posle otpremanja verzije 2.0.1, čiji nepromenljivi [PyPI metapodaci](https://pypi.org/project/hy-memory/2.0.1/) i dalje navode MIT. Paket se besplatno preuzima, ali izabrana usluga modela ili ugrađivanja može da naplaćuje zahteve; izdanje ne dokumentuje univerzalnu cenu rada. Praktična odluka je zato koju putanju memorije i granicu ovlašćenja integrisati, uz merenje troškova dobavljača i kvaliteta prisećanja u sopstvenoj postavci programera.

## Izvori i dodatna literatura

- [Hy-Memory repozitorijum i brzi početak](https://github.com/Tencent-Hunyuan/Hy-Memory) — trenutni SDK scenariji, API primeri, režimi, opcije skladištenja i filteri izvora.
- [Dnevnik izmena izdanja](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/CHANGELOG.md) i [PyPI 2.0.1](https://pypi.org/project/hy-memory/2.0.1/) — zasebni datumi izdanja SDK-a, zahtevi paketa, status MemHub-a i neslaganje metapodataka licence.
- [MemHub README](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/README.md), [vodič za integraciju SDK-a](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/MEMORY.md) i [dokument o privatnosti](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/PRIVACY.md) — arhitektura proizvoda u fazi izvornog koda, podešavanja i granice ovlašćenja.
- [MemHub vodič za instalaciju](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/docs/INSTALLATION.md) — predviđene platforme i uslovljen put do artefakata izdanja.
- [Hy-Memory-30B-A3B izveštaj](https://arxiv.org/abs/2610.22196) — preprint i ocena modela koju navode autori; ne potvrđuje ovu integraciju u stvarnoj upotrebi.

## Sources

- [Hy-Memory repozitorijum i README](https://github.com/Tencent-Hunyuan/Hy-Memory) — SDK scenariji, režimi, API primeri, skladištenje i filteri; README obaveštenje o izdanju navodi samo mesec.
- [Hy-Memory dnevnik izmena](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/CHANGELOG.md) — Datira SDK 2.0.1 i navodi da MemHub nema javne artefakte izdanja; objašnjava nepromenljive PyPI metapodatke licence.
- [hy-memory 2.0.1 na PyPI-ju](https://pypi.org/project/hy-memory/2.0.1/) — Objavljen paket, zahtev za Python, datumi fajlova izdanja i MIT metapodaci otpremanja.
- [MemHub README](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/README.md) — Arhitektura izvornog koda proizvoda i preduslovi razvoja, a ne dokaz javnog izdanja aplikacije.
- [MemHub vodič za integraciju memorije](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/MEMORY.md) — Podešavanje SDK-a, širina ugrađivanja i granice proizvodnog mosta.
- [MemHub dokument o privatnosti](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/PRIVACY.md) — Zasebne dozvole za izvore, obradu modelom i prisećanje u okruženju domaćina.
- [MemHub vodič za instalaciju](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/docs/INSTALLATION.md) — Uslovljen put instalacije paketa i ciljne platforme.
- [Hy-Memory-30B-A3B preprint](https://arxiv.org/abs/2610.22196) — Zaseban model, pristup obučavanju i test koji navodi dobavljač; bez nezavisne potvrde.
- [Trenutni LICENSE u repozitorijumu](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/LICENSE) — Trenutni izvorni tekst Apache-2.0; PyPI 2.0.1 zadržava MIT metapodatke.