​

에이전트 구성

​

에이전트 생성

1. 에이전트 > 새 에이전트로 이동합니다.
2. 이름과 설명을 선택하세요
3. 모델 선택(또는 스마트 라우팅 결정)
4. 도구, 기술, 권한 구성
5. 저장 - 에이전트를 사용할 준비가 되었습니다.

​

편집-테스트 제로 탐색

• 인라인 구성 패널: 입력 상자 옆에 있는 에이전트 표시기 버튼을 클릭하여 구성 패널을 확장합니다. 시스템 프롬프트, 기술 및 MCP 도구에 대한 변경 사항은 바로 다음 메시지에 적용됩니다.
• 스마트 축소: 패널은 메시지를 보낸 후 자동으로 축소되므로 대화를 방해하지 않습니다. 한 번의 클릭으로 다시 확장
• 탐색 시 자동 저장: 편집기 페이지에서 “채팅 시작”을 클릭하면 채팅 페이지로 이동하기 전에 저장되지 않은 변경 사항이 자동으로 저장됩니다.
• 일관된 탐색: 모든 진입점(사이드바, 설정, 템플릿 마켓, 조직 마켓플레이스)은 동일한 탭 내에서 탐색하며 새 브라우저 탭을 열지 않습니다.

​

턴당 능력 칩 (스킬/MCP)

• 다음 메시지에만 해당에 대한 임시 스킬/MCP 하위 집합을 선택하세요.
• 빼기 우선 동작: 현재 에이전트에서 이미 활성화된 기능으로 선택이 제한됩니다.
• 대기열 안전 의미: 직접 보내기, 대기 중인 보내기 및 바쁜 다시 대기열 모두 동일한 1회 무시 의도를 유지합니다.
• 즉각적인 캐시 안전 정규화: 전체 세트를 선택하면 시끄러운 구성 이탈을 생성하는 대신 무작동 재정의로 축소됩니다.

​

이것이 실제 사용에서 중요한 이유

• 우발적인 도구 지출 감소: 사용자는 장기 상담원 프로필을 변경하지 않고도 위험한 방향으로 도구 범위를 좁힐 수 있습니다.
• 더 깔끔한 공동 작업: 팀원이 집중 회전을 실행하고 즉시 기본 프로필로 돌아갈 수 있습니다.
• 추측이 아닌 운영 증명: 원격 분석으로 제출/적용/noop/큐/바쁨/최종 결과 및 실패 이유를 추적합니다.

• GET /api/v1/statistics/turn-capability/summary

​

모델 선택

​

스마트 라우팅

• Inherit Global(기본값): 전역 스마트 라우팅 구성을 따릅니다.
• 사용자 정의: 이 에이전트에 대해 독립적인 조명 및 추론 모델을 지정합니다.
• 비활성화됨: 이 에이전트는 항상 기본 모델(라우팅 없음, 계층 분류 없음)을 사용합니다.

​

다중 슬롯 모델 아키텍처

​

사고강도

​

프롬프트 모드

​

사용자 정의 시스템 프롬프트

​

도구 구성

• 내장 도구: 파일 작업, 터미널, 브라우저, 검색, 코드 실행, 작업 공간 @codebase 개요 + grep/glob 탐색
• MCP 도구: Model Context Protocol 서버를 통한 외부 도구
• 기술: 재사용 가능한 작업별 기능

​

진행 평면

​

지연된 도구 로딩

​

스킬 핫 리로드

​

내장 에이전트 로컬라이제이션

​

메모리

• 에이전트별 메모리: 해당 에이전트에 고유한 지식
• 글로벌 공유 메모리: 모든 에이전트가 액세스할 수 있는 지식
• Memory Decay: 기억이 사라지는 속도를 제어합니다(영구/보통/빠름).
• Memory Focus: 도메인별 추출 지침 — 에이전트가 귀하에 대해 학습할 때 우선순위를 구성합니다.

​

메모리 포커스(도메인 추출 프리셋)

​

성격

• 중국어, 영어 이중언어 지원
• 이모티콘 + 톤 맞춤 설정
• GUI의 카테고리 기반 갤러리
• 맞춤형 성격 생성

​

반복 예산 (에이전트별 최대 반복 횟수)

​

하위 에이전트 오케스트레이션

​

역할 경계 및 도구 안전 격리

​

외부 에이전트 위임(ACP)

• Claude Code — Anthropic의 코딩 에이전트
• Codex CLI — OpenAI의 코딩 에이전트
• Gemini CLI — Google의 코딩 에이전트
• 모든 ACP 호환 에이전트 — RuntimePool을 통해 확장 가능

​

Google A2A 프로토콜

​

에이전트 프로필: 혼선 없는 정밀도

​

스킬 크로스톡을 방지하는 방법

1. 에이전트 프로필 — 각 에이전트는 skill_ids[]을 통해 지정된 기술만 로드합니다.
2. 도구 조건 활성화 — requires_tools / fallback_for_tools를 통해 사용 가능한 도구에 따라 스킬 자동 표시/숨기기
3. 점진적 공개(L0–L3) — 관련 기술 세부정보만 전체 콘텐츠로 확장됩니다.
4. 노이즈 게이지 - 소음 임계값을 초과하는 스킬은 자동으로 감쇠됩니다.
5. 하이브리드 검색 — Qdrant 벡터 검색은 각 쿼리에 가장 관련성이 높은 기술을 선택합니다.

​

내장 도구 SSOT(2026년 7월)

• 15개의 정식 ID — 14개의 UI 토글 가능 ID 및 에이전트 기준 file_ops / code_execute(항상 Turn1 열망, 패널 토글 없음).
• 27개의 사전 설정된 에이전트 매트릭스 — 시작 시 이니셜라이저가 동기화됩니다. 갤러리 및 설정 목록에는 27개의 내장 기능이 모두 표시됩니다(AGENT_LIST_BUILTIN_PAGE_SIZE=50 기본값, enabled_builtin_tools의 칩).
• 단일 쓰기 경로 — persist_enabled_builtin_tools는 DB 쓰기 전에 유효성을 검사합니다. 레거시 ID는 자동 실패 대신 422를 반환합니다.
• 기본 프로필 — UI 기본값은 web_search + memory + structured_clarify(구조화된 다중 질문 양식)입니다. 파일/셸 기능은 에이전트 기준을 통해 항상 켜져 있습니다. 양식 페이로드는 requires_confirmation: bool(경쟁사 스타일 5형 열거형 대체)을 사용합니다. true인 경우 WebUI는 호박색 위험 확인 강조를 렌더링합니다.
• 사용자 스위치 ON → Turn1 직접 사용 — 기본 또는 수동으로 활성화된 내장 기능(선택한 경우 cron, structured_clarify, render_ui, 컴퓨터_use, x_search, Delegate_to_agent 포함) 및 바인딩된 기술 도구는 discover_capability을 먼저 호출하지 않고 첫 번째 턴 LLM 스키마에 나타납니다. Cron 기본값은 OFF(검색 가능) — 이를 활성화한 사용자만 ~827 토크 열망 스키마를 지불합니다. OpenClaw/Hermes은 항상 에이전트별 선택 해제 없이 Turn1에 cron을 마운트합니다. structured_clarify 꺼짐 → 0 ask_question_tool 스키마 — 영구적인 메시지에 설명을 추가하는 경쟁업체와는 다릅니다. 하네스 **ClarificationGuardMiddleware**는 회전당 최대 하나의 ask_question_tool을 적용하고 병렬 도구를 차단합니다(Hermes 단일 회전 clarify 제약 조건에 맞춰 조정됨).
• active_tool_groups SSOT — derive_active_tool_groups()은 활성화된 그룹을 한 곳에서 파생시켜 render_ui 또는 미디어 그룹이 이미 켜져 있을 때 거짓 capability_gap을 방지합니다.
• 전체 행렬 회귀 — CAPABILITY_GAP_REGISTRY은 14 GUI-togglable 내장 기능(web_search, memory, cron, Answer_tool, browser, render_ui, Computer_use, wiki, kanban, Planning, structured_clarify, 미디어 트리오)을 다룹니다. 에이전트 기준 file_ops / code_execute은 런타임에 강제되며 간격 힌트에서 제외됩니다. 편집 가능한 화이트보드: MCP을 통한 다이어그램.
• 자격 공백 — 실행 전은 에이전트 루프 전에 각 사용자 메시지를 검색합니다(Turn1 스키마를 변경하지 않고 SSE capability_gap / skill_gap). 발견 미스는 동일한 레지스트리를 사용합니다. WebUI는 /api/v1/workspace/stream 멀티플렉스(POST 전에 등록된 리스너이므로 초기 청크가 버퍼링됨)를 통해 프리플라이트 이벤트를 수신합니다. Toast는 원클릭 활성화/바인딩을 제공합니다. 스트림이 로드되는 동안 클릭하면 pendingGapRetry는 MESSAGE_END, ERROR 또는 CANCEL(두 번째 수동 전송 없음) 후에 자동으로 다시 전송됩니다.
• 세션 도구 패널 — 채팅 입력 렌치 아이콘은 SSE tools_snapshot(레이어 배지 포함)를 통해 라이브 Turn1-bound 도구를 표시하며, 이는 설정에서 전환된 것뿐만 아니라 에이전트가 지금 바로 호출할 수 있는 것을 반영합니다.
• 제어판 도구(기본 Turn1 토큰 없음) — 오케스트레이션 신호(Deep Research), CompletionGuard(_completion_check), Verifier(submit_verdict) 및 워크플로 PTC(spawn_subagent/notify)는 감사를 위해 등록되지만 기본 채팅 바인드에서 제외 — 일반 채팅은 생성/오케스트레이션 스키마 세금을 지불하지 않습니다. 측정된 기본 프로필: 15개 도구 / ~8,354개의 톡 도구 레이어(2026년 7월 SSOT).

​

대 경쟁업체 접근 방식

​

에이전트 바인딩

​

슬래시 명령 바인딩

​

싱글 스킬

command_name: deploy
skill_ids: [deploy_skill]
description: Deploy to production

​

멀티 스킬 번들

command_name: daily-report
skill_ids: [data_collector, report_generator, email_sender]
instruction: Collect today's metrics, generate a summary, and email it to the team.

​

작동 방식

1. 구성 — 에이전트 편집기의 드롭다운에서 여러 기술을 선택하고 선택적으로 지침을 추가합니다.
2. 트리거 — 슬래시 팔레트(WebUI), 데스크톱 앱 또는 IM 채널에 /daily-report을 입력합니다.
3. 실행 — 하네스는 모든 SOP를 로드하고 토큰 예산을 시행하며 하나의 조정된 턴으로 실행합니다.

​

입력 상호작용 세부 사항

• 입력 어디에서나 트리거 — 슬래시 메뉴는 커서 바로 앞의 토큰에 고정되므로 fix it /systematic-d도 명령이 맨 앞에 있는 것처럼 팔레트를 엽니다. 경쟁사(예: OpenClaw)는 입력이 /로 시작할 때만 메뉴를 표시합니다.
• 하이픈 명령 이름 지원 — /code-review, /systematic-debugging 등이 실시간으로 인식됩니다. 정규식에 -가 포함되어 하네스의 기술 명명 규칙과 일치합니다.
• 주변 텍스트 유지 — 선택/실행/Esc 닫기 시 명령 토큰만 제거되고 앞뒤 텍스트는 지시문으로 유지됩니다. fix it /systematic-d → 접두사 fix it 이 남고 기술이 활성화됩니다.
• @ 멘션 누출 방지 — @ 메뉴로 추가된 참조는 전송 전 입력에 대한 활성 검사를 거칩니다. @ 텍스트를 삭제하면 참조가 요청에서 제거되어 다른 에이전트로의 오위임이나 wiki/chat 참조 오삽입을 방지합니다. 입력/붙여넣기 인라인 토큰(@wiki:개념, @파일:12-20, @folder:경로, @url:…, @staged, @diff, @codebase)은 패널 없이 즉시 파싱됩니다.

​

에이전트별 격리

​

프로필 스냅샷 및 롤백

​

내보내기, 가져오기 및 복제