
âdocker-agentâ ã詊ããããè¯ãããªæããããŠããããllama-server ã§ãšã©ãŒ
docker-agent ãšããã®ãèŠãããã®ã§è©Šããã
ããã¥ã¡ã³ã
docker-agent ãšã¯ïŒ
Gemini ã«èããã
docker/docker-agent ã®ååšäŸ¡å€ïŒè§£æ±ºããããšããŠãã課é¡ïŒã¯ããAIãšãŒãžã§ã³ãéçºã«ããããç§ã®PCã§ã¯åããã®ã«ãåé¡ïŒç°å¢äŸåã»é åžã®é£ããïŒã解決ããDockerã³ã³ããã®ããã«èª°ã§ãç°¡åã«å ±æã»å®å šã«å®è¡ã§ããããã«ããããšãã«ãããŸãã
å ·äœçã«ã以äžã®2ã€ã®å€§ããªèª²é¡ã解決ããããã«äœãããŠããŸãã
1. ãšãŒãžã§ã³ãã®ãé åžã»å ±æãã®åçãªç°¡ç¥åïŒæå€§ã®äŸ¡å€ïŒ
åŸæ¥ãèªäœã®åªç§ãªAIãšãŒãžã§ã³ãç°å¢ãããŒã ã¡ã³ããŒã«å ±æããã«ã¯ãPythonã®ç°å¢æ§ç¯æé æžãæž¡ããäŸåã©ã€ãã©ãªãããŒã«ãã€ã³ã¹ããŒã«ããŠãããå¿ èŠããããŸããã docker-agentã§ã¯ãäœæãããšãŒãžã§ã³ãïŒYAMLïŒãDockerã€ã¡ãŒãžã®ããã«ã¬ãžã¹ããªã«ããã·ã¥ïŒdocker agent share push ...ïŒã§ããŸããä»ã®äººã¯ docker agent run <ã€ã¡ãŒãžå> ãå®è¡ããã ãã§ãäŸåé¢ä¿ãäžåæ°ã«ããããšãªããå šãåãAIãšãŒãžã§ã³ãç°å¢ãå³åº§ã«æå ã§åçŸã§ããŸãããDockerã®ããŒã¿ããªãã£ïŒå¯æ¬æ§ïŒãAIãšãŒãžã§ã³ãã«æã¡èŸŒãã ãã®ããã®ããŒã«ã®æå€§ã®ãã€ã³ãã§ãã
2. ããã°ã©ãã³ã°äžèŠã®ããã«ããšãŒãžã§ã³ããæ§ç¯
éåžžãè€æ°ã®å°éç¹ååAIïŒäŸïŒããšã©ãŒã調æ»ãããšãŒãžã§ã³ãããšãä¿®æ£ã³ãŒããæžããšãŒãžã§ã³ããïŒã飿ºãããã·ã¹ãã ïŒLangChain, CrewAI, AutoGenãªã©ïŒãäœãã«ã¯ãè€éãªPythonçã®ã³ãŒããæžãå¿ èŠããããŸããã docker-agentã¯ãããYAMLã«ããã宣èšçããªèšå®ã«èœãšã蟌ã¿ãŸãããããã°ã©ãã³ã°ã®ç¥èããªããŠããã©ã®ãšãŒãžã§ã³ãã«ã©ããªåœ¹å²ãšããŒã«ïŒMCPïŒãæãããã©ãäœæ¥ãå§è²ãããããå®çŸ©ããã ãã§ãé«åºŠãªèªåŸåAIããŒã ãæ§ç¯ã§ããŸãã
ãŸãšã
YAMLã§èšå®ã§ããããšèªäœãç®çã§ã¯ãªãããYAMLã§å®£èšçã«å®çŸ©ããããšã§ãè€éãªAIãšãŒãžã§ã³ããDockerã€ã¡ãŒãžã®ããã«ããã±ãŒãžåããå®å šãªã³ã³ããã®äžã§ã誰ã®PCã§ãäžç¬ã§åãããã«åããããšã³ã·ã¹ãã ãäœãããšãããã®ããŒã«ã®çã®ååšäŸ¡å€ã§ãã
ãããåäžã®ãã£ãããããããšããŠè©Šãããã®ã§ããã°ã¡ãªããã¯æãã«ããã§ãããã瀟å ã®ç¹å®ãªããžããªãèªã¿èŸŒã¿ãããŒã«ã«ã®ããŒã«ãé§äœ¿ããŠãããã°ãè¡ãAIããŒã ãäœãããããææ¥ããéçºããŒã å šå¡ã®PCã§äžæã«äœ¿ããããããšãã£ãå Žé¢ã§ããã®ããŒã«ã®æ¬é ãçºæ®ãããŸãã
ãšããããããŒã«ã«ïŒllama-serverïŒã§åããã YAML
#!/usr/bin/env docker-agent run
providers:
llama:
api_type: openai_chatcompletions
base_url: http://localhost:8080/v1
models:
qwen35:
provider: llama
model: Qwen3.5-35B-A3B
max_tokens: 32768
temperature: 0.8
agents:
root:
model: qwen35
description: Local qwen35 assistant
instruction: You are a helpful AI assistant.
skills: true
toolsets:
- type: filesystem
- type: shell
- type: think
- type: todo
- type: memory
- type: fetchllama-server èµ·åäŸ
llama-server -hf unsloth/Qwen3.5-35B-A3B-GGUF:UD-Q4_K_XL --jinja \
--ctx-size 131072 --n-cpu-moe 40 --alias "Qwen3.5-35B-A3B"ã¡ãªã¿ã«ãOllama ã vLLM ã¯å¯Ÿå¿ã謳ã£ãŠããã
llama-server ã¯ãšã©ãŒãåºãã®ã§ãä¿®æ£å 容ã¯åŸã»ã©ã
åºæ¥ãããš
ããªãæ©èœæ°ãããã®ã§ãåºæ¬çãªããšãæ°ã«ãªã£ããã®ã®ã¿ã
ãã¡ããã¡ãæžããïŒã³ããããïŒãã©ãå
¬åŒããã¥ã¡ã³ãèŠãã»ããè¯ãã
Agent Skills
ã°ããŒãã«: ~/.agents/skills/
ãããžã§ã¯ã: .agents/skills/
agents:
root:
model: openai/gpt-4o
instruction: You are a helpful assistant.
skills: true
toolsets:
- type: filesystem # required for reading skill filesMCP ãµãŒããŒ
mcps: # ãããã¬ãã«MCPå®çŸ©ïŒåå©çšå¯èœïŒ
my-mcp:
command: "npx"
args: ["-y", "@example/mcp-server"]
env:
API_KEY: "${MY_API_KEY}"
# ãŸãã¯ãªã¢ãŒãMCP
remote:
url: "https://mcp.example.com/sse"
headers:
Authorization: "Bearer $TOKEN"ã·ã¹ãã ããã³ãã
agents:
root:
instruction: |
è€æ°è¡ã®è©³çްãªã€ã³ã¹ãã©ã¯ã·ã§ã³ãèšè¿°å¯èœ
welcome_message: "ããã«ã¡ã¯ïŒäœããæäŒãããŸããããïŒ"
add_date: true # çŸå𿥿ãããã³ããã«è¿œå
add_environment_info: true # ç°å¢æ
å ±ãããã³ããã«è¿œå
add_prompt_files: # å€éšããã³ãããã¡ã€ã«
- prompts/custom.mdã¢ãã«ã®è©³çް
models:
qwen35:
top_p: 0.9
frequency_penalty: 0.0
presence_penalty: 0.0
parallel_tool_calls: true
thinking_budget: # æšè«äºç®ïŒå¯Ÿå¿ã¢ãã«ã®ã¿ïŒ
effort: "medium" # minimal|low|medium|high
routing: # ã«ãŒã«ããŒã¹ã®ã¢ãã«éžæ
- model: qwen35
examples:
- "翻蚳ããŠ"ãšãŒãžã§ã³ãã®åäœ
agents:
root:
max_iterations: 20 # æå€§ååŸ©åæ°
num_history_items: 50 # å±¥æŽä¿ææ°
code_mode_tools: true # ã³ãŒãã¢ãŒãããŒã«æå¹åã³ãã³ãïŒã·ã§ãŒãã«ããïŒ
agents:
root:
commands:
review: "ã³ãŒããã¬ãã¥ãŒããŠãã ãã"
test:
description: "ãã¹ããå®è¡"
instruction: "pytest ãå®è¡ããŠçµæãå ±åããŠãã ãã"ããã¯
agents:
root:
hooks:
pre_tool_use:
- matcher: "shell"
hooks:
- type: command
command: "notify.sh"
session_start:
- type: command
command: "setup.sh"RAGïŒæ€çŽ¢æ¡åŒµçæïŒ
rag:
my_docs:
tool:
name: "search_docs"
description: "ãããžã§ã¯ãããã¥ã¡ã³ããæ€çŽ¢"
docs: # ã€ã³ããã¯ã¹å¯Ÿè±¡
- ./docs
- ./README.md
respect_vcs: true # .gitignore ãå°é
strategies:
# æ¹æ³1: ãã¯ãã«åã蟌ã¿
- type: chunked-embeddings
embedding_model: openai/text-embedding-3-small
vector_dimensions: 1536
database: ./rag.db # SQLite DB ãã¡ã€ã«
chunking:
size: 1000 # ãã£ã³ã¯ãµã€ãº
overlap: 100 # ãªãŒããŒã©ãã
respect_word_boundaries: true
code_aware: true # TreeSitter 䜿çš
results:
limit: 10
deduplicate: true
# ãšãŒãžã§ã³ãã§äœ¿çš
agents:
root:
model: qwen35
rag:
- my_docs # RAG ãæå¹åãã¯ãã«DB: SQLite
åã蟌ã¿ã¢ãã«: OpenAI text-embedding-3-small ç
ãã£ã³ãã³ã°: ããã¹ã / TreeSitterïŒã³ãŒãèªèïŒ
æ€çŽ¢æŠç¥: BM25 / Chunked Embeddings / Semantic Embeddings
åå: ããã¥ã¡ã³ããèªåçã«ã€ã³ããã¯ã¹åããã
ã¯ãšãª: ãšãŒãžã§ã³ããèªåçã« search_docs ããŒã«ã䜿çš
æŽæ°: ãã¡ã€ã«å€æŽãç£èŠããèªåã§åã€ã³ããã¯ã¹
å¯Ÿè±¡ã®æå®ã¯éçããããããã¡ã€ã«ïŒãã©ã«ã倿Žã®ç£èŠããããšããããšã¯ãããŒã«ãã¹ãã«ã§ãããã¥ã¡ã³ãã®è¿œå ã¯ã§ãããã
ããŒã«ã«ã¢ãã«çšã®æ³šæç¹:
llama-server ã䜿çšããå Žåãåã蟌ã¿ã¢ãã«ãå¿
èŠã§ãã
models:
embed:
provider: llama
model: nomic-embed-text
# ãŸã㯠embedding_model ãšããŠçŽæ¥æå®ããŒããã·ã§ã³
permissions:
allow: ["read_*", "filesystem"]
ask: ["shell", "mcp:*"]
deny: ["delete_*"]远å ããŒã«ã¿ã€ã
toolsets:
- type: lsp # Language Server Protocol
file_types: [".go", ".py"]
- type: openapi # OpenAPI/Swagger
spec_url: "https://api.example.com/openapi.json"
- type: script # ã«ã¹ã¿ã ã¹ã¯ãªãã
shell:
mytool:
cmd: "./scripts/mytool.sh"
description: "ã«ã¹ã¿ã ããŒã«"
- type: model_picker # ã¢ãã«éžæ
models: ["gpt4", "claude"]
- type: a2a # Agent-to-Agentéä¿¡type: script ã«ã€ããŠã
åŒæ°ã®æå®ãå¯èœã§ãã JSON Schema 圢åŒã§åå®çŸ©ã§ããŸãã
toolsets:
- type: script
shell:
# åŒæ°ãªã
get_ip:
cmd: "curl -s https://ipinfo.io | jq -r .ip"
description: "ãããªãã¯IPãååŸ"
# åŒæ°ããïŒãªãã·ã§ã³ïŒ
docker_images:
cmd: "docker images $img"
description: "Dockerã€ã¡ãŒãžäžèЧ"
args:
img:
description: "ã€ã¡ãŒãžåã§ãã£ã«ã¿"
type: string
# åŒæ°ããïŒå¿
é ïŒ
deploy:
cmd: "./scripts/deploy.sh ${env}"
description: "ç°å¢ã«ãããã€"
required: ["env"]
args:
env:
type: string
enum: [staging, production] # åæåãå¯
description: "ãããã€å
ç°å¢"
# è€æ°åŒæ°
search_package:
cmd: "curl -s 'https://api.example.com/search?q=$keyword&lang=$lang'"
required: ["keyword"]
args:
keyword:
type: string
description: "æ€çŽ¢ããŒã¯ãŒã"
lang:
type: string
enum: [go, python, rust]
description: "ããã°ã©ãã³ã°èšèª"
env: # ç°å¢å€æ°
API_KEY: "${MY_API_KEY}"
working_dir: "./scripts" # å®è¡ãã£ã¬ã¯ããªããããã£äžèЧ
cmd: (string) ã³ãã³ãïŒ${arg} ã§å€æ°å±éïŒ
description: (string) ã¢ãã«ã«è¡šç€ºããã説æ
args: (object) JSON Schema 圢åŒã®åŒæ°å®çŸ©
required: (array) å¿ é åŒæ°ã®ãªã¹ã
env: (object) ç°å¢å€æ°
working_dir: (string) å®è¡ãã£ã¬ã¯ããª
ããŒã«ã»ããã®è©³çްãªãã·ã§ã³
toolsets:
- type: filesystem
path: "/workspace"
ignore_vcs: true # .gitignoreãå°é
post_edit: ["gofmt -w"]
- type: shell
timeout: 60
env:
MY_VAR: "value"
- type: todo
shared: true # å
±æã¿ã¹ã¯
- type: mcp
ref: "my-mcp" # ãããã¬ãã«MCPåç
§
tools: ["tool1", "tool2"] # ç¹å®ããŒã«ã®ã¿äœ¿çš
instruction: "MCPåºæã®æç€º"ã¡ã¿ããŒã¿
metadata:
author: "Your Name"
version: "1.0"
description: "ã«ã¹ã¿ã ãšãŒãžã§ã³ãèšå®"
license: "MIT"ãµããšãŒãžã§ã³ã
agents:
main_assistant: # root ã§ãªããŠãOK
model: gpt-4o
sub_agents: # ã¿ã¹ã¯å§è²çš
- code_reviewer
- translator
handoffs: # äŒè©±åŒãç¶ãçš
- support_specialist
code_reviewer:
model: claude
instruction: ã³ãŒãã¬ãã¥ãŒå°é
support_specialist:
model: gpt-4o
instruction: ãµããŒãå°éãŠãŒã¶ãŒèŠç¹
ãµããšãŒãžã§ã³ããå®çŸ©ããŠããã°ãLLM ãåæã«å€æããŠäœ¿ã
LLMèŠç¹
transfer_task ãšããããŒã«ã®äžã€ãšããŠèªèããå¿ èŠã«å¿ããŠåŒã³åºã
ãµããšãŒãžã§ã³ãïŒsaïŒãšãã³ããªãïŒhoïŒã®éã
ããŒã«
(sa) transfer_task, (ho) handoff
ã»ãã·ã§ã³
(sa) æ°ããåã»ãã·ã§ã³ãäœæ, (ho) åãã»ãã·ã§ã³ã§åãæ¿ã
å¶åŸ¡
(sa) ã¿ã¹ã¯å®äºåŸã«æ»ã, (ho) åãæ¿ãããŸãŸç¶ç¶
ã³ã³ããã¹ã
(sa) ã¿ã¹ã¯åºæã®èª¬æã®ã¿, (ho) å šäŒè©±å±¥æŽãåŒãç¶ã
çšé
(sa) ç¹å®ã¿ã¹ã¯ã®å§è², (ho) å°éå®¶ãžã®åŒãç¶ã
ã³ã³ããã¹ã
ïŒèªåä¿åïŒã»ãã·ã§ã³ã¯èªåçã«æ°žç¶å
ïŒåŸ©å ïŒéå»ã®ã»ãã·ã§ã³ããåéå¯èœ
ïŒãã©ã³ãïŒéå»ã®ã»ãã·ã§ã³ããåå²ããŠç¶ç¶å¯èœ
ã»ãã·ã§ã³å§çž®
ã³ã³ããã¹ããŠã£ã³ããŠãéçã«éãããšèªåã§å§çž®ãããŸãã
é·ãäŒè©±å±¥æŽ: ã³ã³ããã¹ãå¶éã«è¿ã¥ã
èŠçŽãšãŒãžã§ã³ããèŠçŽãçæ
"äœãããããäœãããŠããããæ¬¡ã«äœãããã"
å€ãã¡ãã»ãŒãžãèŠçŽã«çœ®ãæã
ã³ã³ããã¹ããç¯çŽ
agents:
root:
model: gpt
num_history_items: 30 # å±¥æŽä¿ææ°ïŒããã©ã«ã: ã¢ãã«äŸåïŒèšæ¶ïŒã¡ã¢ãªïŒ
é·æèšæ¶ãšã㊠SQLite ã«ä¿åãããŸãã ã»ãã·ã§ã³ããŸããã§æ°žç¶ããŸãã
agents:
root:
toolsets:
- type: memory
path: ./my_memory.db # ä¿åå
ïŒããã©ã«ã: ~/.cagent/memory/agent/memory.dbïŒããŒã«
save_memory: èšæ¶ãä¿åïŒã«ããŽãªãããŒã¯ãŒãä»ãïŒ
get_memories: å šèšæ¶ãååŸ
search_memories: ããŒã¯ãŒã/ã«ããŽãªã§æ€çŽ¢
delete_memory: èšæ¶ãåé€
update_memory: èšæ¶ãæŽæ°
llama-server ã ãšãšã©ãŒã§åããªãã£ã
èµ·åã¯ããããããŒã«ãèšå®ãããšãååããã³ããå ¥åã§èœã¡ãã
ãœãŒã¹ã³ãŒããæã£ãŠãã
git clone https://github.com/docker/docker-agent.git
cd docker-agentä¿®æ£ãã¡ã€ã«: pkg/model/provider/openai/client.go
// ä¿®æ£å
func convertMessages(messages []chat.Message) []openai.ChatCompletionMessageParamUnion {
return oaistream.ConvertMessages(messages)
}
// ä¿®æ£åŸ
func convertMessages(messages []chat.Message) []openai.ChatCompletionMessageParamUnion {
return oaistream.MergeConsecutiveMessages(oaistream.ConvertMessages(messages))
}å¿ èŠãªã¢ããªãã€ã³ã¹ããŒã«ïŒubuntu ã®äŸïŒ
sudo apt install golang-go
sudo apt install taskãã«ã
task buildå®è¡
./bin/docker-agent run agent.yamlææ
äžçªã¯ããã«åãããæã¯ããã ããïŒãã ã£ããã©ããã®åŸãGemini ã GLM-5 ãšäŒè©±ããŠãdocker-agent ã®è¯ããåãã£ãŠããã
Agent Skills ãåããããæ©èœã¯ããªãå å®ããŠããã
ç©æ¥µçã«äœ¿ã£ãŠãããããªã