Habilidade de IA

O vcr-app-creator A skill é uma skill de agente de IA que oferece orientação especializada e passo a passo para a criação e implantação de Applications no Vonage Cloud Runtime. Depois de instalada, ela é ativada automaticamente sempre que você pedir ao seu assistente de IA para criar um aplicativo VCR, escrever um vcr.yml gerar um manifesto, configurar segredos, fazer a implantação, depurar localmente ou publicar no Code Hub.

Instalação

npx skills add "vonage-technology/vonage-agent-skills" --skill vcr-app-creator

A habilidade está hospedada no competências-dos-agentes-da-Vonage repositório. É compatível com qualquer assistente de programação de IA que suporte o protocolo Skills (Claude Code, GitHub Copilot CLI, Gemini CLI e outros).

O que a habilidade faz

Quando ativada, a habilidade o orienta por um fluxo de trabalho estruturado:

  1. Compreender o aplicativo — coleta o nome do projeto, o tempo de execução, o ID do aplicativo da Vonage, os recursos, a região e os recursos opcionais. Se você não tiver um ID do aplicativo da Vonage, a skill é executada vcr app create para você.
  2. Gerar vcr.yml — gera um manifesto válido contendo apenas as seções de que seu aplicativo precisa.
  3. Gerar build.sh — gera um script de compilação adequado ao ambiente de execução que instala as dependências e compila o código sem iniciar o aplicativo.
  4. Configurar verificação de integridade, ambiente e segredos — adiciona o endpoint de verificação de integridade necessário, explica as variáveis injetadas pelo VCR e mostra como fazer referência a segredos com segurança.
  5. Verificar e confirmar — apresenta todos os arquivos gerados para sua aprovação antes de gravar qualquer coisa no disco.
  6. Orientações para implantação e depuração — percorre vcr debug para o desenvolvimento local e vcr deploy para produção.
  7. Resolução de problemas — identifica falhas comuns (incompatibilidade na rota de verificação de integridade, endereço de ligação incorreto, ausência de segredos, tempo de execução inválido) por meio de uma lista de verificação rápida.

A competência também abrange:

  • Publicação no VCR Code Hub / Marketplace usando o neru-mcp Servidor MCP.
  • Práticas recomendadas para o SDK: escopo da sessão, arquitetura sem estado e uso correto do provedor.
  • Migração do obsoleto neru-alpha pacote para o SDK atual (@vonage/vcr-sdk para o Node.js, vonage_cloud_runtime (para Python).

Gatilhos de ativação

A habilidade é ativada automaticamente em situações como:

  • "Criar um novo aplicativo VCR"
  • "Crie um arquivo vcr.yml para meu aplicativo Node.js"
  • "Como faço para implantar no Vonage Cloud Runtime?"
  • "Configurar o vcr debug para desenvolvimento local"
  • "Publicar meu aplicativo no Code Hub"
  • "Migrar do neru-alpha"

Isso não se aplica a dúvidas gerais sobre a API da Vonage em que a VCR não seja a plataforma de hospedagem.