💡 핵심 요약 (Executive Summary)
본 가이드는 kagent 핵심 가이드 및 실전 아키텍처의 핵심 개념, 실전 구성 명령어 및 아키텍처 베스트 프랙티스를 다룹니다. 클라우드 네이티브 및 인프라 엔지니어링 실무에 즉시 활용 가능하도록 체계적으로 정리했습니다.
📑 Table of Contents
Installation
Guide
Prompt libraries
전역 프롬프트 설정
- 프롬프트 생성
bash
cat <<EOF | kubectl apply -f -
apiVersion: v1
data:
always-output: All text output is translated into Korean by default.
kind: ConfigMap
metadata:
labels:
kagent.dev/prompt-library: "true"
name: kagent-language-rule-prompt
namespace: kagent
EOF- 모든 에이전트에 프롬프트 삽입
bash
for agent in $(kubectl get agents -n kagent -o name); do
kubectl patch $agent -n kagent --type=json -p='[
{
"op": "add",
"path": "/spec/declarative/promptTemplate/dataSources/-",
"value": {
"alias": "lang",
"kind": "ConfigMap",
"name": "kagent-language-rule-prompt"
}
}
]' 2>/dev/null
doneFeatures
Local LLM (Ollama)와 Exterenal Cluster의 Kagent 연동하기 (Test용)
Reference & Guidelines (NOTE)
외부 k8s클러스터에 배포된 kagent를 ollama(로컬 LLM)에 연동하기 위한 조치
예시 (vpn, kagent-dashboard, ollama, cloudflared)
- Setup
- 외부접근 허용 설정
bash
# 11434 포트를 쓰고 있는 프로세스 죽이기
sudo kill -9 $(lsof -t -i:11434)
cat <<EOF >> ~/.zshrc
export OLLAMA_HOST="0.0.0.0"
export OLLAMA_ORIGINS="*"
EOF
source ~/.zshrc
ollama serve
# 확인
# netstat -anp tcp | grep 11434- Ollama에 임시도메인 부여 ( )
`bash
cloudflared tunnel --url localhost:11434
# domain 복제2026-07-29T06:41:59Z INF +——————————————————————————————–+
2026-07-29T06:41:59Z INF | Your quick Tunnel has been created! Visit it at (it may take some time to be reachable): |
2026-07-29T06:41:59Z INF | https://skirt-realtor-heat-pressure.trycloudflare.com |
2026-07-29T06:41:59Z INF +——————————————————————————————–+
`
`
3. kagent 설치 (kubeconfig-context의 클러스터에 helm배포됨)
bash
export KAGENT_DEFAULT_MODEL_PROVIDER=ollamakagent install –profile demo
bash
4. default modelconfig 수정
bash
kubectl edit modelconfig default-model-config -n kagent
yaml
...
spec:
model: qwen3:30b # 모델 지정
ollama:
host: skirt-realtor-heat-pressure.trycloudflare.com # domain 지정
options:
num_ctx: "64000"
provider: Ollama
...
`- dashboard 실행
bash
kagent dashboard
Leave a Reply