이 빠른 찾기 사용법
- 브라우저의 페이지 찾기로 용어를 검색합니다.
- 정확한 뜻이 필요하면 전문 정의를 읽습니다.
- 여전히 추상적이면 생활 속 설명을 읽습니다.
- 권한 변경, 확장 설치, 패키지 게시 전에는 연결된 자세한 가이드도 확인합니다.
모델, Agent, Harness
| 개념 | 전문 설명 | 쉬운 예시 |
|---|---|---|
| AI 모델 | 입력을 해석하고 글, 코드, 그 밖의 결과를 만드는 통계 시스템입니다. 모델 자체에는 컴퓨터 접근 권한이 없습니다. | 생활 속 설명: 책상에서 생각하는 사람에 가깝습니다. 책상, 도구, 열쇠, 기록은 시스템의 다른 부분이 제공합니다. |
| Agent | 모델에 지침, 컨텍스트, 도구, 반복 실행을 결합해 목표를 향해 여러 단계를 수행하는 실행 역할입니다. | 생활 속 설명: 한 번 답하는 대신 살펴보고, 작업하고, 결과를 확인한 뒤 계속하는 담당자입니다. |
| Agent Harness | Agent 작업에 필요한 모델, 도구, 컨텍스트, 권한, 세션, 화면을 조율하는 소프트웨어입니다. | 생활 속 설명: 작업자를 둘러싼 관리형 공방입니다. 사용할 도구, 잠긴 문, 기록할 내용을 정합니다. |
| Provider | 모델을 Harness에서 사용할 수 있게 하고 요청 형식과 인증을 처리하는 서비스 또는 어댑터입니다. | 생활 속 설명: 같은 공방에 다른 전기 공급사를 연결하지만 공급사마다 계정과 연결 규칙이 다릅니다. |
| Tool | 파일 읽기, 글 편집, 명령 실행, 정보 검색처럼 Agent가 요청할 수 있는 이름 있는 기능입니다. | 생활 속 설명: 도구함에 있는 한 가지 도구입니다. 목록에 있어도 승인 없이 쓸 수 있다는 뜻은 아닙니다. |
| Context | 현재 모델 요청에 제공된 지침, 선택한 이력, 파일, 도구 결과 등의 정보입니다. | 생활 속 설명: 이번 판단을 위해 책상에 펼쳐 둔 자료입니다. 지금까지 모든 일을 영구히 기억하는 것은 아닙니다. |
작업을 구성하는 방법
| 개념 | 전문 설명 | 쉬운 예시 |
|---|---|---|
| Workspace | 작업의 중심으로 선택한 프로젝트 위치입니다. 그 안의 파일과 명령이 주요 작업 경계를 이룹니다. | 생활 속 설명: 작업자에게 내준 한 방이지 건물 전체 출입증은 아닙니다. |
| Session | 한 줄기의 계속되는 작업에 대해 메시지, 모델 출력, 도구 활동, 상태를 저장하는 기록입니다. | 생활 속 설명: 나중에 돌아와도 논의와 작업을 이해할 수 있는 프로젝트 일지입니다. |
| Turn | 허용된 사용자 입력 하나가 시작하는 전체 응답 주기이며 여러 모델 단계와 도구 단계를 포함할 수 있습니다. | 생활 속 설명: 안내 창구에 요청 하나를 접수하면 최종 답을 내기 전 내부에서 여러 일을 처리할 수 있습니다. |
| Step | Turn 안에서 이루어지는 모델 요청 한 번과 그 뒤의 도구 호출입니다. | 생활 속 설명: 작업 체크리스트의 한 항목이며 Turn은 요청 전체입니다. |
| Plugin | 서비스, 이벤트, 도구, 화면 구성 요소, 다른 동작을 Harness에 추가하는 로드 가능한 소프트웨어 단위입니다. | 생활 속 설명: 공방에 추가하는 새 기계나 조작판입니다. |
| Profile | 함께 시작할 bundle, 플러그인, 설정 계층을 정하는 이름 있는 구성입니다. | 생활 속 설명: 일의 종류에 맞게 저장한 공방 설정입니다. DeepSeek Harness에는 web과 headless 템플릿이 있습니다. |
| Skill | 범위가 정해진 작업을 Agent에게 가르치는 재사용 가능한 지침과 보조 자료 묶음입니다. | 생활 속 설명: 검토된 작업 절차 카드입니다. 방법을 안내하지만 새 컴퓨터 권한을 몰래 주지는 않습니다. |
| Runtime | 작업이 실제로 실행되는 소프트웨어 프로세스, 의존성 버전, 설정, 운영 환경입니다. | 생활 속 설명: 조리법이 같아도 실제 주방은 다를 수 있습니다. 검증은 실제로 사용할 주방에서 해야 합니다. |
| Diff | 두 상태 사이에서 파일이나 문장이 어떻게 달라졌는지 구조적으로 보여 주는 비교이며, 그 자체로 어느 상태도 적용하지 않습니다. | 생활 속 설명: 바뀐 줄을 표시한 변경 전후 대조표입니다. diff를 읽는 것만으로 변경을 승인한 것은 아닙니다. |
| Hook | 정해진 이벤트 전후 또는 진행 중에 지정한 동작을 실행하도록 설정한 트리거입니다. | 생활 속 설명: 정해진 반응에 연결된 초인종과 같습니다. 코드를 실행할 수 있으므로 출처와 권한을 확인해야 합니다. |
| MCP | Model Context Protocol의 약자로, Agent나 Harness가 MCP server를 통해 외부 도구와 데이터에 연결하는 표준 방식입니다. | 생활 속 설명: 작업대와 다른 서비스를 잇는 표준 연결부입니다. 연결된다는 사실만으로 그 서비스를 신뢰할 수 있는 것은 아닙니다. |
| Cloud | 로컬 컴퓨터 밖에서 제공되며 자체 파일, 자격 증명, 네트워크, 보존, 과금 경계를 가진 원격 실행 환경입니다. | 생활 속 설명: 다른 건물에 빌린 작업실입니다. 일을 보내기 전에 열쇠, 보관, 비용, 정리 규칙을 확인해야 합니다. |
권한과 안전
| 개념 | 전문 설명 | 쉬운 예시 |
|---|---|---|
| Permission | 작업을 허용할지, 거부할지, 실행할 때 결정할지 설명하는 규칙입니다. | 생활 속 설명: 문에 붙은 출입 명단입니다. 조심하라는 문장만으로는 출입 통제가 되지 않습니다. |
| Approval | 특정 작업을 계속하기 전에 사람 또는 정책이 내리는 허용 결정입니다. | 생활 속 설명: 작업자가 잠긴 보관함 앞에서 멈춰 열쇠를 써도 되는지 묻습니다. |
| Sandbox | 프로세스가 일으키는 영향 일부를 제한하는 기술 경계입니다. 범위는 플랫폼과 설정에 따라 다릅니다. | 생활 속 설명: 울타리가 있는 작업 구역입니다. 파일, 네트워크, 프로세스 중 어디까지 막는지 확인해야 합니다. |
| Credential | 모델 서비스, 저장소, 보호된 시스템에서 신원을 확인하는 비밀 또는 식별 토큰입니다. | 생활 속 설명: 열쇠나 은행 카드입니다. 전용 설정이나 비밀 저장소에 두고 채팅이나 프로젝트 파일에 쓰지 않습니다. |
| 최소 권한 | 현재 작업에 필요한 접근만 필요한 시간 동안 부여하는 원칙입니다. | 생활 속 설명: 방문객에게 회의실 열쇠만 주고 건물 전체의 만능 열쇠는 주지 않습니다. |
| Rollback | 변경이 실패하거나 더 필요하지 않을 때 이전에 검증한 상태로 복구하는 준비된 작업입니다. | 생활 속 설명: 무언가 바꾸기 전에 이전 작동 버전과 돌아가는 방법을 저장해 둡니다. |
외관과 인터페이스
| 개념 | 전문 설명 | 쉬운 예시 |
|---|---|---|
| 시맨틱 토큰 | 고정 색 대신 배경이나 강조색처럼 용도로 이름을 붙인 디자인 값입니다. | 생활 속 설명: 「벽 색」이나 「경고등」 같은 용도 라벨입니다. Theme마다 같은 용도에 다른 색을 넣을 수 있습니다. |
| Theme | 제품 구조는 바꾸지 않고 보통 light와 dark 모드를 함께 다루는 일관된 외관 값 묶음입니다. | 생활 속 설명: 벽과 가구 자리는 그대로 두고 방의 색과 조명 계획을 바꿉니다. |
| Full Skin | 더 엄격한 증거 규칙 아래 시맨틱 값, 관리된 이미지, 생성 스타일을 결합하는 DSH Themes 게시 유형입니다. | 생활 속 설명: 색, 조명, 일부 장식을 바꿉니다. DSH Themes 형식이며 DeepSeek Harness 공식 네이티브 형식은 아닙니다. |
| UI Extension | 외관 값만 주는 것이 아니라 화면의 작업 흐름을 바꾸거나 추가하는 확장입니다. | 생활 속 설명: 새 조작판이나 작업 공간을 더하므로 외관만큼 동작과 권한이 중요합니다. |
| Transport | Web 화면과 실행 중인 Harness 프로세스 사이에서 요청, 이벤트, 상태를 전달하는 연결입니다. | 생활 속 설명: 조정실과 공방을 잇는 배송 경로입니다. 화면이 보인다고 경로가 연결됐다는 뜻은 아닙니다. |
패키지와 검증
| 개념 | 전문 설명 | 쉬운 예시 |
|---|---|---|
| Package | 코드, 메타데이터, 리소스, 설정을 함께 설치하도록 묶은 버전 있는 배포 단위입니다. | 생활 속 설명: 밀봉된 상품 상자입니다. 진열대 이름만으로 이 상자의 실제 내용을 증명할 수 없습니다. |
| Artifact | 다운로드, 설치, 테스트, 게시 대상이 되는 정확한 빌드 파일입니다. | 생활 속 설명: 손에 도착한 실제 상자이며 카탈로그의 상품 설명이 아닙니다. |
| SHA-256 | 아티팩트의 모든 바이트에서 계산한 암호학적 다이제스트로 안정적인 파일 지문에 사용합니다. | 생활 속 설명: 지문이 같으면 파일 바이트가 같습니다. 다만 안전성이나 라이선스까지 증명하지는 않습니다. |
| Sidecar | 아티팩트 옆에 별도 파일로 두고 신원, 호환성, 해시, 증거 참조를 기록하는 기계 판독 정보입니다. | 생활 속 설명: 상자에 붙은 검사 카드입니다. 카드와 상자가 서로 맞아야 합니다. |
| Attestation | 무엇을 어떤 환경과 입력으로 확인했고 결과가 어땠는지 밝히는 서명 또는 관리된 기록입니다. | 생활 속 설명: 날짜와 대상이 적힌 검사 보고서입니다. 다른 버전 보고서는 지금 항목을 인증하지 못합니다. |
| 인증 기준 | 항목이 필요한 검증 절차를 완료했을 때 사용한 정확한 Harness 버전과 증거 묶음입니다. | 생활 속 설명: 업스트림은 새 버전이어도 검사 완료 버전은 더 오래될 수 있습니다. 최신과 인증 완료는 다릅니다. |
용어가 여전히 이해되지 않을 때
- 01
정확한 용어 찾기
제품 이름이 있다면 함께 포함해 화면에 적힌 단어를 그대로 복사합니다.
- 02
어느 계층인지 구분하기
지능, 작업 구성, 권한, 인터페이스, 검증 중 무엇을 설명하는지 확인합니다.
- 03
제품별 의미 확인하기
같은 단어도 DeepSeek Harness, Pi, Codex 같은 제품에서 더 좁은 뜻을 가질 수 있습니다.
- 04
위험한 작업 전 멈추기
접근, 자격 증명, 설치, 삭제와 관련되면 연결된 가이드나 공식 자료를 먼저 읽습니다.
찾은 개념에서 계속 배우기
공식 1차 문서 읽기
DeepSeek Harness v0.1.1-rc.2 릴리스이 가이드가 사용하는 업스트림 릴리스 태그와 소스 커밋을 확인합니다.DeepSeek Harness RC.2 README고정된 제품 정의, 개발자 프리뷰 경계 및 Web UI 실행 경로를 확인합니다.DeepSeek Harness RC.2 아키텍처고정된 플러그인, Profile, 번들, 도구 및 세션 모델을 확인합니다.DeepSeek Harness RC.2 Web UI 가이드고정된 모델 설정, 작업 공간 선택, 첫 작업 및 승인 동작을 확인합니다.DeepSeek Harness 권한 프리셋sandbox mode와 approval policy의 조합 및 실제 적용 경계를 확인합니다.DeepSeek Harness Skills 하위 시스템탐색, 공급자, 식별자, 로딩 및 호출 경계를 확인합니다.
일반 질문
변경하기 전에
형식, 호환성, 증거 및 롤백에 대한 답변
이 가이드에서는 무엇을 확인하나요?
이 가이드의 범위: DeepSeek Harness rc.2 아키텍처 및 Web UI 용어, DSH Themes 게시 및 외관 용어, 전문 정의와 짧은 생활 속 설명
무엇부터 시작해야 하나요?
이 용어를 외울 필요는 없습니다. 막히는 단어를 찾은 뒤 정확한 정의를 먼저 읽고, 생활 속 설명으로 익숙한 대상과 연결해 보세요.
가장 중요한 경계는 무엇인가요?
비유는 이해를 돕지만 제품의 정확한 동작을 대신하지 않습니다. 특히 권한, 샌드박스, 자격 증명, 호환성은 실제 설정과 검증 증거를 확인하세요.
학습 계속하기
확인된 증거에서 계속하기
공개된 아티팩트를 비교하거나 설치 문서로 돌아가세요.