InícioDocs para devsComo usar a IA para criar uma integração Python
Como usar a IA 2 min de leitura

Como usar a IA para criar uma integração Python

Use a interface Python pública em código confiável, preservando autorização por campanha e transações.

Substitua os valores entre colchetes antes de enviar. Forneça os arquivos públicos relevantes da release alvo exata; use exemplos sintéticos e deixe credenciais, campanhas privadas e material proprietário fora do contexto.

O que você vai construir

Monte um relatório somente leitura com dados autorizados de atores/diários. Execute em uma instalação de desenvolvimento isolada, com um usuário que realmente pertence à campanha.

Contexto para fornecer à IA

  • A seção da interface Python em docs/pt-BR/api.md e os exports em api/.

  • docs/pt-BR/architecture.md: membros, Context, serviços e eventos após commit.

  • A versão alvo e as assinaturas/testes reais das funções públicas usadas pelo relatório.

Passo a passo

  1. Diferencie uma integração confiável de servidor de um módulo de navegador; o navegador não recebe execução arbitrária de Python.

  2. Defina usuário e campanha explicitamente; construir Context não concede permissão.

  3. Peça primeiro uma implementação de leitura pela interface pública e pelas projeções atuais.

  4. Se depois houver gravações, revise separadamente identidade da operação, revisão esperada e notificações.

Copie e adapte este prompt

text
Repositório: [checkout local ou repositório público]
Release alvo do host: [versão instalada/solicitada; preserve-a]
Escopo e autorização: [o que pode ser alterado/publicado]

Implemente um relatório de campanha somente leitura em código Python confiável para esta release.
Inicialize o Django pelo ambiente documentado. Confira exports e assinaturas em api/ e use api.Context com campanha/usuário explícitos. Não invente endpoint REST nem autenticação por chave.
Leia somente os recursos autorizados ao usuário; não contorne a API com consultas ORM diretas, imports privados do host ou gravações no banco.
Forneça um exemplo sintético curto e trate ausência de vínculo, negação de permissão e recurso inexistente.
Mantenha configuração, saídas temporárias e caches na instalação ou em um diretório de teste explicitamente descartável. Não copie credenciais reais para logs ou relatórios.

Examine os arquivos reais e APIs suportadas antes de propor código. Não invente comandos, campos, endpoints ou capacidades de pacotes.
Use dados de teste descartáveis e ferramentas/caches locais à instalação. Explique requisitos sem suporte e valide o resultado com as ferramentas reais do projeto.
Entregue arquivos ou passos concretos no editor, verificações realizadas e limitações pendentes.

Como validar

  • Compare relatórios de GM e de jogador autorizado; confira que o servidor filtra recursos ocultos antes da saída.

  • Tente outra campanha e um vínculo revogado; confira a negação de acesso.

  • Verifique que gerar o relatório não altera o banco nem envia mensagens/rolagens.

Pronto quando

O relatório usa funções públicas suportadas, expõe apenas dados autorizados ao usuário e não causa gravações.

Continue pela referência de módulos, API pública e guia de testes.