Skip to main content
Codes são pedaços de código que vivem dentro do projeto. Você escreve na sua IDE, versiona no Git e o iTeam executa num sandbox efêmero e isolado — sem servidor para cuidar, sem credencial no código.
A aba Codes de um projeto

📸 Screenshot a inserir [/pt/projetos/codes]: a aba Codes de um projeto mostrando o token do projeto, os recursos de dados e a lista de Codes com o botão Rodar agora.

​
Os três tipos

Job

Um código que roda e termina. Serve para ETL, relatório diário, importação, limpeza de base. Pode ter agendamento.

Service

Uma API HTTP com um ou vários endpoints. Fica no ar e responde a chamadas — sua ou de outro sistema.

Artefato

Telas React com o design system do iTeam. Consomem a sua API e viram uma interface de verdade dentro da plataforma.

​
Dados sem senha no código

Esta é a parte que muda como você escreve. O Code nunca carrega endereço de banco nem senha: ele pede o recurso e o servidor resolve.
Analítico e colunar — feito para agregação e volume. Você usa datastore.query(sql).Cada projeto tem a sua própria base, isolada das demais. Um Code nunca enxerga o Data Store de outro projeto.
Relacional, leitura e escrita, com db.query(sql) e db.execute(sql). Também isolado por projeto.
Adicione agentes ao projeto e o Code passa a usar as ferramentas deles — MCPs, APIs, HTTP tools e fontes de dados — via agent_tools().Os segredos ficam no cofre e são resolvidos no servidor. Tirou o agente do projeto, o Code perde o acesso na hora.
Use resources() no início do Code para descobrir o que está disponível naquele projeto. A sua IDE detecta tudo sozinha — nome e schema de cada ferramenta.

​
O token do projeto

O deploy é feito por API, com um token de projeto (pct_...). Ele fica na aba Codes, com ações para copiar, rotacionar e revogar.
O token dá acesso de escrita ao seu projeto. Guarde no .env e nunca no Git. Se ele vazar, use Rotacionar — o antigo deixa de valer na hora.

​
Agendamento

Um job pode rodar sozinho, num horário fixo, usando notação cron:
Também dá para disparar na hora, pelo botão Rodar agora, e acompanhar o histórico de execuções com status, duração e saída.

​
Agentes chamando o seu Code

Um Code publicado com contrato (entrada e saída declaradas) vira uma ferramenta que os agentes do projeto podem chamar sozinhos.
1

Declare o contrato

Defina o que o Code recebe e o que devolve. É isso que o agente enxerga.
2

Publique

O Code publicado aparece como chamável na lista.
3

O agente usa

Numa conversa, o agente decide chamar o seu Code quando a pergunta pedir — e usa o resultado na resposta.

​
Continue de onde parou

O código fica versionado no Git da plataforma. Antes de mexer num Code que já existe, faça pull — assim você continua de onde parou em vez de recriar.
O pull traz o arquivo principal e os arquivos extras do Code. É a forma confiável de ter uma cópia local fiel.

​
Boas práticas

Deixe o job idempotente

Apague o período antes de gravar. Assim, re-rodar o mesmo dia corrige em vez de duplicar.

Agregue na fonte

Faça GROUP BY na consulta em vez de trazer milhares de linhas para o Code processar.

Falhe com mensagem clara

Uma saída de erro explicando o que faltou vale mais que um stack trace no histórico.

Aceite parâmetro de data

Um job que só sabe processar “hoje” não consegue repor um dia perdido. Receber a data resolve.