DUNIA TERUS BERGERAK.RSS
BIG CHANGE.

Edisi Markdown

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

# Hy Memory 2.0 memberi agen tiga cara mempertahankan konteks

> SDK Hy Memory 2.0.1 dari Tencent memisahkan pengingatan obrolan, pekerjaan, dan pengodean. Aplikasi MemHub sudah memiliki kode sumber, tetapi belum memiliki artefak rilis publik; integrasinya tetap memerlukan endpoint model dan batas akses yang tegas.

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 menerbitkan `hy-memory==2.0.1`, SDK Python untuk menyimpan dan mengambil kembali konteks dari sesi obrolan, pekerjaan, dan pengodean. Kodenya tersedia untuk umum; aplikasi pendamping MemHub masih berupa kode sumber yang menunggu artefak rilis publik. Pengembang yang sedang mengevaluasi lapisan memori bersama dapat menggunakan SDK ini sekarang, tetapi perlu menyediakan endpoint model dan embedding serta menentukan rekaman sesi mana yang boleh dibaca setiap agen.

Dalam [catatan perubahan proyek](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/CHANGELOG.md), Hy Memory 2.0.1 diberi tanggal 16 Oktober 2026. [PyPI](https://pypi.org/project/hy-memory/2.0.1/) mencatat unggahan paket pada 15 Oktober, dan [makalah model](https://arxiv.org/abs/2610.22196) terkait diajukan pada hari itu. Itu merupakan catatan publikasi yang berbeda, bukan bukti bahwa produk desktop telah dirilis.

## Perubahan besar

- **Yang berubah:** SDK yang telah diterbitkan menyediakan jalur memori terpisah untuk obrolan, pekerjaan, dan pengodean melalui `add()` dan `search()`, dengan filter sumber dan ruang kerja yang dapat digunakan aplikasi pengintegrasi.
- **Cara kerjanya:** Jalur obrolan mengatur percakapan menjadi lapisan memori. Jalur pekerjaan mengekstrak satu fakta sesi dan, jika layak, pengalaman yang dapat digunakan kembali dari jejak alat. Jalur pengodean menambahkan rantai versi untuk perubahan kode. Pemanggil menyediakan materi sumber, identitas, konfigurasi penyimpanan, dan layanan model.
- **Mengapa penting:** Host agen dapat mengambil rekaman ringkas percakapan atau keputusan tugas sebelumnya alih-alih memasukkan seluruh riwayat ke setiap sesi baru. Ketepatan, otorisasi, dan kegunaan rekaman itu tetap bergantung pada apa yang dikirim host dan memori mana yang diizinkannya masuk kembali ke prompt.

## Pilih alur kerja sebelum mengintegrasikan

Dalam [README SDK](https://github.com/Tencent-Hunyuan/Hy-Memory), dijelaskan tiga nilai `scene`. `chat` menerima teks biasa atau array pesan, lalu mengembalikan kanal pengingatan `profile`, `normal`, dan `proactive`. Dalam mode `lite`, SDK menyimpan teks mentah untuk pencarian embedding tanpa ekstraksi LLM. `pro` menambahkan ekstraksi dan rekonsiliasi; `ultra` dapat menjalankan tahap evolusi tambahan melalui `evolve()`.

Untuk `working`, masukan harus memuat jejak pemanggilan alat. Satu sesi menghasilkan satu fakta tentang tugas, pendekatan, dan hasil, ditambah nol atau lebih pengalaman yang dapat digunakan kembali dan lolos ambang nilai mesin. `coding` menggunakan dua lapisan yang sama dan menambahkan rantai evolusi versi untuk kode yang diubah. Menurut README, rantai itu dapat menggunakan diff Git lokal jika `MEMORY_CODING_CHAIN_REPO_ROOT` disetel, atau menggunakan tindakan penggantian deterministik dalam jejak alat. Dalam `lite`, SDK mengabaikan perbedaan skenario pekerjaan/pengodean dan menyimpan memori mentah.

Bentuk keluaran tersebut menjawab pertanyaan yang berbeda. Preferensi percakapan masuk ke `chat`; tugas yang selesai beserta hasil alat masuk ke `working`; perubahan kode yang versi sebelumnya mungkin penting masuk ke `coding`. Ini merupakan perbedaan perutean yang didokumentasikan, bukan uji performa BIG CHANGE.

## Jalur penggunaan SDK yang didokumentasikan

Urutan berikut didasarkan pada [panduan mulai cepat repositori](https://github.com/Tencent-Hunyuan/Hy-Memory) dan [panduan konfigurasi SDK MemHub](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/MEMORY.md). BIG CHANGE tidak menjalankan paket atau melakukan panggilan model.

Gunakan Python 3.9 atau lebih baru dan instal SDK dengan versi yang ditetapkan:

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

ChromaDB dan Kuzu termasuk dalam dependensi inti; Qdrant, FAISS, Neo4j, cache MySQL, dan reranker lokal tersedia sebagai tambahan terpisah. Lingkungan pengembangan sumber MemHub berbeda: dibutuhkan Node.js 24, pnpm 11, Python 3.12, dan uv.

Konfigurasikan endpoint LLM dan endpoint embedding sebelum menginisialisasi klien. README mencantumkan `MEMORY_LLM_API_KEY`, `MEMORY_LLM_BASE_URL`, `MEMORY_LLM_MODEL`, serta variabel `MEMORY_EMBEDDER_*` yang bersesuaian dan `MEMORY_EMBEDDING_DIMS`; README juga mendokumentasikan nilai bawaan `OPENAI_API_KEY`. Sediakan URL endpoint, nama model, kunci, dan dimensi embedding yang cocok milik Anda sendiri. Ini adalah antarmuka yang kompatibel dengan OpenAI, bukan kewajiban menggunakan model Hy-Memory-30B terpisah milik Tencent. Jangan masukkan kredensial ke jejak yang disimpan.

Contoh obrolan berikut menggunakan API yang didokumentasikan, yaitu `MemoryConfig.from_env()`, `HyMemoryClient`, `add()`, dan `search()`. Aplikasi pemanggil harus menyediakan `authorized_messages` sebagai teks biasa atau pesan berformat OpenAI, identitas `user_id` yang stabil dan berotorisasi, serta `query`. Contoh ini menampilkan nilai kembalian tanpa mengklaim hasil tertentu:

```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()
```

Untuk pekerjaan atau pengodean, berikan jejak pesan yang memuat pemanggilan alat atau entri `role="tool"` dan tetapkan `scene` secara eksplisit. Tetapkan `workspace_id` untuk mengisolasi materi proyek; `branch` memerlukannya. Tetapkan `source` saat menulis serta `include_sources` atau `exclude_sources` saat mencari jika batas aplikasi pemanggil perlu diperhatikan. Pencarian obrolan mengembalikan kanal memori; pencarian pekerjaan/pengodean mengembalikan `facts` dan `experiences`, disertai `chain_block` untuk pengodean. Periksa rekaman yang dikembalikan sebelum menyerahkannya kepada host agen. `list_memories`, `get`, `update`, dan `delete` menyediakan pengelolaan per rekaman.

Integrasi yang berhasil akan memiliki rekaman tersimpan dari masukan berotorisasi dan hasil pencarian dengan cakupan tertentu yang menjawab kebutuhan pengingatan yang dituju. README mendokumentasikan bidang kembalian, tetapi kami tidak mengamati pelaksanaannya sehingga tidak dapat mengklaim bahwa ekstraksi atau pengingatan berhasil. Jika pencarian pekerjaan/pengodean kosong, pastikan dahulu penulisan menyertakan hasil alat dan menggunakan `pro` atau `ultra`, lalu periksa kesamaan `user_id`, `workspace_id`, `branch`, dan filter sumber. Jika mengganti model atau dimensi embedding, [panduan konfigurasi MemHub](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/MEMORY.md) memperingatkan bahwa koleksi yang ada tidak bisa langsung digunakan kembali dengan lebar vektor yang berbeda.

## MemHub dan model adalah pilihan terpisah

MemHub merupakan produk desktop dan CLI yang direncanakan di atas SDK. Dalam [README](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/README.md)-nya dijelaskan runtime lokal terkelola, konektor sumber, dan integrasi host. Dalam [catatan perubahannya](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/CHANGELOG.md), status ketersediaannya dijelaskan lebih tegas: kode sumber versi 1.0.0 build 4 sudah ada, tetapi publikasi npm dan artefak rilis GitHub masih tertunda. [Panduan instalasi](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/docs/INSTALLATION.md) menetapkan Linux dan macOS sebagai target rilis serta menyatakan Windows tidak didukung; urutan instalasi npm-nya bergantung pada penerbitan artefak tersebut. Untuk saat ini, perlakukan urutan itu sebagai jalur instalasi yang direncanakan.

Penyimpanan lokal juga tidak berarti semua langkah pemrosesan tetap lokal. [Dokumen privasi](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/PRIVACY.md) MemHub memisahkan izin membaca sumber percakapan, izin mengirim materi berotorisasi ke layanan model pihak ketiga yang dipilih, dan izin bagi host agen untuk mengambil memori. Dokumen itu menyatakan bukti sumber mentah disimpan dalam direktori data lokal, dan jika layanan model eksternal dipilih, layanan tersebut menerima konten berotorisasi yang dibutuhkan untuk tugas yang dipilih. Pengintegrasi yang menggunakan SDK secara langsung harus menerapkan sendiri persetujuan akses sumber, akses model, dan kontrol pengingatan oleh host; [panduan integrasi](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/MEMORY.md) MemHub menjelaskan bahwa jembatan produknya menambahkan langkah tata kelola tersebut, bukan hanya memanggil SDK.

Tencent juga merilis [Hy-Memory-30B-A3B](https://huggingface.co/tencent/Hy-Memory-30B-A3B), model yang dilatih untuk menulis memori, dengan [laporan teknis](https://arxiv.org/abs/2610.22196) yang diajukan pada 15 Oktober. Laporan tersebut mengklaim keunggulan atas sistem pembanding pada subsampel tolok ukur yang tetap. Itu merupakan evaluasi model yang dilaporkan penyedia, bukan bukti independen bahwa SDK atau MemHub ini memperbaiki jawaban agen yang diterapkan. SDK menerima layanan model lain yang kompatibel.

Berkas [lisensi repositori](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/LICENSE) saat ini dan metadata proyek menyebut Apache-2.0. Catatan perubahan menyatakan lisensi ini diadopsi setelah unggahan 2.0.1, sementara [metadata PyPI](https://pypi.org/project/hy-memory/2.0.1/) unggahan yang tidak dapat diubah itu masih menyebut MIT. Paket dapat diunduh gratis, tetapi layanan model atau embedding yang dipilih dapat mengenakan biaya per permintaan; rilis tersebut tidak mencantumkan biaya operasional yang berlaku umum. Jadi, keputusan praktisnya adalah jalur memori dan batas otorisasi mana yang akan diintegrasikan, dengan biaya penyedia dan kualitas pengingatan diukur dalam lingkungan pengembang sendiri.

## Sumber & bacaan lanjutan

- [Repositori dan panduan mulai cepat Hy-Memory](https://github.com/Tencent-Hunyuan/Hy-Memory) — skenario SDK terkini, contoh API, mode, pilihan penyimpanan, dan filter sumber.
- [Catatan perubahan rilis](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/CHANGELOG.md) dan [PyPI 2.0.1](https://pypi.org/project/hy-memory/2.0.1/) — tanggal rilis SDK yang berbeda, persyaratan paket, status MemHub, dan perbedaan metadata lisensi.
- [README MemHub](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/README.md), [panduan integrasi SDK](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/MEMORY.md), dan [dokumen privasi](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/PRIVACY.md) — arsitektur produk pada tahap kode sumber, konfigurasi, dan batas otorisasi.
- [Panduan instalasi MemHub](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/docs/INSTALLATION.md) — platform yang dituju dan jalur bersyarat untuk artefak rilis.
- [Laporan Hy-Memory-30B-A3B](https://arxiv.org/abs/2610.22196) — pracetak dan evaluasi model yang dilaporkan penulis; laporan itu tidak memvalidasi integrasi ini dalam penggunaan nyata.

## Sources

- [Repositori dan README Hy-Memory](https://github.com/Tencent-Hunyuan/Hy-Memory) — Skenario SDK, mode, contoh API, penyimpanan, dan filter; pengumuman rilis dalam README hanya menyebut bulan.
- [Catatan perubahan Hy-Memory](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/CHANGELOG.md) — Memberi tanggal SDK 2.0.1 dan menyatakan MemHub belum memiliki artefak rilis publik; menjelaskan metadata lisensi PyPI yang tidak dapat diubah.
- [hy-memory 2.0.1 di PyPI](https://pypi.org/project/hy-memory/2.0.1/) — Paket yang diterbitkan, persyaratan Python, tanggal berkas rilis, dan metadata MIT saat unggahan.
- [README MemHub](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/README.md) — Arsitektur sumber produk dan prasyarat pengembangan, bukan bukti rilis aplikasi publik.
- [Panduan integrasi memori MemHub](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/MEMORY.md) — Konfigurasi SDK, lebar embedding, dan batas jembatan produk.
- [Dokumen privasi MemHub](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/PRIVACY.md) — Izin terpisah untuk sumber, pemrosesan model, dan pengingatan oleh host.
- [Panduan instalasi MemHub](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/docs/INSTALLATION.md) — Jalur instalasi paket bersyarat dan platform yang dituju.
- [Pracetak Hy-Memory-30B-A3B](https://arxiv.org/abs/2610.22196) — Model terpisah, pendekatan pelatihan, dan tolok ukur yang dilaporkan penyedia; belum divalidasi secara independen.
- [LICENSE repositori saat ini](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/LICENSE) — Teks sumber Apache-2.0 saat ini; PyPI 2.0.1 mempertahankan metadata MIT.