---
title: "ThunderPhone CLI"
description: "டெர்மினலில் இருந்து உள்நுழையுங்கள், குரல் ஏஜென்ட்கள் மற்றும் அழைப்புகளை நிர்வகியுங்கள், MCP கிளையன்ட்களை உள்ளமைக்குங்கள், திட்டங்களுக்கான அடித்தளத்தை உருவாக்குங்கள்."
---

CLI-க்கு Node.js 18.18 அல்லது அதற்குப் பிந்தைய பதிப்பு தேவை. இதை `npx` மூலம் இயக்கவும் அல்லது உலகளாவிய அளவில் நிறுவவும்:

```bash
npm install -g thunderphone
thunderphone --help
```

## உள்நுழைக

```bash
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` அடைவை
மாற்றியமைக்கும். அணுகல் டோக்கன்கள் தானாகப் புதுப்பிக்கப்படும்; சுழலும் புதுப்பிப்பு டோக்கன்கள் அணு முறையில்
சேமிக்கப்படும். உள்நுழைவு டோக்கன்களை ஒருபோதும் அச்சிடாது.

```bash
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` | US உள்வரும் எண்ணை வழங்கவும் |
| `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` மூலம் அதை ஆய்வு செய்து, அது தயாரான பிறகும்
மேப் செய்யப்பட்ட புலங்கள் மற்றும் எச்சரிக்கைகளை மதிப்பாய்வு செய்த பிறகும் மட்டுமே உறுதிப்படுத்தவும்.
[ஏஜென்ட் இறக்குமதிகள்](/ta/guides/import-agents) என்பதைப் பார்க்கவும்.

## MCP அமைப்பு

```bash
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`
சான்றுகளை மீண்டும் பயன்படுத்த, இதைப் பயன்படுத்துங்கள்:

```json
{
  "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` மூலமாகவும் கிடைக்கும்.

## ஒரு திட்டத்தை உருவாக்குங்கள்

```bash
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 அல்லது அதற்குப் பிந்தைய பதிப்பு தேவை.