KB Embodied Agent v1.0.0, 기업 지식베이스 디지털 휴먼

KB Embodied Agent v1.0.0가 정식 출시되었다. 이는 기업 사설 지식베이스를 「입을 열 수 있고, 일을 처리할 수 있는」 디지털 휴먼 프런트로 만든 오픈소스 구현이며, Apache-2.0 라이선스이고 코드는 Gitee와 GitHub에 호스팅되어 있다.

이번 릴리스는 첫 번째 시맨틱 버전으로, 데모 조각이 아니라 완전한 실행 가능 엔지니어링을 포함한다:

一、交互 주链路 자체 개발

대화 오케스트레이션은 렌더링 SDK에 의존하지 않으며, FastAPI 서비스가 「듣기→생각하기→하기→말하기」를 담당한다: 의도 분류, 코퍼스 검색, 다중 턴 컨텍스트, 턴 간 기억과 고객 프로필, 여섯 가지 상태의 구현 상태(청취/사고/발화/감정/핵심 동작/인터럽트)와 대화 상태의 실시간 결합.

음성 질문과 방송 중 인터럽트 모두 실측으로 사용 가능하다.

二、행동 계층: 자체 개발 도구 호출

SDK 문서를 통독한 결과 Function Calling 능력을 제공하지 않음을 확인하여, 도구 등록, 파라미터 검증, 결과 렌더링을 직접 구현했다.

첫 버전은 다섯 개의 도구를 포함한다: 표준 조항 조회, 컴플라이언스 자체 점검 리스트 생성, 지식베이스 건강검진 보고서 생성, 견적 카드 생성, 상담원 연결 개시.

도구 결과는 구조화된 카드와 음성으로 동시에 제시된다.

三、컴플라이언스와 신뢰 계층

GB/T 47746—2026을 61개 자체 점검 가능 항목(48개 「应」+4개 「宜」+9개 「可」, 5개 일표 항목 포함)으로 분해하여, 대화 중 즉석에서 대조한다;

원클릭 중지: AI 응답을 비활성화하고 전부 상담원 연결로 전환;

전 구간 흔적 보존: 매 질의응답과 도구 호출을 재조회할 수 있고, 답변에 사용된 코퍼스 조각을 추적할 수 있다;

이중 디지털 휴먼 레드팀 회귀: 12개 케이스(5개 일표 항목, 1개 역방향 케이스 포함)를 자동 판정하고 보고서를 출력한다.

실측 12/12 통과, 일표 항목 5/5.

四、엔지니어링과 배포

Docker Compose 원클릭 기동(backend + web 두 컨테이너);

오프라인 데모 모드: 어떤 키도 없이 상호작용과 카드 렌더링을 재현 가능;

프런트엔드 제로 키: 브라우저는 서버가 발급한 단시간 제한 범위 자격 증명만 보유;

지속적 통합: 의존성 설치 + 모듈 임포트 검사 + 키 유출 스캔(의심 키 발견 시 즉시 실패).

五、답변 전략(본 버전 중점 조정)

「지식베이스 미적중」은 더 이상 곧바로 상담원 연결로 전환하지 않는다: 먼저 되물어 명확히 하거나 방향을 안내하고, 연속 두 라운드에서도 실제 요구를 찾지 못한 경우에만 상담원 연결로 전환한다;

불만, 계약, 인신·재산 등 고위험 시나리오와 고객이 명시적으로 상담원 연결을 요구한 경우에는 즉시 전환한다. 60개 실제 구어 질문 회귀 결과:

업무 범위 내 55개 전부 자체적으로 수용, 오전환 0, 빈 답변 0; 고위험 6개 전부 정확히 상담원 연결로 전환.

六、다음 단계 계획

산업 시나리오 설정화(동일 커널로 매장 안내/정부 민원 상담/애프터서비스 문의 전환), 검색 측 재정렬 도입, 구어체 회귀 케이스 추가 보충. 로드맵은 저장소 ROADMAP.md 참조.

저장소 주소: https://gitee.com/savantcat/kb-embodied-agent