Como Usar

Tools Disponíveis

As tools são funções que você pode chamar diretamente no chat do Copilot ou Cursor. Elas aparecem automaticamente quando você menciona algo relacionado ao Tap To Pay SDK.

quickstart

Ferramenta de boas-vindas que fornece uma mensagem inicial sobre as capacidades do servidor.

Quando usar: Quando você não tem certeza de qual tool usar ou quer uma visão geral.

Como usar no chat:

Use a tool quickstart

Ou simplesmente pergunte:

Como posso usar o Tap To Pay SDK no Android?

chat_android

Ferramenta para fazer perguntas sobre integração do Tap To Pay SDK no Android.

Tag: ["android"]

Parâmetros:

• msg (string, obrigatório): Sua pergunta sobre Tap To Pay Android

Como usar no chat:

Opção 1 - Pergunta direta:

Como inicializar o Tap To Pay SDK no Android?

O Copilot/Cursor automaticamente usará a tool chat_android quando detectar que sua pergunta é sobre Android.

Opção 2 - Chamada explícita:

Use a tool chat_android with msg="Como inicializar o Tap To Pay SDK no Android?"

Exemplos de perguntas:

• "Como inicializar o Tap To Pay SDK no Android?"
• "Como processar um pagamento com Tap To Pay no Android?"
• "Quais são as dependências necessárias para o Tap To Pay Android?"
• "Como configurar o Pix no Tap To Pay Android?"
• "Como tratar erros de conexão no Tap To Pay Android?"

Prompts Disponíveis

Os prompts são templates pré-configurados que geram instruções para usar as tools corretamente. Eles ajudam o modelo a entender melhor como chamar as ferramentas.

generate_tap to pay_prompt

Prompt que gera uma instrução para chamar a tool apropriada com base no tópico e plataforma especificados.

Parâmetros:

• topic (string, obrigatório): O tópico específico sobre Tap To Pay SDK
  • Valores suportados: "initialization", "payment", "pix", "gateway", "dependencies", "basic-integration"
• platform (string, opcional): Plataforma alvo
  • Valores: "android" (padrão)

Tópicos Disponíveis:

• initialization: Inicialização e configuração do SDK
• payment: Processamento de pagamentos
• pix: Processamento de pagamentos Pix
• gateway: Configuração de gateway de pagamento
• dependencies: Dependências necessárias
• basic-integration: Integração completa básica

Como usar:

Os prompts são usados automaticamente pelo modelo quando você faz perguntas. Mas você também pode referenciá-los explicitamente:

Preciso de ajuda com inicialização do Tap To Pay SDK no Android

O modelo usará o prompt generate_tap to pay_prompt com topic="initialization" e platform="android", que então gerará uma instrução para usar a tool chat_android.

Como Usar

Fazendo Perguntas Simples

A forma mais fácil é simplesmente fazer uma pergunta no chat:

Exemplo:

Como inicializar o Tap To Pay SDK no Android?

O Copilot/Cursor automaticamente:

1. Detecta que é uma pergunta sobre Android
2. Usa a tool chat_android
3. Retorna a resposta da API

Usando Tools Explicitamente

Você também pode chamar as tools explicitamente:

Use a tool chat_android with msg="Como inicializar o Tap To Pay SDK? Preciso de um exemplo completo."

Mantendo Contexto da Conversa

O servidor mantém automaticamente o contexto da conversa através de session_id. Você pode fazer perguntas de acompanhamento:

Primeira pergunta:

Como inicializar o Tap To Pay SDK no Android?

Pergunta de acompanhamento:

E como processar um pagamento depois?

O sistema mantém o contexto e fornece respostas relacionadas.

Usando Tags para Filtrar

As tools têm tags que ajudam o modelo a escolher a ferramenta correta:

• ["android"] → chat_android

Mencione a plataforma na sua pergunta para garantir que a tool correta seja usada.

Exemplos Práticos

Integração Inicial do SDK

No chat do Cursor/Copilot:

Preciso integrar o Tap To Pay SDK no meu app Android. Como faço a inicialização completa? Inclua todas as dependências e configurações necessárias.

O que acontece:

1. O sistema detecta "Android" e "inicialização"
2. Usa a tool chat_android com sua pergunta
3. Retorna instruções completas sobre inicialização

Processamento de Pagamento

No chat:

Como processar um pagamento com Tap To Pay no Android? Preciso de um exemplo de código completo com tratamento de erros.

O que acontece:

1. Detecta "Android" e "processar pagamento"
2. Usa a tool chat_android
3. Retorna exemplo de código com tratamento de erros

Resolução de Problemas

Primeira pergunta:

Estou recebendo o erro "SDK not initialized" ao tentar usar o Tap To Pay no Android. O que pode estar errado?

Pergunta de acompanhamento:

Como resolver esse erro? Preciso verificar se estou inicializando corretamente.

O que acontece:

1. Primeira pergunta usa chat_android e cria uma sessão
2. Segunda pergunta usa a mesma sessão, mantendo contexto
3. Resposta considera o erro mencionado anteriormente

Consulta Específica sobre Dependências

No chat:

Quais são todas as dependências necessárias para usar Tap To Pay no Android? Inclua versões recomendadas.

O que acontece:

1. Detecta "Android" e "dependências"
2. Usa chat_android com pergunta específica
3. Retorna lista completa de dependências com versões