Agentes· atualizado em · 4 min de leitura· Redação Invision

Ollama e Fly.io: agentes de IA rodando em sandbox Linux seguro

Ollama Cloud agora funciona dentro dos Sprites da Fly.io, VMs Linux isoladas para agentes. Veja como usar modelos remotos com segurança e OpenAI SDK.

Resumo: A Ollama Cloud agora pode ser usada dentro dos Sprites da Fly.io, máquinas virtuais Linux isoladas projetadas para executar agentes com segurança. A integração permite que agentes como Claude Code, Codex e Gemini CLI rodem comandos em um sandbox e acessem modelos em nuvem da Ollama sem expor a chave de API, o que importa para quem desenvolve agentes que precisam executar código de forma controlada.

Pontos-chave

  • Ollama Cloud agora funciona dentro dos Sprites da Fly.io, VMs Linux isoladas para agentes.
  • A chave de API da Ollama é criptografada na Fly.io e injetada por um gateway, sem exposição ao código do Sprite.
  • Modelos citados incluem kimi-k3, glm-5.3 e deepseek-v4.1-flash.
  • Qualquer OpenAI SDK pode ser usado apontando base_url para o gateway da Fly.io.
  • Fly.io oferece skill para Claude Code, Cursor, Codex e Gemini CLI usarem Ollama sem configuração extra.
Nesta matéria

O que é um Sprite da Fly.io e por que ele importa para agentes?#

Um Sprite é um sandbox da Fly.io que consiste em uma máquina virtual Linux completa, com disco próprio que persiste entre sessões. Essa característica é relevante para agentes de IA que precisam executar comandos e manter estado ao longo do tempo.

A Fly.io já suporta ferramentas como Claude Code, Codex e Gemini CLI de fábrica, permitindo que agentes rodem comandos dentro do ambiente isolado. Isso reduz o risco de um agente executar ações destrutivas fora de controle.

  • Cada Sprite é uma VM Linux isolada com disco persistente.
  • Claude Code, Codex e Gemini CLI são suportados nativamente.
  • Agentes podem executar comandos dentro do sandbox com segurança.

Como funciona o Ollama Connector com a Fly.io?#

O novo Ollama Connector permite que os Sprites usem modelos em nuvem da Ollama, como kimi-k3, glm-5.3 e deepseek-v4.1-flash. A configuração é feita adicionando a chave de API da Ollama à organização na Fly.io.

A Fly.io criptografa a chave e não a retorna pela API. Quando o código dentro do Sprite chama a Ollama, a requisição passa por um gateway da Fly.io que identifica qual Sprite está chamando e insere a chave automaticamente. O Sprite conhece apenas a URL do gateway e um ID de conexão.

  • Chave da Ollama é armazenada criptografada na organização Fly.io.
  • O gateway adiciona a chave à requisição, sem expô-la ao código do Sprite.
  • O Sprite só vê a URL do gateway e um connection ID.

Quais modelos da Ollama podem ser usados nos Sprites?#

A integração cita explicitamente os modelos kimi-k3, glm-5.3 e deepseek-v4.1-flash como disponíveis por meio do conector. A notícia não detalha outros modelos ou limites de uso.

Além disso, a Fly.io oferece uma skill que informa ao Claude Code, Cursor, Codex e Gemini CLI sobre a Ollama. Se o Sprite tiver acesso, o agente pode usar modelos Ollama sem configuração adicional.

  • Modelos citados: kimi-k3, glm-5.3 e deepseek-v4.1-flash.
  • Skill da Fly.io ensina ferramentas como Cursor e Codex a usar Ollama.
  • Configuração pode ser automática quando o Sprite tem permissão.

Como usar o OpenAI SDK com o gateway da Fly.io?#

Qualquer SDK compatível com OpenAI pode ser usado apontando base_url para o gateway e definindo qualquer valor para api_key, já que a chave real é injetada pelo gateway. As rotas nativas /api/* da Ollama também funcionam através do gateway.

A página do conector mostra o comando com o connection ID preenchido e sem cabeçalho Authorization, pois o gateway cuida da autenticação. Isso simplifica a integração para quem já usa bibliotecas baseadas no padrão OpenAI.

  • Use base_url do gateway e qualquer api_key no SDK.
  • Rotas nativas da Ollama (/api/*) são suportadas.
  • Não é necessário enviar Authorization header no código do Sprite.

Como combinar modelos pequenos e grandes em um fluxo de testes?#

A Fly.io publicou um guia que usa vários modelos em conjunto. Um modelo pequeno como nemotron-3-nano:30b gera entradas malformadas, um Sprite executa essas entradas contra o programa do usuário, e um modelo maior como kimi-k3 analisa os crashes resultantes.

Para trocar de modelo, basta alterar o campo model na chamada. O guia completo está disponível no quickstart do Ollama Connector.

  • Modelo pequeno gera casos de teste; modelo grande analisa falhas.
  • Troca de modelo é feita alterando o campo model.
  • Fluxo é útil para testes de robustez e fuzzing.

O que isso muda para quem usa IA?#

Para desenvolvedores de agentes, a combinação de sandbox Linux persistente com acesso seguro a modelos em nuvem reduz a fricção de configurar credenciais e isolar execuções. A integração evita expor chaves de API no código do agente, um risco comum em implantações.

A Invision oferece acesso a vários modelos de IA por uma única chave, o que pode simplificar a experimentação com diferentes modelos em projetos de agentes. A notícia não menciona preços ou condições comerciais da Invision.

  • Sandbox persistente e gateway de chave simplificam a arquitetura de agentes.
  • Invision permite testar vários modelos com uma chave só, sem promessa de preço.
  • Integração com OpenAI SDK facilita a adoção por times já familiarizados.

Perguntas frequentes

O que é um Sprite da Fly.io?

É um sandbox que consiste em uma máquina virtual Linux completa com disco persistente, projetada para executar agentes de IA com isolamento e segurança.

Como a chave da Ollama é protegida nos Sprites?

A chave é armazenada criptografada na organização Fly.io e nunca retornada pela API. Um gateway adiciona a chave às requisições feitas de dentro do Sprite, que conhece apenas a URL do gateway e um connection ID.

Quais modelos da Ollama posso usar com o conector?

A notícia cita kimi-k3, glm-5.3 e deepseek-v4.1-flash. Outros modelos podem estar disponíveis, mas não foram detalhados.

Preciso configurar algo para usar o OpenAI SDK?

Basta apontar base_url para o gateway da Fly.io e definir qualquer valor para api_key. O gateway injeta a chave real automaticamente, sem necessidade de cabeçalho Authorization.

O que é a skill da Fly.io para agentes?

É um recurso que informa ferramentas como Claude Code, Cursor, Codex e Gemini CLI sobre a Ollama, permitindo que usem modelos Ollama sem configuração adicional quando o Sprite tem acesso.

ollamafly.ioagentessandboxsegurançaopenai sdk

Fonte original: Run AI agents safely with Ollama and Fly.io (Ollama). Matéria escrita pela redação da Invision a partir dessa notícia. Versão em texto.