Para apoiar o desenvolvimento, a manutenção e o suporte de integrações com o Client Conecta, disponibilizamos um toolkit especializado para uso com ferramentas de Inteligência Artificial. Esse conjunto de recursos consolida o conhecimento técnico necessário para a integração com a DLL Client Conecta, incluindo regras obrigatórias, boas práticas de implementação, exemplos de payloads JSON, códigos de retorno, fluxos operacionais e recomendações de segurança.

👍
Quando utilizado como contexto em plataformas de IA, como GitHub Copilot, ChatGPT, Claude, Gemini, Cursor e outras soluções semelhantes, o toolkit permite que os modelos compreendam as particularidades da integração e forneçam respostas mais precisas e consistentes. Com isso, é possível acelerar atividades como geração de código, revisão de implementações, diagnóstico de problemas e produção de documentação técnica, independentemente da linguagem de programação adotada, como C#, Java, Delphi, Python, Node.js, Go, Rust ou C/C++.

Faça o download do Toolkit de IA.

Entendendo os arquivos

No toolkit de IA são disponibilizados dois arquivos voltados ao uso com ferramentas de Inteligência Artificial:

Skill (skill.md): A Skill (skill.md) é um conjunto de instruções especializadas que orienta a IA a atuar como uma especialista em integração com o Client Conecta.
Agente integrador (agente.md): O Agente Integrador (agente.md) possui a mesma base de conhecimento da Skill, porém estruturada como uma persona técnica especializada. Ao ser utilizado, a IA assume continuamente o papel de Agente Integrador Especialista e Agnóstico de Linguagem em Client Conecta. Além de responder dúvidas sobre integração, o Agente consegue conduzir diagnósticos completos, revisões arquiteturais e investigações de erros durante toda a conversa.

Skill ou Agente integrador: Qual utilizar?

Embora compartilhem o mesmo conhecimento técnico, cada arquivo possui um objetivo diferente.

Aspecto	Skill (`skill.md`)	Agente integrador (`agente.md`)
Objetivo principal	Fornecer conhecimento especializado e regras de integração sob demanda.	Atuar como um especialista completo em Client Conecta durante toda a conversa.
Caso de uso	Consultas pontuais e regras específicas. Adicionar como contexto/skill de um agente de IA.	Projetos completos e acompanhamento contínuo da integração. Usar como prompt de sistema/persona dedicada.
Escopo de conhecimento	Geração de payloads JSON, regras obrigatórias, boas práticas, validação de regras, revisão de código, interpretação de erros e fluxos operacionais, e validações	Arquitetura de integração, geração de código, revisão de implementação, diagnóstico de problemas, interpretação de retornos da DLL, produção de documentação técnica e acompanhamento da integração ponta a ponta.
Tipo de resposta	Direta e focada em regras, exemplos e validações.	Mais abrangente, incluindo análises, recomendações e diagnósticos estruturados.

📘
Na prática, ambos se complementam. A Skill pode ser carregada como conhecimento adicional, enquanto o Agente pode ser configurado como uma persona dedicada exclusivamente ao Client Conecta.

Como utilizar a Skill e o Agente integrador?

Boas práticas de uso com IA

Sempre inclua o arquivo (skill.md ou agente.md) como contexto antes de pedir geração ou revisão de código. Sem esse contexto, a IA pode inventar regras incorretas (por exemplo, usar Environment="PROD" em vez de "0");
Ao pedir revisão de código já existente, cole o trecho relevante junto com o pedido para que a IA aponte divergências específicas com as hard rules;
Prefira pedidos objetivos e específicos (uma operação por vez) para obter respostas mais precisas;
Sempre valide manualmente se dados sensíveis (PAN, PIN, ClientSecret) não aparecem em nenhum log gerado pela IA antes de subir o código para produção;
Reforce, quando necessário, que a IA não deve usar API HTTP direta da Cielo - apenas a função RequestDispatcher da DLL;
Sempre teste em ambiente de homologação (Environment="1") antes de qualquer alteração ir para produção (Environment="0").

Referência rápida das operações (Oper)

Oper	Operação
`1`	Inicialização
`2`	Cadastro do estabelecimento
`3`	Desativação do terminal
`4`	Status da biblioteca
`5`	Pagamento / Estorno
`6`	Reemissão de comprovante
`7`	Confirmação / Desfazimento manual
`8`	Consulta de transação

📘
Para obter o detalhamento completo de cada operação, incluindo payloads, fluxos de processamento, códigos de erro, regras de negócio e exemplos de implementação, consulte sempre os arquivos originais skill.md e agente.md, que constituem a fonte oficial de referência da documentação.