Open in
ThunderPhone CLI
Prisijunkite, valdykite balso agentus ir skambučius, konfigūruokite MCP klientus ir kurkite projektų karkasus iš terminalo.
CLI reikalauja Node.js 18.18 arba naujesnės versijos. Paleiskite jį su npx arba įdiekite visuotinai:
npm install -g thunderphone
thunderphone --helpPrisijunkite
npx thunderphone login
thunderphone whoami --jsonPrisijungimas pateikia patvirtinimo kodą, atidaro naršyklę ir laukia autorizacijos.
Begalviame įrenginyje naudokite --no-browser, o pateiktą URL atidarykite kitur.
Prisijungimui įrenginiu reikia, kad API būtų įdiegta OAuth įrenginio srauto funkcija. Organizacijos API
raktas, esantis THUNDERPHONE_API_KEY, taip pat gali autentifikuoti komandas ir turi pirmenybę
prieš išsaugotus prisijungimo duomenis.
Prisijungimo duomenys pagal profilį saugomi faile ~/.config/thunderphone/credentials.json
su failo režimu 0600. XDG_CONFIG_HOME ir THUNDERPHONE_CONFIG_DIR pakeičia
katalogą. Prieigos žetonai atnaujinami automatiškai, o keičiami atnaujinimo žetonai
išsaugomi atominiu būdu. Prisijungimas niekada nepateikia žetonų.
thunderphone login --profile work
thunderphone agents list --profile work --json
thunderphone logout --profile workTHUNDERPHONE_PROFILE nustato numatytąjį profilį. Atsijungus pašalinami vietiniai prisijungimo duomenys;
tai nepanaikina serverio suteikto leidimo. Pakeitus arba iš naujo nustačius slaptažodį arba
pakeitus paskyros el. pašto adresą, leidimas panaikinamas; dar kartą vykdykite thunderphone login. Numatytoji API yra https://api.thunderphone.com.
Kitai API naudokite --api-base-url arba THUNDERPHONE_API_BASE_URL. Profilio atpažinimo ženklas
negali būti siunčiamas į kitą sukonfigūruotą API URL; prisijunkite prie to URL naudodami atskirą profilį.
Komandos
Kiekviena komanda priima --json. Sėkmingi duomenys siunčiami į stdout, o klaidos – į stderr
su nenuliniu užbaigimo kodu. Be --json išvestis yra kompaktiška lentelė arba laukų sąrašas.
JSON išlaiko API atsakymo struktūrą, o prisijungimo duomenų laukai užmaskuojami. Teikiant MCP paslaugą
stdout rezervuojamas MCP protokolui.
| Komanda | Paskirtis |
|---|---|
login [--no-browser] [--scope "scopes"] | Autorizuoti naudojant įrenginio kodą |
logout, whoami | Pašalinti vietinius prisijungimo duomenis; išvardyti pasiekiamas organizacijas |
agents list, agents get ID | Gauti agentų duomenis |
agents create --file agent.json | Sukurti agentą |
agents update ID --file agent.json | Išsaugoti agento juodraštį |
agents deploy ID, agents delete ID | Diegti juodraštį; ištrinti agentą |
numbers list | Gauti telefono numerių duomenis |
numbers provision --country US --area-code 415 | Parengti JAV įeinančių skambučių numerį |
numbers assign NUMBER_ID --agent ID | Priskirti įeinančių skambučių agentą |
sms send TO --from FROM --body TEXT --idempotency-key KEY | Siųsti SMS per kliento prijungto ryšio tiekėjo numerį, saugiai kartojant siuntimą |
sms list [--limit N], sms get UUID | Išvardyti arba peržiūrėti SMS įrašus |
call TO --agent ID --from FROM [--wait] | Atlikti išeinantį skambutį; pasirinktinai laukti jo nuorašo |
calls list [--limit N] [--agent ID] | Išvardyti skambučius (riba 1–200) |
calls get ID, calls transcript ID | Gauti vieno skambučio arba jo nuorašo duomenis |
test run AGENT_ID [--scenario ID] --consent-to-charge | Vykdyti apmokestinamus išsaugotus scenarijus naudojant žiniatinklio kanalą |
test status RUN_ID [--agent ID] | Peržiūrėti paketą ir scenarijų informaciją, kai nurodomas agentas |
import VENDOR export.json | Parengti tiekėjo JSON importavimą peržiūrai |
imports get UUID, imports commit UUID | Peržiūrėti importavimą; po peržiūros patvirtinti pasirinktus agentus |
mcp setup, mcp serve | Konfigūruoti klientą; paleisti stdio sąsają |
init [directory] | Sukurti projekto karkasą |
Išeinantiems skambučiams reikalingas numeris su įgalintais išeinančiais skambučiais. THUNDERPHONE_FROM_NUMBER gali
nurodyti --from. Klientų VoIP numeriai ir toliau palaiko išeinančius skambučius.
ThunderPhone parengti numeriai iš pradžių skirti tik įeinantiems skambučiams; organizacijos administratorius gali
pateikti užklausą dėl išeinančių skambučių Telefono numerių puslapyje, kuriame kiekviena užklausa
peržiūrima rankiniu būdu. Numatytoji --wait laukimo laiko riba yra viena valanda; ją pakeiskite naudodami
--timeout SECONDS. Pasibaigus laukimo laikui laukti nustojama, tačiau skambutis nenutraukiamas.
SMS taip pat reikalingas SMS palaikantis numeris jūsų prijungtoje Twilio arba Telnyx paskyroje. SMS niekada nesiunčiamos iš ThunderPhone priklausančio numerio. Pakartotinio siuntimo raktą naudokite pakartotinai tik bandydami iš naujo siųsti su visiškai tais pačiais siuntėjo, gavėjo ir turinio duomenimis.
Importavimas palaiko vapi, retell, elevenlabs ir bland. Antrasis argumentas yra
kelias į tiekėjo JSON eksportą, o ne nuotolinis tiekėjo ID. API parengia susiejimą
asinchroniškai; peržiūrėkite jį naudodami imports get UUID ir patvirtinkite tik tada, kai jis parengtas
ir peržiūrėjote susietus laukus bei įspėjimus. Žr. agentų importavimą.
MCP nustatymas
thunderphone mcp setup --client cursor --api-key-env THUNDERPHONE_API_KEY
thunderphone mcp setup --client codex --scope user --api-key-env THUNDERPHONE_API_KEY
thunderphone mcp setup --client claude-desktop --scope userKlientai: claude-code, codex, cursor, vscode, gemini, claude-desktop ir
windsurf. Projekto apimtis naudojama pagal numatytuosius nustatymus. Darbalaukio ir Windsurf klientams reikalinga naudotojo apimtis.
Praleiskite --client, kad aptiktumėte vieną klientą projekte; dviprasmiškas aptikimas
interaktyviai pateikia užklausą arba neinteraktyvioje sesijoje baigiasi su instrukcijomis.
Nustatant išspausdinamas įrašytas failas ir išsaugomi nesusiję serveriai. Esamas JSON
turi būti galiojantis griežtas JSON; Codex TOML reikšmės išsaugomos, tačiau komentarai gali būti performatuoti.
Nustatymas teikia pirmenybę tiesioginiam nuotoliniam HTTP ryšiui. Naudojant --api-key-env, įrašoma kintamojo
nuoroda, bet niekada ne pats raktas. Be šios parinkties tiesioginis HTTP remiasi kliento
OAuth palaikymu; jis nenaudoja CLI kredencialų failo. Norėdami pakartotinai naudoti thunderphone login
kredencialus bet kuriame stdio palaikančiame kliente, naudokite:
{
"mcpServers": {
"thunderphone": {
"command": "npx",
"args": ["-y", "@thunderphone/mcp"]
}
}
}Apvalkalas patikrina THUNDERPHONE_API_KEY, tada dabartinį CLI profilį (prireikus jį atnaujina),
o tada perduoda OAuth valdymą mcp-remote. THUNDERPHONE_MCP_URL pakeičia
galinį tašką. Jis nesiunčia telemetrijos. Atskiras nustatymas taip pat pasiekiamas naudojant
npx -y @thunderphone/mcp setup --client cursor arba thunderphone-mcp setup, įdiegus
@thunderphone/mcp globaliai.
Sukurkite projektą
npx create-thunderphone-agent my-receptionist
npx create-thunderphone-agent my-outbound --template python --agent-type outbound
# Equivalent:
thunderphone init my-receptionist --template node --agent-type receptionistŠablonai yra node ir python; agentų tipai yra receptionist, outbound ir
custom. Numatytasis agentas yra anglų ir ispanų kalbomis veikiantis odontologijos registratūros balso agentas su aiškiai
nurodytais demonstraciniais faktais. Projektuose yra agent.json, diegimo scenarijai, MCP konfigūracijos, skirtos
Claude Code, Cursor ir VS Code, agentui skirtos instrukcijos, .env.example ir README.
Karkaso sukūrimas vykdomas neprisijungus ir neleidžia perrašyti netuščio katalogo.
Prieš diegdami redaguokite verslo faktus. Eksportuokite API raktą, prijungtą skambintojo
numerį ir testavimo gavėją, kaip nurodyta sugeneruotame README. npm run deploy
arba python deploy.py sukuria arba atnaujina agentą, įdiegia jo juodraštį ir atlieka
apmokestinamą testinį skambutį. Scenarijai naudoja API rakto autentifikavimą; CLI ir stdio MCP
apvalkalas taip pat palaiko prisijungimą įrenginiu. Python scenarijams reikalinga Python 3.9 arba naujesnė versija.