EN Buka Smooth di Telegram

DocsSmooth Agent (self-host)

Konfigurasi

Penyedia dan model, fallback otomatis, workspace, tool, suara, dan vision. Rahasia di .env, sisanya di config.toml.

smooth-agent setup menuliskan ~/.smooth-agent/config.toml untukmu. Kamu bisa mengeditnya kapan saja; contoh lengkap dengan semua opsi ada di smooth_agent/data/config.example.toml.

Penyedia (provider)

config.toml
default = "main"
fallbacks = ["backup"]          # dicoba berurutan kalau default gagal

[providers.main]
provider = "deepseek"
model = "deepseek-chat"

[providers.backup]
provider = "smooth-router"      # API milik Smooth, lihat Developer API
base_url = "https://api.smooth.family/v1"
model = "smooth-flash"
key_env = "SMOOTH_API_KEY"

Preset bawaan (masing-masing membaca key dari variabel environment preset-nya, misalnya DEEPSEEK_API_KEY, OPENAI_API_KEY, GLM_API_KEY):

PresetCatatan
openaiModel OpenAI
deepseekDeepSeek
glmZhipu GLM
groqGroq (inferensi cepat)
openrouterRatusan model dengan satu key
kimiMoonshot Kimi
smooth-routerAPI Smooth (https://api.smooth.family/v1) atau gateway yang kamu host sendiri
openai-compatibleEndpoint apa saja yang kompatibel OpenAI: isi base_url (server lokal seperti Ollama, vLLM, LM Studio)

Pakai -p <nama> (dan -m <model>) di chat, ask, atau run untuk memilih penyedia sekali jalan, dan smooth-agent providers untuk melihat daftarnya. Pencarian web memakai Tavily, Brave, atau SearXNG kalau TAVILY_API_KEY, BRAVE_API_KEY, atau SEARXNG_URL diisi, selain itu DuckDuckGo.

Pengaturan agent

config.toml
[agent]
workspace = "~/smooth-workspace"    # default: ~/.smooth-agent/workspace
instructions = "Jawab dalam bahasa Indonesia. Singkat saja."
timezone = "Asia/Jakarta"           # untuk jadwal dan "besok jam 9"
max_steps = 12                      # putaran tool per pesan
max_tokens = 4096                   # per jawaban
memory = true                       # memori jangka panjang + sesi tersimpan yang bisa dicari
context_tokens = 64000              # pesan lama diringkas setelah ~80% dari ini

Tool

config.toml
[tools]
files = "workspace"     # atau "full": seluruh mesin, dengan izin untuk menulis di luar workspace dan file rahasia
terminal = false        # true: shell + Python, setiap perintah minta izin
confirm = true          # false: jalankan perintah tanpa tanya (hanya di mesin yang kamu percaya)

Selengkapnya di Tool dan izin.

Vision, gambar, suara

config.toml
[vision]            # memahami gambar; default memakai penyedia/model utama

[image]             # membuat gambar (OpenAI-compatible /images/generations)
provider = "openai"

[stt]               # suara ke teks untuk pesan suara (OpenAI-compatible /audio/transcriptions)
provider = "groq"
language = "id"

[tts]               # balasan suara (OpenAI-compatible /audio/speech, butuh ffmpeg)
provider = "openai"
voice = "alloy"

Variabel environment

VariabelKegunaan
SMOOTH_AGENT_HOMELokasi semua data (default ~/.smooth-agent)
<PRESET>_API_KEYKey penyedia, misalnya DEEPSEEK_API_KEY
TELEGRAM_BOT_TOKEN, WHATSAPP_TOKEN, …Rahasia channel (lihat Channel chat)
NO_COLOR / FORCE_COLORWarna di terminal

Terakhir diperbarui: