mirror of
https://gitea.toothfairyai.com/ToothFairyAI/tf_code.git
synced 2026-04-12 19:59:00 +00:00
fix(docs): locale translations for nav elements and headings
This commit is contained in:
@@ -1,136 +1,135 @@
|
||||
---
|
||||
title: Agents
|
||||
description: Configure and use specialized agents.
|
||||
title: 에이전트
|
||||
description: 전문 에이전트를 구성하고 사용하세요.
|
||||
---
|
||||
|
||||
에이전트는 특정 작업과 워크플로우를 구성할 수 있는 AI 보조를 전문으로 합니다. 사용자 정의 프롬프트, 모델 및 도구 액세스와 초점을 맞춘 도구를 만들 수 있습니다.
|
||||
에이전트는 특정 작업과 워크플로우를 전문으로 하는 구성 가능한 AI 보조자입니다. 사용자 정의 프롬프트, 모델, 도구 액세스로 집중된 도구를 만들 수 있습니다.
|
||||
|
||||
:::tip
|
||||
코드를 분석하고 코드 변경없이 제안을 검토 할 계획 에이전트를 사용합니다.
|
||||
코드 변경 없이 제안을 검토할 때는 Plan 에이전트를 사용하세요.
|
||||
:::
|
||||
|
||||
세션 중에 에이전트를 전환하거나 `@` 언급으로 호출 할 수 있습니다.
|
||||
세션 중에 에이전트를 전환하거나 `@` 멘션으로 호출할 수 있습니다.
|
||||
|
||||
---
|
||||
|
||||
## 유형
|
||||
|
||||
OpenCode의 두 가지 유형이 있습니다; 기본 에이전트와 subagents.
|
||||
OpenCode에는 두 가지 유형의 에이전트가 있습니다: 기본 에이전트(Primary Agent)와 서브 에이전트(Subagent).
|
||||
|
||||
---
|
||||
|
||||
### 주요 에이전트
|
||||
### 기본 에이전트
|
||||
|
||||
주요 에이전트은 당신이 직접 상호 작용하는 주요 조수입니다. **Tab** 키 또는 설정된 `switch_agent` keybind를 사용하여 주기 할 수 있습니다. 이 에이전트은 당신의 주요 대화를 취급합니다. 도구 액세스는 권한을 통해 구성된다 — 예를 들어, Build는 Plan이 제한되는 동안 모든 도구를 사용할 수 있습니다.
|
||||
기본 에이전트는 사용자가 직접 상호 작용하는 주요 보조자입니다. **Tab** 키 또는 설정된 `switch_agent` 키바인드를 사용하여 순환할 수 있습니다. 이 에이전트는 주요 대화를 처리합니다. 도구 액세스는 권한을 통해 구성됩니다 — 예를 들어, Build는 모든 도구를 사용할 수 있지만 Plan은 제한됩니다.
|
||||
|
||||
:::tip
|
||||
세션 중에 기본 에이전트를 전환하는 **Tab** 키를 사용할 수 있습니다.
|
||||
세션 중에 **Tab** 키를 사용하여 기본 에이전트를 전환할 수 있습니다.
|
||||
:::
|
||||
|
||||
OpenCode는 두 개의 내장 기본 에이전트, **Build** 및 **Plan**와 함께 제공됩니다. 우리는
|
||||
아래에서 보기.
|
||||
OpenCode는 두 가지 내장 기본 에이전트, **Build** 및 **Plan**을 제공합니다. 아래에서 자세히 살펴봅니다.
|
||||
|
||||
---
|
||||
|
||||
### Subagents
|
||||
### 서브 에이전트
|
||||
|
||||
Subagents는 기본 에이전트가 특정 작업을 위해 호출 할 수있는 전문 보조입니다. 또한 수동으로 그들을 호출 할 수 있습니다 ** @ 언급 ** 메시지에서 그들.
|
||||
서브 에이전트는 기본 에이전트가 특정 작업을 위해 호출할 수 있는 전문 보조자입니다. 또한 메시지에서 **@멘션**을 통해 수동으로 호출할 수도 있습니다.
|
||||
|
||||
OpenCode는 두 개의 내장 subagents, **General** 및 **Explore**. 아래에서 볼 수 있습니다.
|
||||
OpenCode는 두 가지 내장 서브 에이전트, **General** 및 **Explore**를 제공합니다. 아래에서 자세히 살펴봅니다.
|
||||
|
||||
---
|
||||
|
||||
## 내장
|
||||
## 기본 제공
|
||||
|
||||
OpenCode는 기본 에이전트와 두 개의 내장 subagents로 제공됩니다.
|
||||
OpenCode는 기본 에이전트와 두 개의 내장 서브 에이전트를 제공합니다.
|
||||
|
||||
---
|
||||
|
||||
### 사용 Build
|
||||
### Build
|
||||
|
||||
_모드_: `primary`
|
||||
|
||||
Build는 **default** 모든 도구가 활성화된 기본 에이전트입니다. 이것은 당신이 파일 가동 및 체계 명령에 가득 차있는 접근을 필요로 하는 발달 일을 위한 표준 에이전트입니다.
|
||||
Build는 모든 도구가 활성화된 **기본** 에이전트입니다. 파일 조작 및 시스템 명령에 대한 전체 액세스가 필요한 개발 작업을 위한 표준 에이전트입니다.
|
||||
|
||||
---
|
||||
|
||||
### 사용 Plan
|
||||
### Plan
|
||||
|
||||
_모드_: `primary`
|
||||
|
||||
계획 및 분석을 위해 설계된 제한된 에이전트. 우리는 더 많은 통제를 주고 무인화한 변화를 방지하기 위하여 허가 체계를 이용합니다.
|
||||
기본적으로, 뒤에 오는 전부는 `ask`로 놓입니다:
|
||||
계획 및 분석을 위해 설계된 제한된 에이전트입니다. 더 많은 제어권을 부여하고 의도하지 않은 변경을 방지하기 위해 권한 시스템을 사용합니다.
|
||||
기본적으로 다음은 모두 `ask`로 설정됩니다:
|
||||
|
||||
- `file edits`: 모든 쓰기, 패치 및 편집
|
||||
- `bash`: 모든 bash 명령
|
||||
|
||||
이 에이전트는 코드를 분석 할 LLM을 원할 때 유용합니다, 변경을 제안하거나 코드베이스에 실제 수정없이 계획을 만들 수 있습니다.
|
||||
이 에이전트는 코드를 분석하거나 변경을 제안받고 싶지만, 코드베이스에 실제 수정 없이 계획만 만들고 싶을 때 유용합니다.
|
||||
|
||||
---
|
||||
|
||||
### 사용 General
|
||||
### General
|
||||
|
||||
_모드_: `subagent`
|
||||
|
||||
복잡한 질문을 연구하고 다중 단계 작업을 실행하기위한 범용 에이전트. 전체 도구 액세스 (todo 제외), 그래서 필요할 때 파일 변경을 만들 수 있습니다. 평행한에 있는 일의 다수 단위를 달리기 위하여 이것을 사용하십시오.
|
||||
복잡한 질문을 연구하고 다단계 작업을 실행하기 위한 범용 에이전트입니다. 전체 도구 액세스(todo 제외)를 가지므로 필요할 때 파일 변경을 수행할 수 있습니다. 여러 단위의 작업을 병렬로 실행할 때 사용하세요.
|
||||
|
||||
---
|
||||
|
||||
### 사용 Explore
|
||||
### Explore
|
||||
|
||||
_모드_: `subagent`
|
||||
|
||||
Codebases를 탐구하는 빠르고, 읽기 전용 에이전트. 파일을 수정할 수 없습니다. 이 작업을 사용하면 패턴, 키워드 검색 코드, 또는 codebase에 대한 질문에 신속하게 파일을 찾을 수 있습니다.
|
||||
코드베이스를 탐색하는 빠르고 읽기 전용인 에이전트입니다. 파일을 수정할 수 없습니다. 패턴, 키워드로 코드를 검색하거나 코드베이스에 대한 질문에 답하기 위해 파일을 빠르게 찾아야 할 때 사용하세요.
|
||||
|
||||
---
|
||||
|
||||
### 사용 Compaction
|
||||
### Compaction
|
||||
|
||||
_모드_: `primary`
|
||||
|
||||
더 작은 요약으로 긴 맥락을 압축하는 숨겨진 시스템 에이전트. 필요한 경우 자동으로 실행되며 UI에서 선택할 수 없습니다.
|
||||
긴 컨텍스트를 작은 요약으로 압축하는 숨겨진 시스템 에이전트입니다. 필요한 경우 자동으로 실행되며 UI에서 선택할 수 없습니다.
|
||||
|
||||
---
|
||||
|
||||
### 사용 Title
|
||||
### Title
|
||||
|
||||
_모드_: `primary`
|
||||
|
||||
짧은 세션 타이틀을 생성하는 숨겨진 시스템 에이전트. 그것은 자동으로 실행하고 UI에서 선택할 수 없습니다.
|
||||
짧은 세션 제목을 생성하는 숨겨진 시스템 에이전트입니다. 자동으로 실행되며 UI에서 선택할 수 없습니다.
|
||||
|
||||
---
|
||||
|
||||
### 사용 Summary
|
||||
### Summary
|
||||
|
||||
_모드_: `primary`
|
||||
|
||||
세션 summaries를 만드는 숨겨진 시스템 에이전트. 그것은 자동으로 실행하고 UI에서 선택할 수 없습니다.
|
||||
세션 요약을 만드는 숨겨진 시스템 에이전트입니다. 자동으로 실행되며 UI에서 선택할 수 없습니다.
|
||||
|
||||
---
|
||||
|
||||
## 사용법
|
||||
|
||||
1. 주요 에이전트을 위해, **Tab ** 열쇠를 사용하여 세션 도중 주기. 구성 된 `switch_agent` keybind도 사용할 수 있습니다.
|
||||
1. 기본 에이전트의 경우, 세션 중에 **Tab** 키를 사용하여 순환합니다. 구성된 `switch_agent` 키바인드도 사용할 수 있습니다.
|
||||
|
||||
2. Subagents은 invoked 일 수 있습니다:
|
||||
- **Automatically** 그들의 설명에 근거를 둔 특화된 업무를 위한 주요 에이전트에 의하여.
|
||||
- 메시지에 대한 subagents\*\*. 예를 들어.
|
||||
2. 서브 에이전트는 다음과 같이 호출할 수 있습니다:
|
||||
- 설명에 근거하여 전문적인 작업을 위해 기본 에이전트에 의해 **자동으로** 호출됨.
|
||||
- 메시지에서 서브 에이전트를 **@멘션**. 예를 들어:
|
||||
|
||||
```txt frame="none"
|
||||
@general help me search for this function
|
||||
```
|
||||
|
||||
3. ** 세션 간의 편차 **: subagents는 자신의 자녀 세션을 만들 때, 부모 세션과 모든 어린이 세션을 사용하여 탐색 할 수 있습니다.
|
||||
- **\<Leader>+Right** (또는 부모 → Child1 → Child2 →를 통해 전달하기 위해 설정된 `session_child_cycle` keybind)
|
||||
- **\<Leader>+Left** (또는 `session_child_cycle_reverse` keybind) 부모를 통해 돌아 가기 위해 ← child1 ← child2 ← ... ← 부모
|
||||
3. **세션 간 이동**: 서브 에이전트가 자체 자식 세션을 만들 때, 부모 세션과 자식 세션 간을 탐색할 수 있습니다.
|
||||
- **\<Leader>+Right** (또는 부모 → 자식1 → 자식2 순으로 이동하기 위해 설정된 `session_child_cycle` 키바인드)
|
||||
- **\<Leader>+Left** (또는 `session_child_cycle_reverse` 키바인드) 부모 방향으로 되돌아가기: 자식2 → 자식1 → 부모
|
||||
|
||||
이로 인해 주요 대화와 특이한 subagent 작업을 원활하게 전환할 수 있습니다.
|
||||
이를 통해 주요 대화와 전문적인 서브 에이전트 작업 간을 원활하게 전환할 수 있습니다.
|
||||
|
||||
---
|
||||
|
||||
## 구성
|
||||
|
||||
내장 에이전트를 사용자 정의하거나 구성을 통해 자신의 만들 수 있습니다. 에이전트는 두 가지 방법으로 구성 될 수 있습니다:
|
||||
내장 에이전트를 사용자 정의하거나 구성을 통해 자신만의 에이전트를 만들 수 있습니다. 에이전트는 두 가지 방법으로 구성될 수 있습니다:
|
||||
|
||||
---
|
||||
|
||||
@@ -212,13 +211,13 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m
|
||||
|
||||
## 옵션
|
||||
|
||||
이 구성 옵션을 자세히 살펴봅시다.
|
||||
이 구성 옵션들을 자세히 살펴봅시다.
|
||||
|
||||
---
|
||||
|
||||
### 묘사
|
||||
### 설명
|
||||
|
||||
`description` 옵션을 사용하여 에이전트가 작동하고 사용할 때의 간단한 설명을 제공합니다.
|
||||
`description` 옵션을 사용하여 에이전트가 무엇을 하고 언제 사용해야 하는지에 대한 간단한 설명을 제공합니다.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -230,15 +229,15 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m
|
||||
}
|
||||
```
|
||||
|
||||
\*\* config 옵션이 필요합니다.
|
||||
\*\* 필수 구성 옵션입니다.
|
||||
|
||||
---
|
||||
|
||||
### 온도
|
||||
|
||||
`temperature` config와 LLM의 응답의 임의성과 창의성을 제어합니다.
|
||||
`temperature` 구성으로 LLM 응답의 무작위성과 창의성을 제어합니다.
|
||||
|
||||
더 낮은 값은 더 집중하고 세심한 응답을 만듭니다. 더 높은 값은 창의력과 가변성을 증가하면서.
|
||||
값이 낮을수록 더 집중되고 결정적인 응답을 생성하며, 값이 높을수록 창의성과 가변성이 증가합니다.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -253,10 +252,11 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m
|
||||
}
|
||||
```
|
||||
|
||||
온도 값은 일반적으로 0.0에서 1.0에 배열합니다:
|
||||
온도 값은 일반적으로 0.0에서 1.0 사이입니다:
|
||||
|
||||
- **0.0-0.2**: 매우 집중하고 신중한 응답, 코드 분석 및 계획에 이상 -**0.3-0.5**: 일부 창의력과 균형 잡힌 응답, 일반 개발 작업에 좋은
|
||||
- **0.6-1.0**: 더 창조적이고 다양한 응답, 뇌하수 및 탐험에 유용한
|
||||
- **0.0-0.2**: 매우 집중되고 신중한 응답, 코드 분석 및 계획에 이상적
|
||||
- **0.3-0.5**: 창의성과 정확성의 균형, 일반 개발 작업에 좋음
|
||||
- **0.6-1.0**: 더 창의적이고 다양한 응답, 브레인스토밍 및 탐색에 유용함
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -276,15 +276,15 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m
|
||||
}
|
||||
```
|
||||
|
||||
온도가 지정되지 않은 경우, opencode는 모델 별 기본을 사용합니다. 일반적으로 대부분의 모델의 경우 0, Qwen 모델의 경우 0.55.
|
||||
온도가 지정되지 않은 경우, OpenCode는 모델별 기본값을 사용합니다. 일반적으로 대부분의 모델은 0, Qwen 모델의 경우 0.55입니다.
|
||||
|
||||
---
|
||||
|
||||
## 최대 단계
|
||||
|
||||
에이전트의 최대 수를 통제하는 에이전트은 원본과 반응하기 전에 실행할 수 있습니다. 이 사용자는 에이전트 행동에 제한을 설정하는 비용을 제어 할 수 있습니다.
|
||||
에이전트가 중지하고 사용자와 다시 상호 작용하기 전에 실행할 수 있는 최대 단계 수를 제어합니다. 이를 통해 에이전트의 행동과 비용을 제어할 수 있습니다.
|
||||
|
||||
이 설정되지 않은 경우, 에이전트는 모델이 중지하거나 사용자가 세션을 중단하도록 선택할 때까지 계속됩니다.
|
||||
설정되지 않은 경우, 에이전트는 모델이 중지하거나 사용자가 세션을 중단할 때까지 계속됩니다.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -298,17 +298,17 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m
|
||||
}
|
||||
```
|
||||
|
||||
제한이 도달되면, 에이전트는 특별한 시스템을 신속하게 작업의 요약과 권장되는 나머지 작업에 응답하도록 지시합니다.
|
||||
제한에 도달하면, 에이전트는 작업 요약과 권장되는 남은 작업을 신속하게 응답하도록 지시받습니다.
|
||||
|
||||
:::caution
|
||||
레거시 `maxSteps` 필드는 deprecated. 대신 `steps`를 사용하십시오.
|
||||
레거시 `maxSteps` 필드는 더 이상 사용되지 않습니다. 대신 `steps`를 사용하십시오.
|
||||
:::
|
||||
|
||||
---
|
||||
|
||||
#### 비활성화
|
||||
|
||||
`true`로 에이전트를 비활성화합니다.
|
||||
`true`로 설정하여 에이전트를 비활성화합니다.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -324,7 +324,7 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m
|
||||
|
||||
#### 프롬프트
|
||||
|
||||
`prompt` config를 가진 이 에이전트을 위한 주문 체계 prompt 파일을 지정하십시오. prompt 파일은 에이전트의 목적에 따라 지시를 포함해야합니다.
|
||||
`prompt` 구성으로 이 에이전트를 위한 사용자 정의 시스템 프롬프트 파일을 지정하십시오. 프롬프트 파일은 에이전트의 목적에 따른 지시를 포함해야 합니다.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -336,16 +336,16 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m
|
||||
}
|
||||
```
|
||||
|
||||
이 경로는 config 파일이 있는 곳에 관계됩니다. 그래서 이것은 글로벌 opencode 구성과 프로젝트 특정 구성 모두를 위해 작동합니다.
|
||||
이 경로는 구성 파일이 있는 위치를 기준으로 합니다. 따라서 글로벌 OpenCode 구성과 프로젝트별 구성 모두에서 작동합니다.
|
||||
|
||||
---
|
||||
|
||||
### 모형
|
||||
### 모델
|
||||
|
||||
`model` config를 사용하여이 에이전트에 대한 모델을 삭제합니다. 다른 작업에 최적화 된 다른 모델을 사용하는 데 유용합니다. 예를 들어, 계획을위한 빠른 모델, 구현을위한 더 많은 모델.
|
||||
`model` 구성을 사용하여 이 에이전트에 대한 모델을 재정의합니다. 다른 작업에 최적화된 다른 모델을 사용하는 데 유용합니다. 예를 들어, 계획을 위한 빠른 모델, 구현을 위한 더 강력한 모델 등입니다.
|
||||
|
||||
:::tip
|
||||
모델을 지정하지 않는 경우, 기본 에이전트는 [model globallyconfig](/docs/config#models)를 사용하며, subagents는 subagent를 호출하는 1차 에이전트의 모델을 사용합니다.
|
||||
모델을 지정하지 않는 경우, 기본 에이전트는 [전역 구성 모델](/docs/config#models)을 사용하며, 서브 에이전트는 자신을 호출한 기본 에이전트의 모델을 사용합니다.
|
||||
:::
|
||||
|
||||
```json title="opencode.json"
|
||||
@@ -358,13 +358,13 @@ markdown 파일 이름은 에이전트 이름입니다. 예를 들어, `review.m
|
||||
}
|
||||
```
|
||||
|
||||
opencode config의 모델 ID는 `provider/model-id` 형식을 사용합니다. 예를 들어, [OpenCode Zen](/docs/zen)을 사용한다면, GPT 5.1 Codex에 `opencode/gpt-5.1-codex`를 사용할 수 있습니다.
|
||||
OpenCode 구성의 모델 ID는 `provider/model-id` 형식을 사용합니다. 예를 들어, [OpenCode Zen](/docs/zen)을 사용한다면, GPT 5.1 Codex에 `opencode/gpt-5.1-codex`를 사용할 수 있습니다.
|
||||
|
||||
---
|
||||
|
||||
## 도구
|
||||
|
||||
`tools` config로 이 에이전트에서 사용할 수있는 제어. `true` 또는 `false`로 설정하여 특정 도구를 활성화하거나 비활성화 할 수 있습니다.
|
||||
`tools` 구성으로 이 에이전트가 사용할 수 있는 도구를 제어합니다. `true` 또는 `false`로 설정하여 특정 도구를 활성화하거나 비활성화할 수 있습니다.
|
||||
|
||||
```json title="opencode.json" {3-6,9-12}
|
||||
{
|
||||
@@ -385,10 +385,10 @@ opencode config의 모델 ID는 `provider/model-id` 형식을 사용합니다.
|
||||
```
|
||||
|
||||
:::note
|
||||
에이전트 별 구성 overrides 글로벌 구성.
|
||||
에이전트별 구성은 글로벌 구성을 덮어씁니다.
|
||||
:::
|
||||
|
||||
한 번에 여러 도구를 제어 할 와일드 카드를 사용할 수 있습니다. 예를 들어, MCP 서버에서 모든 도구를 비활성화하려면:
|
||||
한 번에 여러 도구를 제어하기 위해 와일드카드를 사용할 수 있습니다. 예를 들어, MCP 서버에서 모든 도구를 비활성화하려면:
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -405,16 +405,16 @@ opencode config의 모델 ID는 `provider/model-id` 형식을 사용합니다.
|
||||
}
|
||||
```
|
||||
|
||||
[공구에 대해 더 알아보기](/docs/tools).
|
||||
[도구에 대해 더 알아보기](/docs/tools).
|
||||
|
||||
---
|
||||
|
||||
## # 권한
|
||||
## 권한
|
||||
|
||||
에이전트가 수행 할 수있는 작업을 관리 할 수있는 권한을 구성 할 수 있습니다. 현재 `edit`, `bash` 및 `webfetch` 도구에 대한 권한은 다음과 같습니다.
|
||||
에이전트가 수행할 수 있는 작업을 관리할 수 있는 권한을 구성할 수 있습니다. 현재 `edit`, `bash` 및 `webfetch` 도구에 대한 권한은 다음과 같습니다.
|
||||
|
||||
- `"ask"` - 도구 실행하기 전에 승인을위한 Prompt
|
||||
- `"allow"` - 승인없이 모든 작업을 허용
|
||||
- `"ask"` - 도구를 실행하기 전에 승인 요청
|
||||
- `"allow"` - 승인 없이 모든 작업 허용
|
||||
- `"deny"` - 도구 비활성화
|
||||
|
||||
```json title="opencode.json"
|
||||
@@ -426,7 +426,7 @@ opencode config의 모델 ID는 `provider/model-id` 형식을 사용합니다.
|
||||
}
|
||||
```
|
||||
|
||||
당신은 에이전트 당이 허가를 override 할 수 있습니다.
|
||||
에이전트별로 이 권한을 재정의(override)할 수 있습니다.
|
||||
|
||||
```json title="opencode.json" {3-5,8-10}
|
||||
{
|
||||
@@ -444,7 +444,7 @@ opencode config의 모델 ID는 `provider/model-id` 형식을 사용합니다.
|
||||
}
|
||||
```
|
||||
|
||||
Markdown 에이전트에서 권한을 설정할 수 있습니다.
|
||||
Markdown 에이전트에서도 권한을 설정할 수 있습니다.
|
||||
|
||||
```markdown title="~/.config/opencode/agents/review.md"
|
||||
---
|
||||
@@ -481,7 +481,7 @@ Only analyze code and suggest changes.
|
||||
}
|
||||
```
|
||||
|
||||
이것은 glob 본을 가지고 갈 수 있습니다.
|
||||
이것은 glob 패턴을 사용할 수 있습니다.
|
||||
|
||||
```json title="opencode.json" {7}
|
||||
{
|
||||
@@ -498,8 +498,8 @@ Only analyze code and suggest changes.
|
||||
}
|
||||
```
|
||||
|
||||
또한 `*` 와일드 카드를 사용하여 모든 명령에 대한 권한을 관리 할 수 있습니다.
|
||||
마지막 일치 규칙이 우선적으로 걸리기 때문에, `*` 와일드카드를 첫번째로 두고 특정 규칙을 후에 두십시오.
|
||||
또한 `*` 와일드카드를 사용하여 모든 명령에 대한 권한을 관리할 수 있습니다.
|
||||
마지막 일치 규칙이 우선하므로, `*` 와일드카드를 먼저 두고 특정 규칙을 나중에 두십시오.
|
||||
|
||||
```json title="opencode.json" {8}
|
||||
{
|
||||
@@ -517,13 +517,13 @@ Only analyze code and suggest changes.
|
||||
}
|
||||
```
|
||||
|
||||
[허가에 대해 더 알아보기](/docs/permissions).
|
||||
[권한에 대해 더 알아보기](/docs/permissions).
|
||||
|
||||
---
|
||||
|
||||
### 형태
|
||||
### 모드
|
||||
|
||||
`mode` config로 에이전트 모드를 제어합니다. `mode` 선택권은 에이전트이 사용될 수 있는 방법을 결정하기 위하여 이용됩니다.
|
||||
`mode` 구성으로 에이전트 모드를 제어합니다. `mode` 옵션은 에이전트가 어떻게 사용될 수 있는지 결정하는 데 사용됩니다.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -535,13 +535,13 @@ Only analyze code and suggest changes.
|
||||
}
|
||||
```
|
||||
|
||||
`mode` 선택권은 `primary`, `subagent`, 또는 `all`에 놓일 수 있습니다. `mode`가 지정되지 않은 경우 `all`로 기본값입니다.
|
||||
`mode` 옵션은 `primary`, `subagent`, 또는 `all`로 설정할 수 있습니다. `mode`가 지정되지 않은 경우 `all`이 기본값입니다.
|
||||
|
||||
---
|
||||
|
||||
## #숨겨진
|
||||
## 숨김
|
||||
|
||||
`@`를 사용해 `hidden: true` 자동 완성 메뉴에서 시약을 숨깁니다. 작업 도구를 통해 다른 에이전트에 의해 invoked programmatically 있어야하는 내부 시약에 유용합니다.
|
||||
`hidden: true`를 사용하여 `@` 자동 완성 메뉴에서 에이전트를 숨깁니다. 작업 도구를 통해 다른 에이전트에 의해 프로그래밍 방식으로 호출되어야 하는 내부 에이전트에 유용합니다.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -554,17 +554,17 @@ Only analyze code and suggest changes.
|
||||
}
|
||||
```
|
||||
|
||||
자동 완성 메뉴의 사용자 가시에만 영향을 미칩니다. 숨겨진 에이전트는 여전히 작업 도구를 통해 모델에 의해 호출 될 수 있습니다 권한 허용.
|
||||
자동 완성 메뉴의 사용자 가시성에만 영향을 미칩니다. 숨겨진 에이전트는 권한이 허용된다면 여전히 작업 도구를 통해 모델에 의해 호출될 수 있습니다.
|
||||
|
||||
:::note
|
||||
`mode: subagent` 에이전트에서만 적용합니다.
|
||||
`mode: subagent` 에이전트에만 적용됩니다.
|
||||
:::
|
||||
|
||||
---
|
||||
|
||||
## 작업 권한
|
||||
|
||||
에이전트가 `permission.task`와 작업 도구를 통해 호출 할 수있는 제어. 유연한 일치를 위한 glob 본을 사용합니다.
|
||||
`permission.task`와 작업 도구를 통해 에이전트가 호출할 수 있는 서브 에이전트를 제어합니다. 유연한 일치를 위한 glob 패턴을 사용합니다.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -583,23 +583,23 @@ Only analyze code and suggest changes.
|
||||
}
|
||||
```
|
||||
|
||||
`deny`로 설정할 때, Subagent는 작업 도구 설명에서 완전히 제거됩니다. 그래서 모델은 그것을 호출하려고하지 않습니다.
|
||||
`deny`로 설정할 때, 서브 에이전트는 작업 도구 설명에서 완전히 제거됩니다. 따라서 모델은 그것을 호출하려고 시도하지 않습니다.
|
||||
|
||||
:::tip
|
||||
규칙은 순서로 평가되고, **마지막 일치 규칙은**를 이깁니다. 위의 예에서 `orchestrator-planner`는 `*` (deny)와 `orchestrator-*` (allow) 모두 일치하지만 `orchestrator-*`가 `*` 후 제공되므로 결과는 `allow`입니다.
|
||||
규칙은 순서대로 평가되며, **마지막 일치 규칙**이 우선합니다. 위의 예에서 `orchestrator-planner`는 `*` (deny)와 `orchestrator-*` (allow) 모두 일치하지만 `orchestrator-*`가 `*` 뒤에 오므로 결과는 `allow`입니다.
|
||||
:::
|
||||
|
||||
:::tip
|
||||
사용자는 `@` 자동 완성 메뉴를 통해 직접 어떤 subagent를 호출 할 수 있습니다. 에이전트의 작업 허가가 거부 할 경우에도.
|
||||
사용자는 에이전트의 작업 권한이 거부되더라도 `@` 자동 완성 메뉴를 통해 직접 어떤 서브 에이전트든 호출할 수 있습니다.
|
||||
:::
|
||||
|
||||
---
|
||||
|
||||
### 색깔
|
||||
### 색상
|
||||
|
||||
`color` 옵션과 UI에서 에이전트의 시각적 외관을 사용자 정의합니다. 이것은 어떻게 에이전트가 인터페이스에 나타납니다.
|
||||
`color` 옵션으로 UI에서 에이전트의 시각적 모양을 사용자 정의합니다.
|
||||
|
||||
유효한 hex 색깔을 사용하십시오 (예를들면, `#FF5733`) 또는 주제 색깔: `primary`, `secondary`, `accent`, `success`, `warning`, `error`, `info`.
|
||||
유효한 hex 색상(예: `#FF5733`) 또는 테마 색상을 사용하십시오: `primary`, `secondary`, `accent`, `success`, `warning`, `error`, `info`.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -616,9 +616,9 @@ Only analyze code and suggest changes.
|
||||
|
||||
---
|
||||
|
||||
### 정상 P
|
||||
### Top P
|
||||
|
||||
`top_p` 선택권을 가진 응답 다양성을 통제하십시오. 무작위 통제를 위한 온도에 대안.
|
||||
`top_p` 옵션으로 응답의 다양성을 제어합니다. 무작위성 제어를 위한 온도의 대안입니다.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -630,15 +630,15 @@ Only analyze code and suggest changes.
|
||||
}
|
||||
```
|
||||
|
||||
가치는 0.0에서 1.0에 배열합니다. 더 낮은 가치는 더 집중되고, 더 높은 가치는 더 다양합니다.
|
||||
값은 0.0에서 1.0 사이입니다. 낮은 값은 더 집중되고, 높은 값은 더 다양합니다.
|
||||
|
||||
---
|
||||
|
||||
### 추가
|
||||
### 추가 옵션
|
||||
|
||||
에이전트 구성에 지정하는 다른 옵션은 ** 직접 통과 ** 모델 옵션으로 공급자. 이 공급자 별 기능 및 매개 변수를 사용할 수 있습니다.
|
||||
에이전트 구성에 지정하는 다른 옵션은 모델 옵션으로 공급자에게 **직접 전달**됩니다. 이를 통해 공급자별 기능 및 매개변수를 사용할 수 있습니다.
|
||||
|
||||
예를 들어, OpenAI의 이유 모델과 함께, 당신은 이유를 제어 할 수 있습니다 노력:
|
||||
예를 들어, OpenAI의 추론 모델과 함께, 추론 노력을 제어할 수 있습니다:
|
||||
|
||||
```json title="opencode.json" {6,7}
|
||||
{
|
||||
@@ -653,7 +653,7 @@ Only analyze code and suggest changes.
|
||||
}
|
||||
```
|
||||
|
||||
이 추가 옵션은 모델과 공급자 별입니다. 공급자의 문서 확인 가능 매개 변수.
|
||||
이 추가 옵션은 모델과 공급자별로 다릅니다. 사용 가능한 매개변수는 공급자의 문서를 확인하십시오.
|
||||
|
||||
:::tip
|
||||
`opencode models`를 실행하여 사용 가능한 모델 목록을 볼 수 있습니다.
|
||||
@@ -669,25 +669,25 @@ Only analyze code and suggest changes.
|
||||
opencode agent create
|
||||
```
|
||||
|
||||
이 대화 형 명령은:
|
||||
이 대화형 명령은:
|
||||
|
||||
1. 에이전트을 저장하는 곳에게; 세계적인 프로젝트 별.
|
||||
2. 에이전트이 해야 하는 무슨의 묘사.
|
||||
3. 적절한 시스템 프롬프트 및 식별자를 생성한다.
|
||||
4. 당신은 에이전트이 접근할 수 있는 어떤 공구를 선정하자.
|
||||
5. 마지막으로, 에이전트 구성을 가진 markdown 파일을 창조하십시오.
|
||||
1. 에이전트를 저장할 위치를 묻습니다 (전역 또는 프로젝트별).
|
||||
2. 에이전트가 해야 할 일에 대한 설명을 묻습니다.
|
||||
3. 적절한 시스템 프롬프트 및 식별자를 생성합니다.
|
||||
4. 에이전트가 접근할 수 있는 도구를 선택하게 합니다.
|
||||
5. 마지막으로, 에이전트 구성을 가진 markdown 파일을 생성합니다.
|
||||
|
||||
---
|
||||
|
||||
## 사용 사례
|
||||
|
||||
다른 에이전트을 위한 몇몇 일반적인 사용 사례는 여기 있습니다.
|
||||
다른 에이전트를 위한 몇 가지 일반적인 사용 사례는 다음과 같습니다.
|
||||
|
||||
- **빌딩 에이전트**: 모든 도구와 함께 전체 개발 작업
|
||||
- ** 플랜 에이전트**: 변화없이 분석 및 계획
|
||||
- **리뷰 에이전트**: Code review with read-only access plus 문서 도구
|
||||
- ** 디버그 에이전트**: bash 및 읽기 도구와 함께 조사에 집중
|
||||
- **Docs 에이전트 **: 파일 작업과 문서 작성하지만 시스템 명령 없음
|
||||
- **Build Agent**: 모든 도구와 함께 전체 개발 작업
|
||||
- **Plan Agent**: 변경 없이 분석 및 계획
|
||||
- **Review Agent**: 읽기 전용 액세스 및 문서 도구와 함께 코드 리뷰
|
||||
- **Debug Agent**: bash 및 읽기 도구와 함께 조사에 집중
|
||||
- **Docs Agent**: 파일 작업과 문서 작성을 하지만 시스템 명령 없음
|
||||
|
||||
---
|
||||
|
||||
@@ -696,7 +696,7 @@ opencode agent create
|
||||
여기에 유용 할 수있는 몇 가지 예 에이전트가 있습니다.
|
||||
|
||||
:::tip
|
||||
당신은 공유하고 싶은 에이전트이 있습니까? [PR](https://github.com/anomalyco/opencode).
|
||||
공유하고 싶은 에이전트가 있습니까? [PR](https://github.com/anomalyco/opencode).
|
||||
:::
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user