Perguntas frequentes
Noções básicas
O Colaboratory ou “Colab” é um produto do Google Research, área de pesquisas científicas do Google. O Colab permite que qualquer pessoa escreva e execute código Python arbitrário pelo navegador e é especialmente adequado para aprendizado de máquina, análise de dados e educação. Mais tecnicamente, o Colab é um serviço de notebooks hospedados do Jupyter que não requer nenhuma configuração para usar e oferece acesso sem custo financeiro a recursos de computação como GPUs.
Sim. Não há custos financeiros para usar o Colab.
Os recursos do Colab não são garantidos nem ilimitados, e os limites de uso às vezes flutuam. Isso é necessário para que o Colab possa oferecer recursos sem custo financeiro. Para saber mais detalhes, consulte Limites de recurso
O Colab Pro pode ser uma opção para usuários que buscam um acesso mais confiável a recursos melhores.
Os recursos do Colab são priorizados para casos de uso interativos. Proibimos ações associadas à computação em massa, que afetam negativamente outras pessoas e que tentam contornar nossas políticas. As ações a seguir não são permitidas nos ambientes de execução do Colab:
- Hospedar arquivos, veicular mídias ou exibir outras ofertas de serviços da Web não relacionadas à computação interativa com o Colab
- Fazer o download de torrents ou compartilhar arquivos ponto a ponto
- Usar controles remotos, como shells SSH, áreas de trabalho e IUs remotas
- Fazer conexão com proxies remotos
- Fazer a mineraração de criptomoedas
- Executar ataques de negação de serviço
- Fazer o cracking de senhas
- Usar várias contas para contornar restrições de acesso ou uso de recursos
- Criar deepfakes
Existem outras restrições para usuários pagantes aqui.
O Jupyter é o projeto de código aberto em que o Colab se baseia. O Colab permite que você use e compartilhe notebooks do Jupyter com outras pessoas, sem precisar fazer nenhum download, instalação nem executar nada.
Como usar o Colab
Os notebooks do Colab são armazenados no Google Drive ou podem ser carregados pelo GitHub. Os notebooks do Colab podem ser compartilhados da mesma forma que Documentos ou Planilhas Google. Basta clicar no botão Compartilhar no canto superior direito de qualquer notebook do Colab ou seguir as instruções de compartilhamento de arquivos do Google Drive.
Se você decidir compartilhar seu notebook, todo o conteúdo dele (texto, código, saída e comentários) será compartilhado. É possível impedir que a saída das células de código sejam salvas ou compartilhadas em Editar > Configurações do notebook > Omitir saída da célula de código ao salvar este notebook. A máquina virtual que você está usando não será compartilhada, nem os arquivos e as bibliotecas que você configurou. Não é uma boa ideia incluir células que instalem e carreguem alguma biblioteca ou arquivos personalizados de que seu notebook precisa.
Sim. No menu Arquivo, selecione "Fazer upload de notebook".
É possível pesquisar notebooks do Colab usando o Google Drive. Clique no logotipo do Colab na parte superior esquerda da visualização de notebooks para ver todos eles no Drive. Você também pode pesquisar notebooks abertos recentemente em Arquivo > Abrir notebook.
O código será executado em uma máquina virtual particular da sua conta. As máquinas virtuais são excluídas quando estão inativas por muito tempo e têm um ciclo de vida máximo restringido pelo serviço do Colab.
É possível fazer o download de qualquer notebook do Colab criado por você a partir do Google Drive, usando estas instruções ou no menu Arquivo do Colab. Todos os notebooks do Colab são armazenados no formato de notebook de código aberto do Jupyter ( .ipynb).
Selecione Ambiente de execução > Desconectar e excluir ambiente de execução para fazer com que as máquinas virtuais atribuídas a você voltem ao estado original. Isso pode ser útil quando a máquina virtual não está íntegra devido à substituição acidental do sistema de arquivos ou à instalação de software incompatível. O Colab limita a frequência com que isso pode ser feito para impedir o consumo indevido de recursos. Se ocorrer alguma falha em uma tentativa, tente novamente mais tarde.
drive.mount()
às vezes falha e mostra o aviso de "tempo esgotado", e por que as operações de E/S das pastas montadas com drive.mount()
às vezes não funcionam?As operações do Google Drive podem expirar quando o número de arquivos ou subpastas de uma pasta é muito grande. Se houver milhares de itens diretamente na pasta "Meu Drive", é provável que a montagem do Drive expire. Tentar de novo várias vezes pode funcionar, já que cada tentativa frustrada armazena o estado parcial em cache localmente antes de expirar. Se você tiver esse problema, tente mover os arquivos e as pastas contidos diretamente em "Meu Drive" para subpastas. Um problema similar ocorre ao ler outras pastas depois de um drive.mount()
. Acessar arquivos em qualquer pasta que contenha itens demais pode provocar erros como Erro de entrada/saída OSError: [Errno 5]
. Novamente, esse problema pode ser resolvido ao mover os itens diretamente para subpastas.
Talvez excluir arquivos ou subpastas movendo-os para a lixeira não seja suficiente. Se isso não funcionar, esvazie a lixeira.
Montar o Google Drive no Colab permite que o código do notebook tenha acesso a todos os arquivos no Google Drive. Geralmente exigimos que os usuários concedam o acesso manualmente sempre que se conectarem a um novo ambiente de execução adicionando uma célula de código ao notebook. Isso garante que o usuário tenha pleno conhecimento das permissões concedidas ao notebook.
Em alguns casos, solicitamos a autorização do Google Drive uma única vez, e ele é montado automaticamente nas próximas sessões. Para proteger os arquivos, isso só é permitido quando o notebook é aprovado em várias verificações. Por exemplo, nos notebooks editados por outro usuário, o Google Drive não é montado automaticamente.
O Google Drive define vários limites, incluindo o total de operações por usuário e por arquivo, além de cotas de largura de banda. Exceder esses limites aciona um Erro de entrada/saída
mencionado acima e exibe uma notificação na interface do Colab. Uma causa comum é abrir um arquivo que é compartilhado várias vezes ou acessar muitos arquivos diferentes em sequência. Veja algumas soluções:
- Copie o arquivo usando drive.google.com e não compartilhe o documento muitas vezes para que outros usuários não esgotem o limite.
- Evite fazer muitas leituras de E/S pequenas. Como alternativa, copie os dados do Drive para a VM do Colab em um formato de arquivo (por exemplo,
.zip
ou.tar.gz
) e desarquive os dados localmente na VM em vez de no diretório montado do Drive. - Espere um dia para que os limites de cota sejam redefinidos.
O Google Drive define um limite de quantidade de dados que podem ser armazenados por cada usuário. Se ocorrerem falhas de Erro de entrada/saída
nas operações do Drive, e uma notificação indicar que a cota de armazenamento foi excedida, exclua alguns arquivos usando drive.google.com e esvazie a lixeira para liberar espaço. Pode demorar um pouco até que o espaço recuperado esteja disponível no Colab.
Caso queira comprar mais armazenamento, acesse o Google Drive. A compra de espaço adicional no Google Drive não aumentará a capacidade de disco disponível nas VMs do Colab. Para fazer isso, assine o Colab Pro.
Limites de recurso
Para oferecer GPUs poderosas em grande escala por um valor baixo, o Colab precisa manter a flexibilidade para ajustar os limites de uso e a disponibilidade de hardware dinamicamente.
Na versão do Colab sem custo financeiro, o acesso a recursos caros como GPUs é muito restrito. Na versão paga do Colab, nosso objetivo é dar aos usuários um alto valor de acordo com os gastos.
É possível comprar recursos garantidos pelo GCP Marketplace para usar com o Colab.
O Colab é capaz de oferecer recursos sem custo financeiro por ter limites de uso dinâmicos que às vezes flutuam e por não oferecer recursos garantidos nem ilimitados. Isso significa que os limites de uso geral, assim como os tempos limite de inatividade, o ciclo de vida das VMs e os tipos de GPUs disponíveis podem variar. O Colab não publica esses limites, em parte porque eles podem variar rapidamente (e às vezes isso acontece).
Para relaxar os limites de uso do Colab, compre um dos nossos planos pagos. Esses planos têm uma dinâmica semelhante, porque a disponibilidade dos recursos talvez mude com o tempo.
É possível comprar recursos garantidos pelo GCP Marketplace para usar com o Colab.
Os tipos de GPUs disponíveis no Colab variam com o tempo. Isso é necessário para que o Colab possa oferecer acesso aos recursos sem custo financeiro.
Para acessar GPUs premium sujeitas à disponibilidade, compre um dos nossos planos pagos.
Para ter acesso a hardwares dedicados, use o GCP Marketplace do Colab.
O Colab prioriza a computação interativa. Os ambientes de execução vão expirar em caso de inatividade.
Na versão do Colab sem custo financeiro, os notebooks são executados por no máximo 12 horas, dependendo da disponibilidade e dos padrões de uso. O Colab Pro, Pro+ e o pagamento por utilização oferecem maior disponibilidade de computação com base no seu saldo de unidades.
Em geral, os notebooks são executados por no máximo 12 horas, dependendo da disponibilidade e dos padrões de uso. O encerramento do back-end poderá ocorrer se você esgotar suas unidades de computação disponíveis em um plano Pro, Pro+ ou de pagamento por utilização.
O Colab Pro+ é compatível com a execução contínua de código por até 24 horas quando há unidades de computação suficientes. Os tempos limite de inatividade só valerão se a execução do código for concluída.
É possível relaxar totalmente os limites do ambiente de execução e os tempos limite de inatividade ao comprar uma VM dedicada no GCP Marketplace.
Na versão do Colab sem custo financeiro, é possível acessar VMs com um perfil de memória padrão do sistema.
Nas versões pagas do Colab, é possível acessar máquinas com um perfil de alta memória do sistema, sujeitas à disponibilidade e ao saldo de unidades de computação.
"Memória" se refere à memória do sistema. Todos os chips de GPU têm o mesmo perfil de memória.
Considere fechar as guias do Colab ao terminar o trabalho e evite optar por GPUs ou memória extra quando isso não for necessário. Isso vai diminuir a probabilidade de você alcançar o limite de uso no Colab. Você pode comprar mais computação pelo pagamento por utilização se atingir os limites.
Para saber mais sobre como aproveitar todos os recursos da versão paga do Colab, consulte Como aproveitar ao máximo sua assinatura do Colab.
O Colab oferece opções de ambientes de computação acelerados que incluem GPU e TPU. Executar código em um ambiente de execução com GPU ou TPU não significa automaticamente que a GPU ou a TPU estão sendo usadas. Para evitar atingir os limites de uso da GPU, recomendamos mudar para um ambiente de execução padrão caso a GPU não esteja sendo utilizada. Selecione Ambiente de execução > Alterar o tipo de ambiente de execução e defina o Acelerador de hardware como Nenhum.
Para acessar exemplos de como usar os ambientes de execução com GPU e TPU no Colab, consulte os notebooks de exemplo TensorFlow com suporte a GPUs e TPUs no Colab.
Programação com IA
Estamos lançando gradualmente os recursos de programação com IA, como preenchimento automático por IA, programação por linguagem natural e um chatbot baseado no Codey, a família mais avançada de modelos ajustados por código do Google com base no PaLM 2.
Assinantes do Pro+ nos Estados Unidos agora têm acesso a esses recursos. Os assinantes Pro nos Estados Unidos vão ser os próximos a terem acesso a esses recursos. Vamos ampliar o acesso a novos países e ao nível sem custo financeiro assim que a capacidade e as aprovações permitirem.
No momento, as contas do Google Workspace não são compatíveis. Estamos trabalhando para ativar os recursos para esses tipos de conta em breve.
Somente assinantes pagos nos Estados Unidos (a partir do nível Pro+) têm acesso aos recursos de programação com IA. Para acessar os recursos de programação com IA:
- Você precisa estar nos Estados Unidos
- Não acesse o Colab com uma conta do Google Workspace (que não termina em "@gmail.com")
O preenchimento automático por IA vai aparecer conforme você digitar. A programação por linguagem natural e o chatbot têm botões visíveis ("gerar" e "Colab AI"). Se não forem exibidas essas opções e você deveria ter acesso, dê feedback no produto ("Ajuda" > "Enviar feedback"). Se quiser receber uma resposta por e-mail, marque a caixa "Podemos enviar e-mails a você pedindo mais informações ou atualizações".
O Colab pode ajudar com a programação e assuntos relacionados, mas a programação com IA no Colab ainda é experimental, e você é responsável por usar o código ou as explicações associadas. Tenha cautela e teste e revise todos os códigos em busca de erros, bugs e vulnerabilidades antes de confiar neles.
Se algum código gerado estiver sujeito a uma licença de código aberto, o Colab vai incluir uma citação.
Use esse recurso somente para fazer perguntas relacionadas ao Colab ou à programação no Colab. Se você quiser perguntar sobre outro assunto, recomendamos o Bard para consultas gerais e perguntas sobre outras linguagens, como Java.
A programação com IA no Colab funciona melhor e é otimizada para Python.
A programação com IA no Colab é experimental, e algumas respostas podem ser imprecisas. Por isso, revise todas as respostas. Com seu feedback, a programação com IA no Colab está melhorando a cada dia.
Acelerar as ideias das pessoas com IA generativa é muito empolgante, mas ainda estamos no começo, e a programação com IA é um experimento. Embora o Colab tenha controles de segurança integrados e mecanismos claros de feedback, de acordo com nossos princípios de IA, a ferramenta pode exibir declarações ofensivas ou informações e links imprecisos.
Se você receber uma resposta da IA que acredita ser insegura, inútil, imprecisa ou ruim por qualquer outro motivo, envie feedback.
No canto inferior direito da resposta, clique nos ícones de "Gostei" ou "Não gostei".
Se você quiser desativar a programação com IA no Colab, no menu "Ferramentas", selecione "Configurações" e "Colab AI".
Nessa opção, você pode revogar o consentimento e ocultar os recursos de programação com IA.
Como algumas outras experiências independentes do LLM, a programação com IA no Colab tem como objetivo gerar conteúdo original, e não replicar conteúdo que já existe. Projetamos nossos sistemas para limitar as chances desse problema ocorrer e vamos continuar a melhorar o funcionamento deles. Se o Colab fizer uma citação direta, ela vai indicar a fonte.
Quando você usa recursos de IA generativa no Colab, o Google coleta comandos, códigos relacionados, resultados gerados, informações de uso de recursos relacionados e seu feedback. O Google usa esses dados para oferecer, melhorar e desenvolver produtos, serviços e tecnologias de aprendizado de máquina, incluindo produtos empresariais do Google, como o Google Cloud.
Para melhorar nossos produtos, revisores humanos podem ler, fazer anotações e processar seus comandos, os resultados gerados, as informações de uso de recursos relacionados e seu feedback. Não inclua informações confidenciais ou pessoais que possam ser usadas para identificar você ou outras pessoas nos seus comandos ou feedback. Seus dados vão ser armazenados de modo que o Google não consiga identificar quem os enviou, e não vai ser mais possível atender a solicitações de exclusão. Eles vão ser retidos por até 18 meses.
A função "Gerar" na célula de código oferece ajuda contextual para gerar snippets de código para você. O código é gerado pelo comando e pelo conteúdo do notebook próximo, para oferecer contexto ao modelo. Dessa forma, você pode pedir que o modelo gere um código que seja mais relevante.
O chatbot do Colab AI não tem nenhuma informação contextual do notebook e apresenta uma explicação com os snippets de código.
Mais perguntas?
O Colab funciona com a maioria dos navegadores e foi testado exaustivamente com as últimas versões do Chrome, Firefox e Safari.
Em 2014, nós trabalhamos com a equipe de desenvolvimento do Jupyter para lançar uma versão inicial da ferramenta. Desde então, o Colab continuou evoluindo, de acordo com as necessidades internas de uso.
O foco do Colab é a compatibilidade com o Python e o ecossistema de ferramentas de terceiros. Sabemos que existem usuários interessados no suporte a outros kernels do Jupyter (por exemplo, R ou Scala). Gostaríamos de dar suporte a essas linguagens, mas ainda não temos um prazo estimado para isso.
Abra qualquer notebook do Colab. Depois, no menu Ajuda, selecione "Enviar feedback… ".
O Colab usa iframes HTML e service workers hospedados em origens separadas para exibir saídas avançadas. Os navegadores requerem ativar cookies de terceiros para usar os service workers nos iframes. Uma opção para não ativar cookies de terceiros é permitir o seguinte nome do host nas configurações no seu navegador: googleusercontent.com.
O Colab usa uma fonte genérica monoespaçada para o editor. É possível configurar a família de fontes monoespaçadas usadas na maioria dos navegadores. Estes são exemplos de algumas comuns:
- No Firefox, siga as etapas especificadas nos documentos de suporte do Firefox para configurar a fonte "Monoespaçada".
- No Chrome, navegue até "chrome://settings/fonts" e modifique a seção "Fonte de largura pré-determinada".
O suporte ao Python 2 foi suspenso no Colab. Para mais informações sobre como migrar o código, leia sobre a portabilidade de código do Python 2 para o Python 3.
Há uma seção de perguntas frequentes na página de inscrição.
Consulte a página de inscrição para saber mais sobre o Colab Pro, Pro+ e pagamento por utilização, incluindo preços e upgrades.
O gerenciamento do acesso de usuários do Workspace ao Colab é feito pelos controles de ativação/desativação do Workspace disponibilizados ao administrador da sua organização.
As organizações que participam do Workspace for Education precisam receber autorização dos responsáveis para que alunos (menores de 18 anos) possam usar serviços adicionais com a conta do Google Workspace for Education. Isso pode ser feito com este modelo de aviso. Inclua o Colab na lista de serviços adicionais.
Para saber mais, leia nosso artigo da Central de Ajuda Comunicação com os pais e responsáveis sobre o Google Workspace for Education.