Open in
Desenvolva com Claude Code, Codex ou Cursor
Instale as Agent Skills do ThunderPhone, conecte o servidor MCP do ThunderPhone e forneça a um agente de programação a documentação atual do produto.
O ThunderPhone oferece três camadas para agentes de programação:
| Camada | O que oferece ao agente |
|---|---|
| Habilidades do agente | Procedimentos focados para agentes, prompts, números, chamadas, ferramentas, webhooks, conhecimento, testes, aprimoramento de um agente em ciclo fechado, campanhas, widgets, frameworks em tempo real e migrações. |
| MCP | Ferramentas autenticadas abrangem agentes, números, chamadas, testes, conhecimento, ferramentas/webhooks, campanhas, vozes, importações e documentação à medida que são disponibilizadas; chame tools/list para ver o catálogo atualizado. |
| Documentação bruta | Fontes atuais em Markdown sobre o comportamento do produto e detalhes da API. |
As habilidades explicam como realizar o trabalho. O MCP permite que o agente de programação inspecione e atue na sua organização. A documentação bruta fornece o material de origem para perguntas fora de uma habilidade carregada.
Instale em um projeto
Este bloco instala as habilidades, disponibiliza a chave para o shell atual e adiciona o servidor MCP com escopo de projeto ao Claude Code. Substitua o marcador lendo o valor real no seu gerenciador de segredos; não cole uma chave em um repositório ou chat.
npx skills add thunderphone/skills
export THUNDERPHONE_API_KEY='replace-with-value-from-your-secret-manager'
claude mcp add --transport http --scope project \
--header 'Authorization: Bearer ${THUNDERPHONE_API_KEY}' \
thunderphone https://api.thunderphone.com/v1/mcpPara o Codex, substitua o comando final por:
codex mcp add thunderphone \
--url https://api.thunderphone.com/v1/mcp \
--bearer-token-env-var THUNDERPHONE_API_KEYO Cursor lê uma configuração de projeto em .cursor/mcp.json:
{
"mcpServers": {
"thunderphone": {
"type": "http",
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
}
}
}
}O VS Code usa o mesmo servidor sob uma chave servers em .vscode/mcp.json:
{
"servers": {
"thunderphone": {
"type": "http",
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
}
}
}
}Exemplo de sessão: recepcionista odontológica bilíngue
- Peça ao agente de programação para carregar
create-agent,thunderphone-prompt-builder,build-tool-integration,add-knowledgeetest-agent. Diga a ele para planejar primeiro e ainda não criar recursos. - Forneça fatos verificados sobre a clínica, tarefas compatíveis, regras de escalonamento e os dois idiomas obrigatórios. Peça que ele verifique o catálogo de vozes disponível e os idiomas compatíveis, em vez de inventar uma voz ou idioma.
- Peça um único prompt de produção baseado em princípios gerais e fatos. O agente deve mudar para o idioma compatível de quem liga, manter a fala concisa, fazer uma pergunta por vez e evitar scripts de resposta de quem liga.
- Peça que ele defina uma ferramenta de agendamento restrita e anexe apenas o conhecimento necessário para a recepcionista. Teste sucesso da ferramenta, ausência de disponibilidade, entrada inválida, tempo limite e transferência para uma pessoa antes da implantação.
- Gere cenários para ambos os idiomas, interrupções, correções, informações ausentes, perguntas sobre conhecimento, falhas de agendamento e escalonamento. Execute-os, inspecione transcrições e evidências da ferramenta, corrija a menor regra geral e execute novamente o mesmo conjunto.
- Revise o rascunho exato e as evidências de teste e, em seguida, autorize explicitamente a implantação e a associação do número. Faça uma chamada de áudio controlada em cada idioma antes de encaminhar tráfego real.
Melhore um agente em um ciclo fechado
Quando um agente começar a atender chamadas, peça ao agente de programação para carregar iterate-on-agent.
A habilidade executa o mesmo ciclo que o ThunderPhone usa em seus próprios agentes, para que cada
alteração seja medida antes de ser lançada:
- Leia o agente, suas revisões de prompt e o guia de estilo de prompts. As revisões de prompt estão disponíveis por REST e MCP, para que um agente de programação possa inspecionar diretamente alterações recentes no prompt.
- Crie conjuntos de teste.
import_conversationstransforma chamadas recentes, ou chamadas selecionadas porcall_ids, em conversas de teste e seus momentos mais difíceis em exemplos com gabaritos de resposta;generate_conversationscria essas conversas para um novo agente, incluindo quem liga com casos difíceis voltados aos pontos fracos do prompt (esses sempre vão para a divisão de desenvolvimento). Cada conversa fica em uma divisão de desenvolvimento, para ajuste, ou em uma divisão de teste, para medição única. Uma chamada cujo participante está em uma divisão de teste é reservada: para uma chave de API ou token OAuth, tanto por REST quanto por MCP, ela retorna apenas seu ID, horário de início eheld_out: true; gravações nela são recusadas (held_out_call), assim como cenários de teste promovidos a partir dela; deixe-a de fora durante o ajuste. - Estabeleça uma referência com
run_replaysna divisão de desenvolvimento. Com Bolt v2, um turno com áudio gravado é reproduzido como seria em uma chamada ao vivo. - Edite o rascunho.
review_promptverifica o prompt em relação ao guia de estilo e oferece edições de localizar e substituir;update_agentaplica-as ao rascunho comprompt_edits; uma segunda revisão comprevious_promptverifica o que mudou.refactor_promptreescreve um prompt que acumulou correções demais e informa qualquer comportamento que tenha alterado. Quando uma edição adiciona ou remove um comportamento,refresh_conversationsatualiza as conversas de teste para o novo prompt, restaurando versões anteriores quando uma regra retorna. - Verifique com
run_replaysem comparação com a referência, lendo as falhas como quem liga as ouviria.compare_configstesta um nível de audição, voz, detecção de fim de fala ou nível de inteligência diferente nos mesmos exemplos de desenvolvimento; as comparações são exclusivas do ambiente de desenvolvimento. - Meça uma vez na divisão de teste. Uma execução de teste reproduz uma coorte inteira de teste, e seu primeiro resultado a consome; portanto, cada execução de teste posterior, para qualquer prompt, precisa de novos dados de teste de chamadas importadas ou conversas geradas. O mecanismo de cada exemplo é definido antes da execução com base nos seus dados (áudio gravado é reproduzido exatamente, exemplos somente de texto como texto).
Os totais são fornecidos por mecanismo, e nada volta para texto: uma coorte com áudio gravado em uma configuração diferente de Bolt v2 é recusada (
test_needs_exact_replay) e permanece sem uso; portanto, meça essa configuração no ambiente de desenvolvimento. Agentes de programação recebem apenas seus totais, para que não possam fazer ajustes com base nela. - Ouça uma gravação de
run_simulationou abra um link de conversa e fale você mesmo com o rascunho. - Implante quando você decidir.
Tudo o que consome créditos exige uma cotação primeiro: envie dry_run: true para obter uma
estimativa e execute com o respectivo quote_id e max_cost_cents, um limite rígido. Uma
cotação paga por uma execução: tarefas de conversa, execuções de replay e revisões
e refatorações de prompt que chamam o modelo a consomem, de forma persistente, quando são iniciadas,
e uma execução recusada ou que falha primeiro mantém a cotação utilizável; depois que ela é
usada, repita uma execução com falha com uma nova simulação. Cada solicitação
reserva o maior custo possível antes de ser enviada, e a execução é cobrada pelo
custo real, portanto mantenha a margem da estimativa. Um replay exato reserva
cerca de 85 centavos a $1.25 por replay em andamento para um turno típico
(um turno normal mais uma nova execução de produção), diante de um custo real de poucos
centavos: defina um limite com margem para execuções de replay. Um turno que ainda fica sem
orçamento é contabilizado separadamente e não consome nenhuma coorte de teste. Um agente
executa uma tarefa de conversa ou execução de replay por vez. Com OAuth, as ferramentas de
prompt precisam do escopo agents:write. Quando a gravação de uma chamada é desativada
ou a chamada é excluída, as conversas de teste e os exemplos obtidos dela
também são removidos. As ferramentas de conversa de teste,
replay, revisão de prompt e link de conversa fazem parte do kit de ferramentas de iteração do agente,
que é habilitado por organização enquanto está em beta; peça ao
suporte para habilitá-lo.
Use o SDK Python ou TypeScript para solicitações REST tipadas.
Use REST em vez de MCP quando uma implementação precisar de payloads determinísticos,
fixtures versionadas, orquestração em massa ou uma operação que não esteja presente
na lista atual de ferramentas MCP. A API começa em https://api.thunderphone.com/v1; consulte a
introdução à API e o
guia MCP.