CRMAI Docs오버라이드 설정
목적
에이전트의 Configuration Template에서 상속되어야 할 설정을 개별 에이전트 수준에서 재정의(override)할 수 있게 해줍니다. 이 탭에는 토글로 제어되는 세 개의 섹션이 있으며, 모두 기본적으로 꺼져 있습니다.
권장 주석: 세 섹션을 모두 담기 위해 2장의 스크린샷을 겹쳐야 할 가능성이 있으므로, 각 섹션 헤더에 색상 탭으로 라벨을 붙입니다: 🟠 "Agent Overrides", 🟡 "Runtime Config", 🟢 "Generation Config" — 아래 H2 제목과 일치시켜 독자가 올바른 스크린샷 영역으로 바로 이동할 수 있도록 합니다. Agent Overrides 내에서는 오른쪽 상단의 마스터 토글을 원으로 표시하여, 아래 필드들이 의미를 가지려면 이 토글이 켜져 있어야 함을 강조합니다.
Agent Overrides
"Specific settings for this agent that will override settings from the Config Template."
필드 | 설명 | 표시된 예시 |
|---|---|---|
Agent Language (Override) | 이 에이전트에 한해 템플릿의 Primary language를 재정의합니다. | Indonesian |
Verbosity Level (Override) | 템플릿의 Verbosity level을 재정의합니다. | Medium |
Reasoning Mode (Override) | 템플릿의 Reasoning mode를 재정의합니다. | Minimal |
Archetype (Override) | 템플릿의 Archetype을 재정의합니다(여기서는 자유 텍스트이며, 템플릿 자체에서는 드롭다운입니다). | friendly |
Warmth Score (Override) | 슬라이더 — 이 에이전트에 대해 템플릿의 Warmth score를 재정의합니다. 템플릿 값으로 되돌리는 Reset Override 링크를 포함합니다. | 80 |
Allow Emoji (Override) | 토글. 비활성화하면 라벨이 "Follow Template if disabled"로 표시됩니다 — 즉, 이 토글을 끈다고 해서 이모지가 강제로 꺼지는 것이 아니라, Config Template에 지정된 내용을 그대로 따르게 됩니다. | On |
여기에 표시된 필드만 에이전트별로 재정의할 수 있습니다. 다른 템플릿 필드(Persuasion style, Empathy/Analytical/Assertiveness/Adaptability 점수, Avoid repetition과 같은 스타일 토글 등)는 에이전트별 재정의로 노출되지 않으며 항상 선택된 Config Template을 따릅니다.
Runtime Config
"Agent runtime settings, including knowledge and history compression."
필드 | 설명 | 표시된 예시 |
|---|---|---|
Knowledge Enabled | 토글 — "Enable the use of knowledge (RAG)." 이 에이전트가 Knowledge Base에서 정보를 검색할지 여부 전체를 제어합니다. | On |
Knowledge Limit | 쿼리당 검색되는 knowledge 청크/문서의 개수. | 5 |
Knowledge Score Threshold | 슬라이더(0~1) — knowledge 청크가 사용되기 위해 필요한 최소 관련성 점수. | 0.5 |
History Compression | 토글 — "Compress conversation history when context is too long." | Off |
History Summary Recent Count | 압축이 활성화되어 있어도 완전한 세부 정보(압축되지 않은 상태)로 유지되는 최근 메시지의 개수. | 6 |
Knowledge Enabled가 꺼져 있으면, Knowledge 탭에 동기화된 문서나 사이트맵의 수와 관계없이 에이전트는 그곳에 구성된 모든 내용을 무시합니다.
Generation Config
"Advanced settings for LLM text and processing." 이 설정들은 에이전트가 선택한 Model Profile에 설정된 값을 재정의합니다.
필드 | 설명 | 표시된 예시 |
|---|---|---|
Temperature | 응답의 무작위성. | 1 |
Top P | Nucleus sampling 파라미터. | 1 |
Frequency Penalty | 동일한 토큰의 반복을 줄입니다. | 0 |
Presence Penalty | 새로운 주제 도입을 장려합니다. | 0 |
Max Output Tokens | 에이전트별 응답 길이 상한. | 1500 |
Reasoning Mode | 이 에이전트에 대해 Model Profile의 reasoning mode를 재정의합니다. | Minimal |
Verbosity Level | Generation 전용 verbosity를 재정의합니다(위의 Agent Overrides에 있는 Verbosity Level과는 별개로, 이것은 Generation Config 하위에 있습니다). | Low |
중복되는 부분에 주의하세요: Verbosity Level과 Reasoning Mode는 Agent Overrides와 Generation Config 양쪽에 모두 나타납니다. 실제로는 Agent Overrides 쪽을 페르소나 수준의 설정(톤/스타일에 영향)으로, Generation Config 쪽을 모델 수준의 생성 파라미터로 취급하세요 — 두 값을 다르게 설정한 경우, 어느 쪽이 실제로 우선하는지 테스트하여 혼란스러운 동작을 피하세요.
운영 가이드
공유된 Model Profile / Configuration Template에서 벗어나야 할 구체적인 이유가 없다면 세 섹션 모두 꺼진 상태로 두세요 — 이는 에이전트 간에 동작의 일관성을 유지하기 위해 존재하는 것입니다.
여기의 Max Output Tokens(Generation Config를 통한 에이전트별 설정)는 Model Profile 자체의 Max output tokens 및 Governance Authority Limit Level(레벨 × 1000)과 함께, 응답 길이를 제한할 수 있는 세 번째 지점입니다. 실제로는 가장 작은 값이 우선 적용됩니다 — 응답이 예상치 못하게 짧게 잘린 것처럼 보인다면 세 가지 모두를 확인하세요.
Knowledge Enabled는 의도적으로 켜세요 — 에이전트가 Knowledge Base를 참조할 필요가 없다면, 이를 꺼두면 지연 시간과 관련 없는 검색 컨텍스트를 줄일 수 있습니다.
테스트할 때는 Reset Override를 자유롭게 사용하세요 — 동작 변화가 여러분의 재정의에서 온 것인지, 아니면 기본 템플릿에서 온 것인지를 빠르게 확인하는 방법입니다.
재정의를 활성화한 이유를 팀이 볼 수 있는 곳에 문서화하세요(예: 해당 에이전트의 Agent Tasks & Role 필드에). 재정의는 템플릿이 제시하는 것과 다르게 에이전트의 동작을 조용히 벗어나게 할 수 있기 때문입니다. 재정의를 활성화한 후에는 정확히 무엇이 변경되었는지 확인하기 위해 Snapshots를 검토하세요.
관련 항목: Model Profiles & Configuration Templates · Governance & Autonomy · Knowledge Base · Snapshots (원본 문서에 링크가 제공되지 않음)