ThunderPhone 2.0 ಈಗ ಬಿಡುಗಡೆಯಾಗಿದೆ.ನೀವೇ ನೇರವಾಗಿ ಆರಂಭಿಸಿ — 2¢/ನಿಮಿಷದಿಂದ.ಘೋಷಣೆ ಓದಿ
ಪ್ರಾರಂಭಿಸಿ

Getting Started

View as Markdown
Open in
ClaudeChatGPTCursor

ThunderPhone CLI

ಟರ್ಮಿನಲ್‌ನಿಂದ ಲಾಗ್ ಇನ್ ಮಾಡಿ, ಧ್ವನಿ ಏಜೆಂಟ್‌ಗಳು ಮತ್ತು ಕರೆಗಳನ್ನು ನಿರ್ವಹಿಸಿ, MCP ಕ್ಲೈಂಟ್‌ಗಳನ್ನು ಕಾನ್ಫಿಗರ್ ಮಾಡಿ ಮತ್ತು ಪ್ರಾಜೆಕ್ಟ್‌ಗಳನ್ನು ಸ್ಕ್ಯಾಫೋಲ್ಡ್ ಮಾಡಿ.

CLIಗೆ Node.js 18.18 ಅಥವಾ ನಂತರದ ಆವೃತ್ತಿ ಅಗತ್ಯವಿದೆ. ಇದನ್ನು npx ಜೊತೆಗೆ ಚಲಾಯಿಸಿ, ಅಥವಾ ಜಾಗತಿಕವಾಗಿ ಸ್ಥಾಪಿಸಿ:

npm install -g thunderphone
thunderphone --help

ಲಾಗ್ ಇನ್ ಮಾಡಿ

npx thunderphone login
thunderphone whoami --json

ಲಾಗ್ ಇನ್ ಪರಿಶೀಲನಾ ಕೋಡ್ ಅನ್ನು ಮುದ್ರಿಸುತ್ತದೆ, ಬ್ರೌಸರ್ ತೆರೆಯುತ್ತದೆ ಮತ್ತು ಅನುಮೋದನೆಗಾಗಿ ಕಾಯುತ್ತದೆ. ಹೆಡ್‌ಲೆಸ್ ಯಂತ್ರದಲ್ಲಿ --no-browser ಬಳಸಿ ಮತ್ತು ಮುದ್ರಿಸಲಾದ URL ಅನ್ನು ಬೇರೆಡೆ ತೆರೆಯಿರಿ. ಸಾಧನ ಲಾಗ್ ಇನ್‌ಗೆ APIಯ OAuth ಸಾಧನ-ಹರಿವು ಬಿಡುಗಡೆ ಅಗತ್ಯವಿದೆ. THUNDERPHONE_API_KEYಯಲ್ಲಿರುವ ಸಂಸ್ಥೆಯ API ಕೀ ಸಹ ಆಜ್ಞೆಗಳನ್ನು ದೃಢೀಕರಿಸಬಹುದು ಮತ್ತು ಸಂಗ್ರಹಿತ ಲಾಗ್ ಇನ್ ರುಜುವಾತುಗಳಿಗಿಂತ ಆದ್ಯತೆ ಪಡೆಯುತ್ತದೆ.

ರುಜುವಾತುಗಳನ್ನು ಪ್ರೊಫೈಲ್ ಪ್ರಕಾರ ~/.config/thunderphone/credentials.jsonನಲ್ಲಿ 0600 ಕಡತ ಕ್ರಮದೊಂದಿಗೆ ಸಂಗ್ರಹಿಸಲಾಗುತ್ತದೆ. XDG_CONFIG_HOME ಮತ್ತು THUNDERPHONE_CONFIG_DIR ಡೈರೆಕ್ಟರಿಯನ್ನು ಅತಿಕ್ರಮಿಸುತ್ತವೆ. ಪ್ರವೇಶ ಟೋಕನ್‌ಗಳು ಸ್ವಯಂಚಾಲಿತವಾಗಿ ನವೀಕರಿಸಲ್ಪಡುತ್ತವೆ ಮತ್ತು ಪರಿವರ್ತನೆಯಾಗುವ ನವೀಕರಣ ಟೋಕನ್‌ಗಳನ್ನು ಪರಮಾಣುವಾಗಿ ಉಳಿಸಲಾಗುತ್ತದೆ. ಲಾಗ್ ಇನ್ ಎಂದಿಗೂ ಟೋಕನ್‌ಗಳನ್ನು ಮುದ್ರಿಸುವುದಿಲ್ಲ.

thunderphone login --profile work
thunderphone agents list --profile work --json
thunderphone logout --profile work

THUNDERPHONE_PROFILE ಪೂರ್ವನಿಯೋಜಿತ ಪ್ರೊಫೈಲ್ ಅನ್ನು ಹೊಂದಿಸುತ್ತದೆ. ಲಾಗ್ ಔಟ್ ಸ್ಥಳೀಯ ರುಜುವಾತುಗಳನ್ನು ತೆಗೆದುಹಾಕುತ್ತದೆ; ಇದು ಸರ್ವರ್ ಅನುಮತಿಯನ್ನು ಹಿಂತೆಗೆದುಕೊಳ್ಳುವುದಿಲ್ಲ. ಪೂರ್ವನಿಯೋಜಿತ API https://api.thunderphone.com ಆಗಿದೆ. ಬೇರೆ APIಗಾಗಿ --api-base-url ಅಥವಾ THUNDERPHONE_API_BASE_URL ಬಳಸಿ. ಒಂದು ಪ್ರೊಫೈಲ್‌ನ ಟೋಕನ್ ಅನ್ನು ಬೇರೆ ಕಾನ್ಫಿಗರ್ ಮಾಡಲಾದ API URLಗೆ ಕಳುಹಿಸಲು ಸಾಧ್ಯವಿಲ್ಲ; ಪ್ರತ್ಯೇಕ ಪ್ರೊಫೈಲ್‌ನೊಂದಿಗೆ ಆ URLಗೆ ಲಾಗ್ ಇನ್ ಮಾಡಿ.

ಆಜ್ಞೆಗಳು

ಪ್ರತಿ ಆಜ್ಞೆಯು --json ಸ್ವೀಕರಿಸುತ್ತದೆ. ಯಶಸ್ವಿ ಡೇಟಾವು stdoutಗೆ ಹೋಗುತ್ತದೆ; ದೋಷಗಳು ಶೂನ್ಯವಲ್ಲದ ನಿರ್ಗಮನ ಕೋಡ್‌ನೊಂದಿಗೆ stderrಗೆ ಹೋಗುತ್ತವೆ. --json ಇಲ್ಲದೆ, ಔಟ್‌ಪುಟ್ ಸಂಕ್ಷಿಪ್ತ ಕೋಷ್ಟಕ ಅಥವಾ ಕ್ಷೇತ್ರ ಪಟ್ಟಿ ಆಗಿರುತ್ತದೆ. ರುಜುವಾತು ಕ್ಷೇತ್ರಗಳನ್ನು ಮರೆಮಾಚಿ JSON API ಪ್ರತಿಕ್ರಿಯೆಯ ರಚನೆಯನ್ನು ಉಳಿಸಿಕೊಳ್ಳುತ್ತದೆ. MCP ಸೇವೆಯು MCP ಪ್ರೋಟೋಕಾಲ್‌ಗಾಗಿ stdout ಅನ್ನು ಕಾಯ್ದಿರಿಸುತ್ತದೆ.

ಆಜ್ಞೆಉದ್ದೇಶ
login [--no-browser] [--scope "scopes"]ಸಾಧನ ಕೋಡ್ ಮೂಲಕ ಅನುಮೋದಿಸಿ
logout, whoamiಸ್ಥಳೀಯ ರುಜುವಾತುಗಳನ್ನು ತೆಗೆದುಹಾಕಿ; ಪ್ರವೇಶಿಸಬಹುದಾದ ಸಂಸ್ಥೆಗಳ ಪಟ್ಟಿ ನೀಡಿ
agents list, agents get IDಏಜೆಂಟ್‌ಗಳನ್ನು ಓದಿ
agents create --file agent.jsonಏಜೆಂಟ್ ರಚಿಸಿ
agents update ID --file agent.jsonಏಜೆಂಟ್ ಕರಡನ್ನು ಉಳಿಸಿ
agents deploy ID, agents delete IDಕರಡನ್ನು ನಿಯೋಜಿಸಿ; ಏಜೆಂಟ್ ಅಳಿಸಿ
numbers listಫೋನ್ ಸಂಖ್ಯೆಗಳನ್ನು ಓದಿ
numbers provision --country US --area-code 415ಯುಎಸ್ ಒಳಬರುವ ಸಂಖ್ಯೆಯನ್ನು ಒದಗಿಸಿ
numbers assign NUMBER_ID --agent IDಒಳಬರುವ ಏಜೆಂಟ್ ಅನ್ನು ನಿಯೋಜಿಸಿ
call TO --agent ID --from FROM [--wait]ಹೊರಹೋಗುವ ಕರೆ ಮಾಡಿ; ಐಚ್ಛಿಕವಾಗಿ ಅದರ ಪ್ರತಿಲಿಪಿಗಾಗಿ ಕಾಯಿರಿ
calls list [--limit N] [--agent ID]ಕರೆಗಳ ಪಟ್ಟಿ ನೀಡಿ (ಮಿತಿ 1–200)
calls get ID, calls transcript IDಒಂದು ಕರೆ ಅಥವಾ ಅದರ ಪ್ರತಿಲಿಪಿಯನ್ನು ಓದಿ
test run AGENT_ID [--scenario ID] --consent-to-chargeವೆಬ್ ಚಾನೆಲ್ ಬಳಸಿ ಶುಲ್ಕ ವಿಧಿಸಬಹುದಾದ ಉಳಿಸಿದ ಸನ್ನಿವೇಶಗಳನ್ನು ಚಲಾಯಿಸಿ
test status RUN_ID [--agent ID]ಬ್ಯಾಚ್ ಪರಿಶೀಲಿಸಿ; ಏಜೆಂಟ್ ಒದಗಿಸಿದಾಗ ಸನ್ನಿವೇಶ ವಿವರಗಳನ್ನು ನೋಡಿ
import VENDOR export.jsonಪರಿಶೀಲನೆಗಾಗಿ ಮಾರಾಟಗಾರರ JSON ಆಮದು ಸಿದ್ಧಪಡಿಸಿ
imports get UUID, imports commit UUIDಆಮದನ್ನು ಪರಿಶೀಲಿಸಿ; ಪರಿಶೀಲನೆಯ ನಂತರ ಆಯ್ಕೆಮಾಡಿದ ಏಜೆಂಟ್‌ಗಳನ್ನು ದೃಢೀಕರಿಸಿ
mcp setup, mcp serveಕ್ಲೈಂಟ್ ಕಾನ್ಫಿಗರ್ ಮಾಡಿ; stdio ಸೇತುವೆ ಪ್ರಾರಂಭಿಸಿ
init [directory]ಪ್ರಾಜೆಕ್ಟ್ ಚೌಕಟ್ಟನ್ನು ರಚಿಸಿ

ಹೊರಹೋಗುವ ಕರೆಗಳಿಗೆ ಸಂಪರ್ಕಿತ ವಾಹಕ ಸಂಖ್ಯೆ ಅಗತ್ಯವಿದೆ. THUNDERPHONE_FROM_NUMBERವು --from ಒದಗಿಸಬಹುದು. ThunderPhone ಒದಗಿಸಿದ ಸಂಖ್ಯೆಗಳು ಒಳಬರುವ ಕರೆಗಳಿಗೆ ಮಾತ್ರ. --wait ಪೂರ್ವನಿಯೋಜಿತವಾಗಿ ಒಂದು ಗಂಟೆಯ ಕಾಲಾವಧಿ ಮಿತಿಯನ್ನು ಹೊಂದಿರುತ್ತದೆ; ಅದನ್ನು ಬದಲಾಯಿಸಲು --timeout SECONDS ಹೊಂದಿಸಿ. ಕಾಲಾವಧಿ ಮೀರಿದಾಗ ಕರೆಯನ್ನು ಕೊನೆಗೊಳಿಸದೆ ಕಾಯುವುದನ್ನು ನಿಲ್ಲಿಸಲಾಗುತ್ತದೆ.

ಆಮದುಗಳು vapi, retell, elevenlabs, ಮತ್ತು bland ಅನ್ನು ಬೆಂಬಲಿಸುತ್ತವೆ. ಎರಡನೇ ಆರ್ಗ್ಯುಮೆಂಟ್ ದೂರಸ್ಥ ಮಾರಾಟಗಾರರ ID ಅಲ್ಲ, ಮಾರಾಟಗಾರರ JSON ರಫ್ತಿಗೆ ಒಂದು ಪಥವಾಗಿದೆ. API ಅಸಮಕಾಲಿಕವಾಗಿ ಮ್ಯಾಪಿಂಗ್ ಸಿದ್ಧಪಡಿಸುತ್ತದೆ; ಅದನ್ನು imports get UUID ಮೂಲಕ ಪರಿಶೀಲಿಸಿ ಮತ್ತು ಅದು ಸಿದ್ಧವಾದ ನಂತರ ಹಾಗೂ ಮ್ಯಾಪ್ ಮಾಡಲಾದ ಕ್ಷೇತ್ರಗಳು ಮತ್ತು ಎಚ್ಚರಿಕೆಗಳನ್ನು ಪರಿಶೀಲಿಸಿದ ಬಳಿಕ ಮಾತ್ರ ದೃಢೀಕರಿಸಿ. ಏಜೆಂಟ್ ಆಮದುಗಳನ್ನು ನೋಡಿ.

MCP ಸೆಟಪ್

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 user

ಕ್ಲೈಂಟ್‌ಗಳು: claude-code, codex, cursor, vscode, gemini, claude-desktop, ಮತ್ತು windsurf. ಪ್ರಾಜೆಕ್ಟ್ ಸ್ಕೋಪ್ ಡೀಫಾಲ್ಟ್ ಆಗಿದೆ. ಡೆಸ್ಕ್‌ಟಾಪ್ ಮತ್ತು Windsurf ಗೆ ಬಳಕೆದಾರ ಸ್ಕೋಪ್ ಅಗತ್ಯವಿದೆ. ಪ್ರಾಜೆಕ್ಟ್‌ನಿಂದ ಒಬ್ಬೇ ಕ್ಲೈಂಟ್ ಅನ್ನು ಪತ್ತೆಹಚ್ಚಲು --client ಅನ್ನು ಬಿಟ್ಟುಬಿಡಿ; ಅಸ್ಪಷ್ಟ ಪತ್ತೆಹಚ್ಚುವಿಕೆ ಸಂವಾದಾತ್ಮಕವಾಗಿ ಪ್ರಾಂಪ್ಟ್ ಮಾಡುತ್ತದೆ ಅಥವಾ ಸಂವಾದಾತ್ಮಕವಲ್ಲದ ಸೆಷನ್‌ನಲ್ಲಿ ಸೂಚನೆಗಳೊಂದಿಗೆ ವಿಫಲವಾಗುತ್ತದೆ. ಸೆಟಪ್ ಅದು ಬರೆದ ಫೈಲ್ ಅನ್ನು ಮುದ್ರಿಸುತ್ತದೆ ಮತ್ತು ಸಂಬಂಧಿಸದ ಸರ್ವರ್‌ಗಳನ್ನು ಉಳಿಸಿಕೊಳ್ಳುತ್ತದೆ. ಇರುವ JSON ಮಾನ್ಯವಾದ ಕಟ್ಟುನಿಟ್ಟಾದ JSON ಆಗಿರಬೇಕು; Codex TOML ಮೌಲ್ಯಗಳನ್ನು ಉಳಿಸಿಕೊಳ್ಳಲಾಗುತ್ತದೆ, ಆದರೆ ಕಾಮೆಂಟ್‌ಗಳನ್ನು ಮರುಫಾರ್ಮ್ಯಾಟ್ ಮಾಡಬಹುದು.

ಸೆಟಪ್ ನೇರ ರಿಮೋಟ್ HTTP ಗೆ ಆದ್ಯತೆ ನೀಡುತ್ತದೆ. --api-key-env ಜೊತೆಗೆ, ಅದು ಕೀಲಿಯನ್ನು ಎಂದಿಗೂ ಬರೆಯದೆ ವೇರಿಯಬಲ್ ಉಲ್ಲೇಖವನ್ನು ಬರೆಯುತ್ತದೆ. ಆ ಆಯ್ಕೆಯಿಲ್ಲದೆ, ನೇರ HTTP ಕ್ಲೈಂಟ್‌ನ OAuth ಬೆಂಬಲವನ್ನು ಅವಲಂಬಿಸುತ್ತದೆ; ಅದು CLI ಕ್ರೆಡೆನ್ಷಿಯಲ್ ಫೈಲ್ ಅನ್ನು ಬಳಸುವುದಿಲ್ಲ. ಯಾವುದೇ stdio-ಬೆಂಬಲಿತ ಕ್ಲೈಂಟ್‌ನಲ್ಲಿ thunderphone login ಕ್ರೆಡೆನ್ಷಿಯಲ್‌ಗಳನ್ನು ಮರುಬಳಸಲು, ಇದನ್ನು ಬಳಸಿ:

{
  "mcpServers": {
    "thunderphone": {
      "command": "npx",
      "args": ["-y", "@thunderphone/mcp"]
    }
  }
}

ರ್ಯಾಪರ್ ಮೊದಲು THUNDERPHONE_API_KEY ಅನ್ನು, ನಂತರ ಪ್ರಸ್ತುತ CLI ಪ್ರೊಫೈಲ್ ಅನ್ನು ಪರಿಶೀಲಿಸುತ್ತದೆ (ಅಗತ್ಯವಿದ್ದಾಗ ರಿಫ್ರೆಶ್ ಮಾಡುತ್ತದೆ), ನಂತರ OAuth ಅನ್ನು mcp-remote ಗೆ ನಿಯೋಜಿಸುತ್ತದೆ. THUNDERPHONE_MCP_URL ಎಂಡ್‌ಪಾಯಿಂಟ್ ಅನ್ನು ತಿದ್ದಿಬರೆಯುತ್ತದೆ. ಇದು ಯಾವುದೇ ಟೆಲಿಮೆಟ್ರಿಯನ್ನು ಕಳುಹಿಸುವುದಿಲ್ಲ. ಸ್ವತಂತ್ರ ಸೆಟಪ್ ಸಹ npx -y @thunderphone/mcp setup --client cursor ಮೂಲಕ ಅಥವಾ @thunderphone/mcp ಅನ್ನು ಜಾಗತಿಕವಾಗಿ ಸ್ಥಾಪಿಸಿದ ನಂತರ thunderphone-mcp setup ಮೂಲಕ ಲಭ್ಯವಿದೆ.

ಪ್ರಾಜೆಕ್ಟ್ ರಚಿಸಿ

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

ಟೆಂಪ್ಲೇಟ್‌ಗಳು node ಮತ್ತು python; ಏಜೆಂಟ್ ಪ್ರಕಾರಗಳು receptionist, outbound, ಮತ್ತು custom. ಡೀಫಾಲ್ಟ್ ಏಜೆಂಟ್ ಸ್ಪಷ್ಟ ಡೆಮೋ ಮಾಹಿತಿಗಳಿರುವ ಇಂಗ್ಲಿಷ್/ಸ್ಪ್ಯಾನಿಷ್ ದಂತ ಚಿಕಿತ್ಸಾಲಯದ ರಿಸೆಪ್ಷನಿಸ್ಟ್ ಆಗಿದೆ. ಪ್ರಾಜೆಕ್ಟ್‌ಗಳಲ್ಲಿ agent.json, ಡಿಪ್ಲಾಯ್ ಸ್ಕ್ರಿಪ್ಟ್‌ಗಳು, Claude Code, Cursor ಮತ್ತು VS Code ಗಾಗಿ MCP ಕಾನ್ಫಿಗರೇಶನ್‌ಗಳು, ಏಜೆಂಟ್ ಸೂಚನೆಗಳು, .env.example, ಮತ್ತು README ಇರುತ್ತವೆ. ಸ್ಕ್ಯಾಫೋಲ್ಡಿಂಗ್ ಆಫ್‌ಲೈನ್ ಆಗಿದ್ದು, ಖಾಲಿಯಲ್ಲದ ಡೈರೆಕ್ಟರಿಯನ್ನು ತಿದ್ದಿಬರೆಯಲು ನಿರಾಕರಿಸುತ್ತದೆ.

ಡಿಪ್ಲಾಯ್‌ಮೆಂಟ್‌ಗೆ ಮೊದಲು ವ್ಯವಹಾರ ಮಾಹಿತಿಗಳನ್ನು ಸಂಪಾದಿಸಿ. ರಚಿಸಲಾದ README ಯಲ್ಲಿ ದಾಖಲಿಸಿರುವಂತೆ API ಕೀ, ಸಂಪರ್ಕಿತ ಕರೆಗಾರ ಸಂಖ್ಯೆ ಮತ್ತು ನಿಮ್ಮ ಪರೀಕ್ಷಾ ಸ್ವೀಕರಿಸುವವರನ್ನು ಎಕ್ಸ್‌ಪೋರ್ಟ್ ಮಾಡಿ. npm run deploy ಅಥವಾ python deploy.py ಏಜೆಂಟ್ ಅನ್ನು ರಚಿಸುತ್ತದೆ ಅಥವಾ ನವೀಕರಿಸುತ್ತದೆ, ಅದರ ಡ್ರಾಫ್ಟ್ ಅನ್ನು ಡಿಪ್ಲಾಯ್ ಮಾಡುತ್ತದೆ ಮತ್ತು ಶುಲ್ಕಕ್ಕೆ ಒಳಪಡುವ ಪರೀಕ್ಷಾ ಕರೆಯನ್ನು ಮಾಡುತ್ತದೆ. ಸ್ಕ್ರಿಪ್ಟ್‌ಗಳು API-ಕೀ ದೃಢೀಕರಣವನ್ನು ಬಳಸುತ್ತವೆ; CLI ಮತ್ತು stdio MCP ರ್ಯಾಪರ್ ಸಹ ಸಾಧನ ಲಾಗಿನ್ ಅನ್ನು ಬೆಂಬಲಿಸುತ್ತವೆ. Python ಸ್ಕ್ರಿಪ್ಟ್‌ಗಳಿಗೆ Python 3.9 ಅಥವಾ ನಂತರದ ಆವೃತ್ತಿ ಅಗತ್ಯವಿದೆ.