Kling Digital
tr
İletişim
2026-11-19
8 dk okuma
Öne Çıkan Rehber

OpenHands Nedir? Sandbox Ortamında Otonom Yazılım Ajanı Rehberi

OpenHands, herhangi bir modele veya bulut sağlayıcısına bağımlı kalmadan çalışan MIT lisanslı açık kaynak otonom yazılım mühendisliği platformudur. Docker ve Kubernetes tabanlı izole sandbox ortamlarında birden fazla dosyayı düzenler, bağımlılık kurar, test paketlerini kendisi çalıştırıp hataları çözer. Bu teknik rehber V1 SDK, EventStream, güvenlik politikaları, Microagents ve MCP mimarisini detaylıca inceler.

OpenHands Nedir? Sandbox Ortamında Otonom Yazılım Ajanı Rehberi

Otonom bir kodlama ajanına doğrudan geliştirici bilgisayarında tam kabuk erişimi vermek, tek bir hatalı paket kurulumunda veya dikkatsiz bir dosya temizliğinde yerel çalışma ortamını bozabilir. Kasım 2026 açık kaynak yapay zeka ajan ekosistemi içinde uçtan uca hata çözümü hedefleyen ve kurumsal yapay zeka çözümleri geliştiren ekipler için OpenHands, konteyner tabanlı yürütme izolasyonunu mimarinin merkezine koyar.

OpenHands nedir? OpenHands (eski adıyla OpenDevin / All-Hands-AI), herhangi bir firmaya veya modele bağlı kalmadan çalışan MIT lisanslı açık kaynak otonom yazılım mühendisliği platformudur. Docker veya Kubernetes tabanlı izole sandbox ortamlarında birden fazla dosyayı düzenler, bağımlılık kurar, test paketlerini çalıştırır ve hataları okuyarak testler yeşil olana dek yinelemeli düzeltme yapar.

Önemli

Yönetici Özeti — OpenHands Neden Tercih Ediliyor?

  • Üretici Bağımsızlığı ve MIT Lisansı: Çekirdek platform, Software Agent SDK, CLI ve değerlendirme paketi MIT lisanslıdır; ticari API'ler veya kurum içi açık ağırlıklı modeller arasında kilitlenme olmadan geçiş yapılır.
  • İzole Çoklu Dosya ve Test Döngüsü: Varsayılan Docker Runtime ve Kubernetes Remote Runtime, ana işletim sistemini riske atmadan kod düzenleme, derleme ve test doğrulamasını geçici konteynerlerde yürütür.
  • Modüler V1 SDK ve Yönetişim: Deterministik EventStream, onay politikaları (AlwaysConfirm, ConfirmRisky, NeverConfirm), --llm-approve, Microagents ve OAuth destekli yerel MCP sunar.

OpenHands V1 Modüler Mimarisi ve EventStream

OpenHands, erken dönem prototip yapısından çıkarak resmi GitHub deposu ve Software Agent SDK etrafında ayrıştırılmış V1 mimarisine geçmiştir. Bu ayrışma sayesinde web çalışma alanı ile başsız CI otomasyonu aynı motoru paylaşır.

Ayrıştırılmış V1 Paket Katmanları

  • openhands.sdk: LLM, Agent, Conversation, Event ve güvenlik politikalarını barındırır. LiteLLM uyumlu arayüz sayesinde model sağlayıcısı yalnızca ortam değişkeniyle değiştirilir.
  • openhands.tools: TerminalTool (kabuk yürütme), FileEditorTool (çoklu dosya yamaları) ve TaskTrackerTool (yapılandırılmış görev planlama) araçlarını standart şemayla sunar.
  • openhands.workspace: Yerel dizin, geçici Docker konteyneri veya uzak konteyner sunucusu arasındaki yürütme sınırını soyutlar.
  • openhands.agent_server: Oturum durumunu REST ve WebSocket üzerinden dışa açar; tarayıcı tabanlı Agent Canvas ve OpenHands CLI bu katmana istemci olarak bağlanır.

Deterministik EventStream Günlüğü

OpenHands yalnızca metin sohbet geçmişi tutmak yerine her planlama adımını, kabuk komutunu, dosya yamasını ve test hata çıktısını sıralı bir EventStream akışına kaydeder. openhands.agent_server, bu olay akışını WebSocket üzerinden anlık olarak Agent Canvas arayüzüne ve CLI istemcisine aktarır; mühendisler konteyner kabuğuna doğrudan bağlanmadan canlı dosya farklarını ve standart hata çıktılarını izleyebilir. LOG_ALL_EVENTS=true ile kaydedilen bu deterministik yapı; başarısız oturumların adım adım analiz edilmesini, uyumluluk ekipleri için doğrulanabilir denetim izi oluşturulmasını ve kesintiye uğrayan uzun görevlerin güvenle devam ettirilmesini sağlar.

İzole Sandbox Ortamında Çoklu Dosya Değişikliği ve Test Döngüsü

Üretim depolarında bir hatayı kapatmak veya yeni özellik eklemek çoğu zaman veri şeması, iş mantığı, API uç noktası ve test dosyalarında eşzamanlı değişiklik gerektirir. OpenHands bunu iki katmanlı yürütme izolasyonuyla yönetir.

Docker Runtime, Kubernetes Remote Runtime ve Local Runtime

Varsayılan Docker Runtime, her oturum için geçici ve izole bir konteyner başlatır. Paket kurulumları ve derleme adımları konteyner içinde kaldığı için bağımlılık çakışmaları ana bilgisayarı etkilemez ve oturum bitiminde konteyner temizlenir. Paralel CI görevleri ve toplu depo değerlendirmeleri için Remote Runtime oturumları Kubernetes podlarına dağıtır. Konteyner gerektirmeyen hafif klasör işleri içinse Local Runtime seçeneği mevcuttur.

Kendi Kendini Doğrulayan Kodlama Akışı

Sandbox hazırlandığında ajan TaskTrackerTool ile plan oluşturur, FileEditorTool ile ilgili tüm dosyalarda değişiklik yapar ve TerminalTool üzerinden bağımlılıkları kurup birim ve entegrasyon testlerini çalıştırır. Test başarısız olursa hata yığınını (stack trace) okur, kök nedeni belirleyip yeni yama uygular ve çıktı tamamen yeşil dönene kadar döngüyü sürdürür. Özel yazılım geliştirme projelerinde bu kapalı devre doğrulama, eski kod tabanlarını güvenle modernize etmeyi hızlandırır.

Kurulum, CLI, Docker Sandbox ve Python SDK

Resmi dokümantasyon docs.openhands.dev ve openhands.dev üzerinde yer alır. Kurulum CLI, tam Docker konteyneri veya Python V1 SDK üzerinden yapılabilir.

CLI Kurulumu, Headless Görevler ve MCP Komutları

Python 3.12 ile uv (veya alternatif olarak pip install openhands-ai) kurulumunun ardından Agent Canvas (--mount-cwd, isteğe bağlı --gpu), --llm-approve destekli başsız görevler ve MCP sunucu yönetimi tek arayüzden yürütülür:

uv tool install openhands --python 3.12
openhands serve --mount-cwd
openhands --headless --llm-approve \
  --task "Auth modülündeki token yenileme hatasını düzelt ve pytest testlerini geçir"
openhands mcp add docs-mcp --url https://mcp.example.internal/sse
openhands mcp list

Docker Sandbox ile Yalıtımlı Başlatma

İzole agent-server imajı ve tam EventStream kaydıyla OpenHands uygulamasını konteynerde başlatmak için resmi Docker komutu kullanılır:

docker run -it --rm --pull=always \
  -e AGENT_SERVER_IMAGE_REPOSITORY=ghcr.io/openhands/agent-server \
  -e AGENT_SERVER_IMAGE_TAG=1.26.0-python \
  -e LOG_ALL_EVENTS=true \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v ~/.openhands:/.openhands \
  -v $(pwd):/workspace:rw \
  -p 3000:3000 \
  --add-host host.docker.internal:host-gateway \
  --name openhands-app \
  docker.openhands.dev/openhands/openhands:1.8
Uyarı

Docker Soketi Sınırı: /var/run/docker.sock bağlaması, OpenHands'in görev başına kardeş sandbox konteynerleri açmasını sağlar. Üretim sırları veya kişisel SSH anahtarları taşıyan bilgisayarlarda NeverConfirm modunu açmayın; tam otonom başsız akışları yalnızca yalıtılmış CI koşucularında veya Kubernetes Remote Runtime üzerinde çalıştırın.

Python Software Agent SDK ile Orkestrasyon

Platform ekipleri kendi otomasyon servislerine V1 SDK üzerinden ajan gömebilir:

import os
from openhands.sdk import LLM, Agent, Conversation, Tool
from openhands.sdk.security.confirmation_policy import ConfirmRisky
from openhands.tools.file_editor import FileEditorTool
from openhands.tools.task_tracker import TaskTrackerTool
from openhands.tools.terminal import TerminalTool
llm = LLM(
    model=os.getenv("LLM_MODEL", "anthropic/claude-sonnet-4-5-20250929"),
    api_key=os.getenv("LLM_API_KEY"),
    base_url=os.getenv("LLM_BASE_URL"),
)
agent = Agent(
    llm=llm,
    tools=[
        Tool(name=TerminalTool.name),
        Tool(name=FileEditorTool.name),
        Tool(name=TaskTrackerTool.name),
    ],
)
conversation = Conversation(agent=agent, workspace=os.getcwd())
conversation.set_confirmation_policy(ConfirmRisky())
conversation.send_message(
    "Ödeme servisindeki kuruş yuvarlama hatasını düzelt ve pytest çıktısını doğrula."
)
conversation.run()

Güvenlik Politikaları, Microagents ve MCP Entegrasyonu

Konteyner izolasyonu ana bilgisayarı korur; politika katmanı ise ajanın hangi komutları çalıştırabileceğini ve depo kurallarına nasıl uyacağını denetler.

Onay Politikaları ve LLM Güvenlik Analizörü

  • AlwaysConfirm: Her kabuk komutu ve dosya değişikliği öncesinde açık onay ister.
  • ConfirmRisky: Varsayılan dengeli politikadır; zararsız okuma ve test adımlarını otomatik çalıştırır, yüksek riskli eylemlerde duraklayıp onay bekler.
  • NeverConfirm: Duraklamadan tam otonom çalışır; yalnızca yalıtılmış geçici CI ortamları için uygundur.

--llm-approve etkinleştirildiğinde LLM tabanlı güvenlik analizörü her komutu yürütme öncesinde değerlendirir; yıkıcı silme işlemleri, gizli anahtar sızdırma riskleri veya yetkisiz dış ağ çağrıları başlamadan engellenir.

Microagents ve Yerel OAuth MCP Desteği

Ekipler ~/.openhands/microagents/ altında (ve taşınabilir .agents/skills/ yapısıyla uyumlu biçimde) Microagents tanımlayarak proje kurallarını dosya yolu veya anahtar kelime bazında otomatik olarak bağlama yükler. Yerel MCP desteği (openhands mcp add, openhands mcp list) OAuth doğrulamalı kurumsal sunucuları destekler. Kapalı protokol veya ikili dosya analizlerinde REA (Reverse Engineer Anything) MCP mimari rehberi araçları doğrudan OpenHands oturumuna bağlanarak tersine mühendislik bulguları aynı sandbox içinde test edilmiş koda dönüştürülebilir.

İpucu

Kurumsal Yönetişim İpucu: Yeni depolarda ilk haftalarda ConfirmRisky politikasını --llm-approve ve versiyonlanmış Microagents kurallarıyla eşleştirin. EventStream kayıtlarını inceleyip gerçek verilere göre onay eşiğinizi ayarladıktan sonra tekrarlayan işleri başsız CI akışına alın.

Mimari Karşılaştırma: OpenHands, OpenCode, Goose ve Kapalı Ajanlar

KriterOpenHandsOpenCodeGooseKapalı Bulut / IDE Ajanları
Yürütme ModeliOtonom döngü (Agent Canvas, CLI, Headless, Python V1 SDK)Etkileşimli terminal (TUI) kodlama oturumuMasaüstü uygulaması, CLI ve API tarifleriIDE eklentisi veya kapalı bulut sohbeti
Sandbox İzolasyonuVarsayılan geçici Docker Runtime & Kubernetes Remote (+ Local)Doğrudan yerel çalışma dizini ve kabukYerel ortam; konteyner dış yapılandırmaya bağlıSağlayıcıya bağlı; bulut veya yerel IDE
Çoklu Dosya TestleriKonteynerde bağımlılık kurulumu, test koşumu ve otomatik düzeltmeGeliştirici eşliğinde dosya düzenleme ve terminal testiEklenti ve tarif tabanlı çoklu adım zinciriSıkça kısıtlı derleme ve test erişimi
Model BağımlılığıYok — MIT lisanslı, LiteLLM ile tüm ticari/yerel modellerYok — Çoklu model ve yerel uç nokta desteğiYok — Açık kaynak çoklu model yapılandırmasıYüksek — Tek üretici veya zorunlu abonelik
MCP ve GenişletmeYerel MCP (openhands mcp add, OAuth), Microagents, V1 SDKGeniş MCP sunucusu ve araç yapılandırmasıZengin MCP eklentileri ve YAML tarifleriOnaylı mağaza veya kısıtlı bağlayıcılar

Hızlı etkileşimli terminal akışları için OpenCode terminal kodlama ajanı rehberi, masaüstü ve CLI tariflerini birleştiren iş akışları için Goose açık kaynak kodlama ajanı rehberi incelenebilir. Tam yalıtımlı konteyner içinde bağımlılık kurup tüm test paketini yeşile döndüren ve EventStream denetimi sunan boru hatlarında ise OpenHands net biçimde ayrışır.

Kurumsal Dağıtım ve Kling Digital Mühendislik Yaklaşımı

OpenHands'i bireysel deneme aşamasından kurumsal mühendislik standardına taşımak için dört temel kontrol noktası uygulanmalıdır:

  1. Ağ Çıkış (Egress) Kısıtlamaları: Sandbox konteynerlerinin yalnızca kurum içi paket aynalarına ve onaylı LLM ağ geçidine erişmesine izin verilmelidir.
  2. Kısa Ömürlü Gizli Anahtar Yönetimi: API anahtarları ve depo belirteçleri bağlı çalışma dizini dışında tutulmalı, yalnızca aktif dal için geçerli en düşük yetkili belirteçler üretilmelidir.
  3. Merkezi EventStream Arşivi: LOG_ALL_EVENTS=true ile kaydedilen olay akışları değiştirilemez gözlemlenebilirlik deposuna aktarılarak her pull request için tam kanıt zinciri korunmalıdır.
  4. Zorunlu İnsan Onayı ve SAST Kapısı: Sandbox içinde geçen testler doğrulama kanıtı sayılmalı; her değişiklik standart insan kod incelemesi ve statik güvenlik taramasından geçirilmelidir.

Kling Digital, üretici bağımlılığı olmayan otonom yazılım geliştirme sandbox'ları, Kubernetes Remote Runtime kümeleri ve OAuth korumalı iç MCP entegrasyonları tasarlar. Kurumunuza özel güvenli OpenHands V1 mimarisi için Kling Digital iletişim sayfasından teknik ekibimizle görüşebilirsiniz.

Sıkça Sorulan Sorular

Rehber ve entegrasyonla ilgili en sık sorulan sorular.

Tüm Yazılara Dön
Paylaş

Yorumlar (0)

Görüş ve deneyimlerinizi toplulukla paylaşın.

Henüz yorum yapılmamış. İlk yorumu siz yapın!

Yorum Bırak

Yorumunuz yönetici onayından sonra yayına alınacaktır.

Topical Authority & İç Bağlantı Ekosistemi

İlgili Mimari Kıyaslamalar, Rehberler & Dijital Araçlar

Projeniz için en doğru teknoloji kararını vermeniz adına hazırladığımız kıyaslama matrisleri, derinlemesine B2B rehberler ve canlı hesaplama araçları.

Teknik Kıyaslama

Next.js vs WordPress Kıyaslaması

1 saniyenin altında açılış hızı, eklenti risklerinden arındırılmış güvenlik ve 3 yıllık toplam maliyet karşılaştırması.

Kapsamlı Kıyaslamayı İnceleyin
E-Ticaret ROI

Shopify vs Özel Headless E-Ticaret

Esnek ödeme ağları, ERP/stok entegrasyonu ve çoklu para birimli e-ihracat analizi.

Kapsamlı Kıyaslamayı İnceleyin

Son Yazılar

En güncel teknoloji, tasarım ve yazılım rehberlerimiz.

Tümünü Gör