Çeşitli güvenlik modları, sandbox izolasyonu, git worktree'leri ve komut takma adları kullanarak Docker Agent'larını çalıştırın ve yönetin.
- GitHub yıldızları
- 626
- Dosyalar
- 6
- Son commit
- 10 Kas 2026
- Lisans
- Apache-2.0
- İzin verilen araçlar
- —
docker-agent-run skill ne işe yarar?
Çeşitli güvenlik modları, sandbox izolasyonu, git worktree'leri ve komut takma adları kullanarak Docker Agent'larını çalıştırın ve yönetin.
Özet, skill'in SKILL.md dosyasından oluşturuldu.
docker-agent-run skilli hakkında
Bu SKILL, geliştiricilerin Docker Agent'larının yürütülmesini ve operasyonel yaşam döngüsünü yönetmesini sağlar. Yerel yapılandırmalar, registry referansları veya önceden tanımlanmış takma adlar kullanarak docker agent run komutu aracılığıyla agent'ları çağırmak için gerekli araçları sunar. Kullanıcılar, katı onay gereksinimlerinden tam otonom yürütmeye kadar çeşitli güvenlik modlarından seçim yaparak, bir agent'ın araç çağrıları sırasında ne kadar özerkliğe sahip olacağını kontrol edebilir.
Güvenliğin öncelikli olduğu durumlarda bu SKILL, sandbox bayrağını kullanarak agent'ları izole edilmiş bir microVM içinde çalıştırmayı kolaylaştırır. Bu izolasyon sbx CLI gerektirir ve bir izin listesi aracılığıyla ayrıntılı ağ kontrolüne olanak tanır. Geliştiriciler ayrıca, bir agent'ın dosya değişikliklerini ana çalışma alanlarından ayırmak için git worktree'lerini kullanabilir veya model kullanılabilirliği ile kimlik bilgileriyle ilgili sorunları teşhis etmek için doctor komutunu kullanabilir. Bu SKILL, agent yapılandırmaları yazmaktan ziyade, mevcut agent'ları çalıştırmak ve sorunlarını gidermek için özel olarak tasarlanmıştır.
Bir agent bununla neler yapabilir
- 1Agent özerklik seviyelerini yapılandırınGözetimsiz görevler için açıkça güvenli olarak işaretlenmemiş tüm araç çağrılarını otomatik olarak reddedecek şekilde bir agent kurun.
- 2Agent faaliyetlerini bir sandbox içinde izole edinDosya sistemi ve süreç faaliyetlerinin sınırlandırıldığından emin olmak için bir agent'ı microVM içinde çalıştırın.
- 3Agent yürütme hatalarını teşhis edinModel kimlik bilgilerinin veya sağlayıcı kullanılabilirliğinin başarısız bir agent çalıştırmasının nedeni olup olmadığını kontrol edin.
Skill'in SKILL.md dosyasından yazılmıştır. Her kullanım durumu oradaki bir alıntı ile kontrol edilir.
docker-agent-run skill nasıl kurulur
Her komut, skill klasörünü istemcinin skills dizinine kopyalar. Yüklemek için istemciyi yeniden başlatın veya yeni bir oturum başlatın.docker-agent-run skill'ini Eklenti uygulamasına kur
/plugin marketplace add docker/skills /plugin install docker-skills@docker
docker-agent-run skill'ini Claude Code uygulamasına kur
~/.claude/skills/docker-agent-run/SKILL.md
$ npx degit docker/skills/skills/docker-agent-run ~/.claude/skills/docker-agent-rundocker-agent-run skill'ini Claude Code (project) uygulamasına kur
.claude/skills/docker-agent-run/SKILL.md
$ npx degit docker/skills/skills/docker-agent-run .claude/skills/docker-agent-rundocker-agent-run skill'ini Codex uygulamasına kur
~/.agents/skills/docker-agent-run/SKILL.md
$ npx degit docker/skills/skills/docker-agent-run ~/.agents/skills/docker-agent-rundocker-agent-run skill'ini Gemini CLI uygulamasına kur
~/.gemini/skills/docker-agent-run/SKILL.md
$ npx degit docker/skills/skills/docker-agent-run ~/.gemini/skills/docker-agent-rundocker-agent-run skill'ini Claude.ai uygulamasına kur
npx degit docker/skills/skills/docker-agent-run docker-agent-run && zip -r docker-agent-run.zip docker-agent-run # claude.ai → Customize → Skills → + → Create skill → Upload a skill → docker-agent-run.zip
Otomatik kontroller
Çalıştırıldı 15 Kas 2026Tam rapor →Otomatik kontrollerimizi geçti. Bu bir güvenlik denetimi değil: bir ajanın çalıştırmasına izin vermeden önce betikleri okuyun. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirdocker/skills/skills/docker-agent-run is public and reachablegithub.com/docker/skills/tree/HEAD/skills/docker-agent-run ↗Geçti
- Açık kaynak lisansı (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit 2026-11-10github.com/docker/skills/commits ↗Geçti
- Betiklerde indir-çalıştır veya kimlik bilgisi hırsızlığı yokNo scripts in the skill folderGeçti
- SKILL.md içinde gizli talimat yokNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/docker/skills/blob/HEAD/skills/docker-agent-run/S ↗Geçti
- Önceden izin verilen araçlar sınırlıNo pre-approved tools; the agent asks before using onegithub.com/docker/skills/blob/HEAD/skills/docker-agent-run/S ↗Geçti
- SKILL.md, Agent Skills biçimine uyuyorValid name and description; says when to use it; 155 linesgithub.com/docker/skills/blob/HEAD/skills/docker-agent-run/S ↗Geçti
SKILL.md
GitHub'da görüntüleDocker Agent: Running and Operating Agents
Overview
This skill owns the operational side of Docker Agent: invoking docker agent run against a local config, an alias, or a registry reference; choosing how
much autonomy the agent gets over tool calls; isolating it in a sandbox VM;
and diagnosing why a run fails. It assumes the agent.yaml already exists —
see Related skills for authoring it.
When to use this skill
Activate this skill when:
- The user wants to run an agent interactively or headlessly (
--exec). - The user is choosing or debugging
--safety,--yolo, or approval behavior for tool calls. - The user wants to isolate an agent's shell/filesystem access with
--sandbox, or hit a sandbox network-policy error. - The user wants a reusable shortcut (
docker agent alias), a scoped git worktree (--worktree), or is debugging credentials/model availability (docker agent doctor).
Do not use this skill when
Do not use this skill when:
- The task uses standalone
sbx run/create/stop/rmrather thandocker agent run --sandbox— usedocker-sandboxes-lifecycle. - The task is standalone
sbx policyorsbx secretconfiguration — usedocker-sandboxes-network-credentials. Establish which CLI is in use before recommending commands when the request only says "my sandbox". - The task is writing or editing the
agent.yamlitself (models, toolsets, sub_agents) — usedocker-agent-config. - The task is exposing an agent as a server (
serve), sharing it via a registry (share), or evaluating it (evaluation sessions,--baselineregression gates) — usedocker-agent-deploy.
Core guidance
Safety modes
docker agent runsupports four--safetymodes; choose the least permissive one that still lets the task finish:strict— ask for approval before every tool call.balanced— auto-approve calls classified as safe, ask for the rest.restricted— auto-approve safe calls, deny the rest outright. Use for unattended/CI runs where no human can answer a prompt.autonomous— approve everything automatically. Equivalent to--yolo.
- Never default an unattended run (cron, CI, a server endpoint) to
autonomous/--yolo. Userestrictedfor unattended runs so an unexpected tool call fails closed instead of running unreviewed; reserveautonomous/--yolofor a sandboxed or fully trusted interactive session.# CI-safe: unreviewed tool calls are denied, not silently approved. docker agent run --exec --safety restricted ./agent.yaml "Triage the failing test" - Bake a safety default into an alias so callers don't have to remember it,
and note that an explicit CLI
--safety/--yoloondocker agent runstill overrides the alias:docker agent alias add safe-coder myorg/coder --safety balanced
Sandbox isolation
--sandboxruns the agent inside an isolated microVM managed by thesbxCLI (a separate prerequisite — install and configure it first). All shell, filesystem, and process activity started by built-in toolsets happens inside the VM; only the working directory (and, unless--no-kit, a staged "kit" of skills/prompt files) is mounted in. Exception: a local stdio MCP server declared on the agent runs as a host process outside the sandbox VM — treat any such MCP server as a trusted host integration, not a sandboxed one.docker agent run --sandbox ./agent.yaml- The sandbox network proxy is default-deny: only the model provider,
models.dev, and hosts the toolset resolver can infer are open. A custom MCP server or third-party API often needs an explicit allowlist entry — add it permanently rather than re-discovering it every run:docker agent sandbox allow api.example.com docker agent sandbox list docker agent sandbox deny api.example.com - Prefer baking
runtime: {sandbox: true}into the agent's ownagent.yamlover remembering--sandboxon every invocation of that agent; an explicit--sandbox=falseon the CLI still overrides the config default for a single debug run. - Sandboxes persist and are reused across runs from the same workspace — they are not torn down when the session ends. Don't expect a clean VM on every run; if you need one, change the mount set (e.g. a new kit) to force recreation.
Aliases and default agent
- Register a shortcut once, then run it by name instead of a path:
docker agent alias add code myorg/notion-expert docker agent run code - For a local run with no agent argument,
docker agent rundiscoversdocker-agent.yaml, thendocker-agent.yml, thendocker-agent.hclin the current directory (first match wins). Only if none exists does it resolve thedefaultalias, falling back to the built-in default agent. Theagent.yamlexamples in these skills pass a filename explicitly;agent.yamlis not an auto-discovery name. - Set the fallback for directories without a project config with a
defaultalias. To select it even when a project config exists, passdefaultexplicitly:docker agent alias add default ./my-agent.yaml docker agent run default - CLI flags on
docker agent run <alias>always override the alias's own stored options (e.g.docker agent run yolo-coder --yolo=false).
Worktrees
- Use
--worktree(-w) to isolate an agent's file edits from your current checkout — it runs the agent inside a fresh git worktree. For an interactive session, a clean worktree (no uncommitted changes, untracked files, or new commits) is removed automatically when the session ends; one with work prompts you to keep or remove. A headless run (--exec) never auto-cleans its worktree, regardless of state — it is left in place for inspection:docker agent run ./agent.yaml --worktree=auth-refactor --worktree-base origin/main --worktreecannot be combined with--remoteor--sandbox. To resume a worktree run, pass--session -1(or the session id) — do not re-pass--worktree, which fails because the worktree already exists.
Troubleshooting
- "No model is currently available" or "model ... is not pulled" means the
agent's provider has no usable credential, or (for
dmr/) the model hasn't been pulled. Rundocker agent doctor ./agent.yamlfirst — it reports the resolved model/provider and whether credentials were found — before touching the YAML. If credentials are missing, export the provider's API key; if a DMR model is missing, rundocker model pull <model>. Rerundoctorbefore retrying the task. - An agent that only describes a plan instead of executing it is usually
missing the tool it needs (add
type: shellortype: todoinagent.yaml), not a model failure — hand this back todocker-agent-config. - A
403 Blocked by network policyerror inside a sandbox run means the destination isn't allowlisted; usedocker agent sandbox allow <host>.
Related skills
- For standalone
sbxlifecycle commands, usedocker-sandboxes-lifecycle. - For standalone
sbx policyandsbx secret, usedocker-sandboxes-network-credentials. - For writing or changing the underlying
agent.yaml(models, toolsets, sub_agents), usedocker-agent-config. - For serving, sharing, or evaluating the agent, use
docker-agent-deploy.
References
references/safety-and-sandbox.md— full safety-mode/flag interaction table and sandbox trust-boundary details.references/sources.md— provenance of every rule in this skill.
Assets
- None.
Checks
checks/verification.md— Verification runbook for adocker agent runinvocation.
Bu becerideki dosyalar
6docker-agent-run skill soruları
docker-agent-run skill'ini Claude Code uygulamasına nasıl kurarım?
npx degit docker/skills/skills/docker-agent-run ~/.claude/skills/docker-agent-run komutunu çalıştırın. Claude Code, skill'leri ~/.claude/skills (tüm projeler) veya .claude/skills (tek proje) konumundan yükler ve açıklaması görevle eşleştiğinde skill'i kullanır.
docker-agent-run skill'ini hangi istemciler kullanabilir?
Agent Skills biçimini okuyan her istemci: Claude Code, Codex, Gemini CLI ve claude.ai (ZIP olarak yükleyin). Skill içindeki betikler yalnızca istemcinin kod çalıştırmaya izin verdiği yerlerde çalışır.
Docker Agent çalıştırmak için hangi güvenlik modları mevcuttur?
Dört mod bulunmaktadır: strict (her araç çağrısını onaylar), balanced (güvenli çağrıları onaylar), restricted (sınıflandırılmamış çağrıları reddeder) ve autonomous (her şeyi onaylar).
'No model is currently available' hatası alırsam ne yapmalıyım?
Sağlayıcının kullanılabilir kimlik bilgilerine sahip olup olmadığını veya modelin çekilmesi gerekip gerekmediğini teşhis etmek için 'docker agent doctor' komutunu çalıştırın.
Sandbox modundaki bir agent'ın belirli bir API'ye erişmesine nasıl izin veririm?
Host'u ağ izin listesine eklemek için 'docker agent sandbox allow' komutunu kullanın.