Integração de API

Quando o usuário pedir para integrar uma API de terceiros ou implementar algo que envolva uma API externa ou SDK, siga este fluxo de trabalho. Não confie no seu próprio conhecimento sobre APIs disponíveis ou suas capacidades — sempre use o servidor MCP context-matic.

Quando Aplicar

Aplique esta habilidade quando o usuário:

• Pedir para integrar uma API de terceiros
• Quiser adicionar um cliente ou SDK para um serviço externo
• Solicitar implementação que dependa de uma API externa
• Mencionar uma API específica (por exemplo, PayPal, Twilio) e implementação ou integração

Fluxo de Trabalho

1. Garantir a Existência de Diretrizes e Habilidades

1a. Detectar o Idioma Principal do Projeto

Antes de verificar diretrizes ou habilidades, identifique o idioma de programação principal do projeto inspecionando o espaço de trabalho:

Use o idioma detectado em todas as etapas subsequentes onde language for necessário.

1b. Verificar a Existência de Diretrizes e Habilidades

Verifique se diretrizes e habilidades já foram adicionadas para este projeto, procurando por sua presença no espaço de trabalho.

• {language}-conventions é a habilidade produzida por add_skills.
• {language}-security-guidelines.md e {language}-test-guidelines.md são arquivos de diretrizes específicos do idioma produzidos por add_guidelines.
• update-activity-workflow.md é um arquivo de diretrizes de fluxo de trabalho produzido por add_guidelines (não é específico do idioma).
• Verifique estes independentemente. Não trate a presença de um conjunto como prova de que o outro conjunto já existe.
• Se algum arquivo de diretrizes necessário para este projeto estiver faltando: Chame add_guidelines.
• Se {language}-conventions estiver faltando para o idioma do projeto: Chame add_skills.
• Se todos os arquivos de diretrizes necessários e {language}-conventions já existirem: Pule esta etapa e prossiga para a etapa 2.

2. Descobrir APIs Disponíveis

Chame fetch_api para encontrar APIs disponíveis — sempre comece aqui.

• Sempre forneça o parâmetro language usando o idioma detectado na etapa 1a.
• Sempre forneça o parâmetro key: passe o nome/chave da API da solicitação do usuário (por exemplo, "paypal", "twilio").
• Se o usuário não forneceu um nome/chave de API, pergunte qual API ele deseja integrar e, em seguida, chame fetch_api com esse valor.
• A ferramenta retorna apenas a API correspondente em caso de correspondência exata, ou o catálogo completo da API (nome, descrição e key) quando não há correspondência exata.
• Identifique a API que corresponde à solicitação do usuário com base no nome e na descrição.
• Extraia a key correta para a API solicitada pelo usuário antes de prosseguir. Essa chave será usada para todas as chamadas de ferramenta subsequentes relacionadas a essa API.

Se a API solicitada não estiver na lista:

• Informe ao usuário que a API não está disponível no momento neste plugin (context-matic) e pare.
• Solicite orientação do usuário sobre como proceder com a integração da API.

3. Obter Orientação de Integração

• Forneça ask com: language, key (da etapa 2) e seu query.
• Divida perguntas complexas em consultas menores e focadas para obter melhores resultados:
  • "Como faço para autenticar?"
  • "Como crio um pagamento?"
  • "Quais são os limites de taxa?"

4. Consultar Modelos e Endpoints de SDK (conforme necessário)

Essas ferramentas retornam apenas definições — elas não chamam APIs nem geram código.

• model_search — consulta a definição de um modelo/objeto.
  • Forneça: language, key e um nome de modelo exato ou parcial, sensível a maiúsculas e minúsculas, como query (por exemplo, availableBalance, TransactionId).
• endpoint_search — consulta os detalhes de um método de endpoint.
  • Forneça: language, key e um nome de método exato ou parcial, sensível a maiúsculas e minúsculas, como query (por exemplo, createUser, get_account_balance).

5. Registrar Marcos

Chame update_activity (com o milestone apropriado) sempre que um destes for concretamente alcançado em código ou infraestrutura — não meramente mencionado ou planejado:

…