Tablestore:Penggunaan CLI

Konfigurasi kredensial akses

tablestore-agent-cli configure set access_key_id '...'
tablestore-agent-cli configure set access_key_secret '...'
tablestore-agent-cli configure set region 'cn-beijing'

Konfigurasi instans Tablestore

tablestore-agent-cli configure set ots_endpoint 'https://<instance>.cn-beijing.ots.aliyuncs.com'
tablestore-agent-cli configure set ots_instance_name '<instance-name>'

Jika Anda tidak mengonfigurasi ots_endpoint dan ots_instance_name, CLI akan secara otomatis membuat dan menggunakan kembali instans Tablestore terkelola saat Anda menjalankan perintah doctor atau melakukan operasi apa pun.

Konfigurasi nilai default layanan memori

tablestore-agent-cli configure set memory_store_name 'agent_memory'
tablestore-agent-cli configure set memory_app_id 'app-001'
tablestore-agent-cli configure set memory_tenant_id 'tenant-001'
tablestore-agent-cli configure set memory_agent_id 'agent-001'
tablestore-agent-cli configure set memory_run_id 'run-001'

Setelah mengonfigurasi nilai default ini, Anda dapat menghilangkan parameter yang sesuai dalam perintah berikutnya.

File konfigurasi dan variabel lingkungan

File konfigurasi berada di lokasi berikut:

~/.config/tablestore-agent-cli/config.toml

Variabel lingkungan memiliki prioritas lebih tinggi daripada file konfigurasi. Tabel berikut menunjukkan pemetaan antara keduanya.

Buat memory store

tablestore-agent-cli memory create --store agent_memory --description "Agent long-term memory store"

Setelah membuat memory store, layanan akan menginisialisasi indeks sekundernya secara asinkron. Anda harus menunggu sekitar 1 menit hingga indeks siap sebelum dapat menulis data dan melakukan pencarian.

Daftar penyimpanan memori

tablestore-agent-cli memory list
tablestore-agent-cli memory ls --limit 50 --next-token <token>

ls adalah alias untuk list. Perintah ini mengembalikan satu halaman hasil. Untuk mengambil halaman berikutnya, gunakan nextToken dari respons.

Lihat memory store

tablestore-agent-cli memory describe --store agent_memory
tablestore-agent-cli memory show --store agent_memory

show adalah alias untuk describe.

Memperbarui penyimpanan memori

tablestore-agent-cli memory update --store agent_memory --description "New description"

Hapus memory store

tablestore-agent-cli memory delete --store agent_memory
tablestore-agent-cli memory rm --store agent_memory -y

rm adalah alias untuk delete. Di lingkungan TTY, CLI akan meminta konfirmasi sebelum penghapusan. Gunakan flag -y untuk melewati konfirmasi.

Tambahkan memori berdasarkan teks

Gunakan flag --text untuk meneruskan teks yang telah diproses secara langsung:

tablestore-agent-cli memory add \
  --store agent_memory \
  --app-id app-001 \
  --tenant-id user-001 \
  --agent-id assistant \
  --run-id session-001 \
  --text "The user likes to drink coffee."

Penulisan sinkron

Secara default, operasi tulis berjalan dalam mode asinkron, artinya server mengekstraksi memori dari teks di latar belakang. Gunakan flag --sync agar memori segera tersedia untuk pengambilan.

tablestore-agent-cli memory add \
  --store agent_memory \
  --app-id app-001 \
  --tenant-id user-001 \
  --agent-id assistant \
  --run-id session-001 \
  --text "The user prefers a concise response style." \
  --sync

Tambahkan memori berdasarkan file pesan

Gunakan flag --messages-file untuk meneruskan daftar pesan percakapan. Konten file harus berupa array JSON.

tablestore-agent-cli memory add \
  --store agent_memory \
  --app-id app-001 \
  --tenant-id user-001 \
  --agent-id assistant \
  --run-id session-001 \
  --messages-file ./messages.json

Lampirkan metadata

Gunakan flag --metadata untuk meneruskan string JSON dan melampirkan bidang kustom:

tablestore-agent-cli memory add \
  --store agent_memory \
  --app-id app-001 \
  --text "The user likes Sichuan food." \
  --metadata '{"source":"chat","topic":"preference"}'

Daftar unit memori

tablestore-agent-cli memory list-units --store agent_memory --app-id app-001
tablestore-agent-cli memory ls-units --store agent_memory --app-id app-001 --limit 20 --next-token <token>

ls-units adalah alias untuk list-units.

Ambil memori tunggal

tablestore-agent-cli memory get \
  --store agent_memory \
  --memory-id mem-001 \
  --app-id app-001 \
  --tenant-id user-001 \
  --agent-id assistant \
  --run-id session-001

cat adalah alias untuk get.

Perbarui memori tunggal

tablestore-agent-cli memory update-unit \
  --store agent_memory \
  --memory-id mem-001 \
  --app-id app-001 \
  --tenant-id user-001 \
  --agent-id assistant \
  --run-id session-001 \
  --text "The user prefers coffee and concise answers."

Hapus memori tunggal

tablestore-agent-cli memory delete-unit \
  --store agent_memory \
  --memory-id mem-001 \
  --app-id app-001 \
  --tenant-id user-001 \
  --agent-id assistant \
  --run-id session-001

rm-unit adalah alias untuk delete-unit.

Kueri memori jangka pendek

tablestore-agent-cli memory msg-list \
  --store agent_memory \
  --app-id app-001 \
  --tenant-id user-001 \
  --agent-id assistant \
  --run-id session-001

Untuk melakukan kueri memori jangka pendek, Anda harus menentukan cakupan empat bagian lengkap, termasuk app-id, tenant-id, agent-id, dan run-id. Karakter wildcard * tidak diperbolehkan. ls-msgs adalah alias untuk msg-list.

Kueri log audit permintaan

Gunakan flag --operation untuk memfilter catatan audit permintaan berdasarkan jenis operasi. Dalam cakupan, parameter tenant-id, agent-id, dan run-id mendukung karakter wildcard *.

tablestore-agent-cli memory req-list \
  --store agent_memory \
  --app-id app-001 \
  --tenant-id '*' \
  --agent-id '*' \
  --run-id '*' \
  --operation AddMemories

ls-reqs adalah alias untuk req-list.