> ## Documentation Index > Fetch the complete documentation index at: https://help.iteam.works/llms.txt > Use this file to discover all available pages before exploring further. # Codes — código do projeto > Codes são scripts Python ou Node que rodam dentro do projeto, em sandbox isolado. Nesta página você entende os três tipos (job, service e artefato), como o Code acessa dados sem senha no código, e como agentes chamam o seu Code. **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 ## Os três tipos Um código que **roda e termina**. Serve para ETL, relatório diário, importação, limpeza de base. Pode ter agendamento. Uma **API HTTP** com um ou vários endpoints. Fica no ar e responde a chamadas — sua ou de outro sistema. **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: ``` 0 6 * * * todo dia às 06:00 */15 * * * * a cada 15 minutos 0 8 * * 1 toda segunda às 08:00 ``` 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. Defina o que o Code recebe e o que devolve. É isso que o agente enxerga. O Code publicado aparece como chamável na lista. 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 Apague o período antes de gravar. Assim, re-rodar o mesmo dia corrige em vez de duplicar. Faça `GROUP BY` na consulta em vez de trazer milhares de linhas para o Code processar. Uma saída de erro explicando o que faltou vale mais que um stack trace no histórico. Um job que só sabe processar "hoje" não consegue repor um dia perdido. Receber a data resolve.