O Agente (agente.md) do Toolkit de IA foi projetado para ser utilizado como um prompt de sistema (system prompt) ou como a mensagem inicial de uma sessão dedicada. Ao carregar esse arquivo, a IA assume continuamente a identidade de especialista descrita no Agente durante toda a conversa, mantendo o contexto técnico e as regras de integração do Client Conecta.

Uso no GitHub Copilot CLI (Agente customizado)

O GitHub Copilot CLI permite a criação de agentes personalizados. Nesse cenário, o conteúdo do arquivo agente.md pode ser utilizado como base para um agente especializado em integração com o Client Conecta. Para fazer isso, siga o passo-a-passo abaixo:

Copie o conteúdo completo do arquivo agente.md;
Configure-o como prompt de sistema do agente customizado, conforme a documentação de agentes do GitHub Copilot CLI;
Inicie uma conversa e faça suas solicitações normalmente, sem a necessidade de explicar novamente o contexto técnico a cada interação.

Uso no ChatGPT, Claude ou Gemini

Você também pode utilizar o Agente em ferramentas de IA generativa que permitam definir instruções iniciais ou agentes personalizados. Para fazer isso, siga o passo-a-passo abaixo:

Crie uma nova conversa ou projeto customizado (caso a plataforma ofereça esse recurso);
Cole o conteúdo completo do arquivo agente.md como instrução inicial da sessão;
A partir desse momento, interaja normalmente com a IA para solicitar geração de código, revisões, diagnósticos de falhas, documentação técnica e outras atividades relacionadas à integração.

Exemplo de prompt inicial

[conteúdo do agente.md]

A partir de agora, você é o Agente Integrador Client Conecta. Preciso criar uma aplicação desktop em Python (usando ctypes) que inicialize a DLL, realize um pagamento no crédito parcelado em 3x sem juros e exiba o comprovante do cliente na tela.

Diagnóstico de problemas com o Agente

Um dos principais diferenciais do Agente é sua capacidade de realizar diagnósticos estruturados, auxiliando na identificação da causa raiz de erros e na definição das ações corretivas necessárias.

Exemplo de solicitação

Estou recebendo o código de retorno imediato 57 ao chamar o RequestDispatcher com Oper="005". O que isso significa e como devo corrigir?

Exemplo de resposta esperada da IA

Código 57 = CFL_ERROR_MCH_NFOUND (estabelecimento não cadastrado).
Causa provável: a operação Oper="2" (cadastro do estabelecimento) ainda não 
foi executada para este TerminalId/CNPJ antes da tentativa de pagamento. 
Como corrigir: executar a operação de cadastro do estabelecimento (Oper="2") 
antes de qualquer chamada de pagamento (Oper="005"), e validar novamente 
após CFL_OK=0. 
Versão corrigida, se necessário: ajustar o fluxo de inicialização da aplicação 
para garantir a chamada de Oper="2" na primeira execução do terminal.

Exemplo de geração de aplicação completa

Além de responder dúvidas específicas, o Agente também pode auxiliar na criação de projetos completos.

Exemplo de solicitação

Usando o Agente Integrador Client Conecta, gere a estrutura inicial de um projeto em C# (.NET) para um totem de autoatendimento, contendo:

- Carregamento da DLL clientconecta.dll via P/Invoke
- Módulo de configuração (config.ini)
- Tela de pagamento com notificações WAITCARD, GETPIN, PROCESSING e REMOVECARD
- Exibição do comprovante do cliente e do estabelecimento
- Botão de estorno da última transação aprovada
- Logs em arquivo com ClientSecret mascarado

Nessa situação, o Agente poderá gerar a arquitetura inicial da solução, sugerir a organização de pastas, criar componentes de integração e aplicar automaticamente as regras e boas práticas definidas para o Client Conecta.