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-ஐ ஒதுக்கிவைக்கிறது.

வெளிச்செல்லும் அழைப்புகளுக்கு இணைக்கப்பட்ட கேரியர் எண் தேவை. 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 அல்லது அதற்குப் பிந்தைய பதிப்பு தேவை.