clone/opencode
1
0
Fork 0
mirror of https://github.com/anomalyco/opencode.git synced 2026-05-02 18:57:08 +00:00
Code Issues Packages Projects Releases Wiki Activity

chore: generate

Browse Source
This commit is contained in:
opencode-agent[bot]
2026-02-09 17:35:30 +00:00
parent dc53086c1e
commit d578f80f00
222 changed files with 6797 additions and 6590 deletions
Download Patch File Download Diff File Expand all files Collapse all files

132
packages/web/src/content/docs/bs/agents.mdx
View File

@@ -10,11 +10,15 @@ Koristite agenta plana za analizu koda i pregled prijedloga bez ikakvih promjena
Možete se prebacivati ​​između agenata tokom sesije ili ih pozvati spominjanjem `@`.
---
## Vrsta
Postoje dvije vrste agenata u OpenCode-u; primarni agensi i subagensi.
---
### Primarni agenti
Primarni agenti su glavni pomoćnici s kojima direktno komunicirate. Možete se kretati kroz njih pomoću tipke **Tab** ili vašeg konfigurisanog povezivanja tipki `switch_agent`. Ovi agenti vode vaš glavni razgovor. Pristup alatima se konfiguriše putem dozvola — na primjer, Build ima omogućene sve alate dok je Plan ograničen.
::: tip
Možete koristiti tipku **Tab** za prebacivanje između primarnih agenata tokom sesije.
@@ -23,78 +27,103 @@ OpenCode dolazi sa dva ugrađena primarna agenta, **Build** i **Plan**. Hoćemo
pogledajte ove u nastavku.
---
### Subagent
Subagenti su specijalizovani pomoćnici koje primarni agenti mogu pozvati za određene zadatke. Možete ih i ručno pozvati **@ spominjanjem** u svojim porukama.
OpenCode dolazi sa dva ugrađena subagenta, **General** i **Explore**. Ovo ćemo pogledati u nastavku.
---
## Embedded
OpenCode dolazi sa dva ugrađena primarna agenta i dva ugrađena subagenta.
---
### Koristi build
_Način_: `primary`
Build je **podrazumevani** primarni agent sa svim omogućenim alatima. Ovo je standardni agent za razvojni rad gdje vam je potreban pun pristup operacijama datoteka i sistemskim komandama.
---
### Koristite plan
_Način_: `primary`
Konačan agent dizajniran za planiranje i analizu. Koristimo sistem dozvola kako bismo vam pružili veću kontrolu i spriječili neželjene promjene.
Prema zadanim postavkama, sve sljedeće je postavljeno na `ask`:
- `file edits`: Sva upisivanja, zakrpe i uređivanja
- `bash`: Sve bash komande
Ovaj agent je koristan kada želite da LLM analizira kod, predloži promjene ili kreira planove bez stvarnih modifikacija vaše baze koda.
Ovaj agent je koristan kada želite da LLM analizira kod, predloži promjene ili kreira planove bez stvarnih modifikacija vaše baze koda.
---
### Upotreba općenito
_Način_: `subagent`
Agent opće namjene za istraživanje složenih pitanja i izvršavanje zadataka u više koraka. Ima potpuni pristup alatima (osim zadataka), tako da može mijenjati fajl kada je to potrebno. Koristite ovo za paralelno pokretanje više jedinica rada.
---
### Koristite explore
_Način_: `subagent`
Brzi agent samo za čitanje za istraživanje kodnih baza. Nije moguće mijenjati fajlove. Koristite ovo kada trebate brzo pronaći datoteke po uzorku, pretražiti kod za ključne riječi ili odgovoriti na pitanja o bazi kodova.
---
### Koristite zbijanje
_Način_: `primary`
Skriveni sistemski agent koji sažima dugi kontekst u manji sažetak. Pokreće se automatski kada je potrebno i ne može se odabrati u korisničkom interfejsu.
---
### Koristite naslov
_Način_: `primary`
Skriveni sistemski agent koji generiše kratke naslove sesija. Pokreće se automatski i ne može se odabrati u korisničkom interfejsu.
---
### Koristi sažetak
_Način_: `primary`
Skriveni sistemski agent koji kreira sažetke sesije. Pokreće se automatski i ne može se odabrati u korisničkom interfejsu.
---
## Upotreba
1. Za primarne agente, koristite taster **Tab** za kretanje kroz njih tokom sesije. Također možete koristiti svoju konfiguriranu vezu tipke `switch_agent`.
2. Subagenti se mogu pozvati:
- **Automatski** od strane primarnih agenata za specijalizovane zadatke na osnovu njihovih opisa.
- Ručno **@ spominjanjem** subagenta u vašoj poruci. Na primjer.
- Ručno **@ spominjanjem** subagenta u vašoj poruci. Na primjer.
```txt frame="none"
@general help me search for this function
@general help me search for this function
```
3. **Navigacija između sesija**: Kada subagenti kreiraju vlastite podređene sesije, možete se kretati između roditeljske sesije i svih podređenih sesija koristeći:
- **\<Leader>+Desno** (ili vaša konfigurirana `session_child_cycle` veza) za petlju naprijed kroz roditelj → dijete1 → dijete2 → ... → roditelj
- **\<Leader>+Levo** (ili vaše konfigurirano povezivanje tipki `session_child_cycle_reverse`) za kretanje unazad kroz roditelj ← dijete1 ← dijete2 ← ... ← roditelj
Ovo vam omogućava neprimetno prebacivanje između glavnog razgovora i rada specijalizovanog podagenta.
Ovo vam omogućava neprimetno prebacivanje između glavnog razgovora i rada specijalizovanog podagenta.
---
## Konfiguriši
Možete prilagoditi ugrađene agente ili kreirati vlastite kroz konfiguraciju. Agenti se mogu konfigurisati na dva načina:
---
### JSON
Konfigurirajte agente u svom konfiguracijskom fajlu `opencode.json`:
```json title="opencode.json"
@@ -137,12 +166,13 @@ Konfigurirajte agente u svom konfiguracijskom fajlu `opencode.json`:
---
### Markdown
Također možete definirati agente koristeći mardown datoteke. Stavite ih u:
- Globalno: `~/.config/opencode/agents/`
- Po projektu: `.opencode/agents/
````markdown title="~/.config/opencode/agents/review.md"
---
opis: Recenzira kod za kvalitet i najbolje prakse
način rada: subagent
@@ -152,17 +182,17 @@ alati:
napisati: netačno
edit: false
bash: lažno
---
Nalazite se u načinu pregleda koda. Fokusirajte se na:
- Kvalitet koda i najbolje prakse
- Potencijalne greške i rubni slučajevi
- Implikacije na performanse
- Sigurnosna pitanja
Dajte konstruktivne povratne informacije bez direktnih promjena.
Dajte konstruktivne povratne informacije bez direktnih promjena.
```
````
Ime marginalne datoteke postaje ime agenta. Na primjer, `review.md` kreira `review` agenta.
@@ -184,12 +214,14 @@ Koristite opciju `description` da pružite kratak opis onoga što agent radi i k
}
}
}
```
````
Ovo je **obavezna** opcija konfiguracije.
---
### Temperatura
Kontrolišite slučajnost i kreativnost odgovora LLM-a pomoću `temperature` konfiguracije.
Niže vrijednosti čine odgovore fokusiranijim i determinističkim, dok više vrijednosti povećavaju kreativnost i varijabilnost.
@@ -205,6 +237,7 @@ Niže vrijednosti čine odgovore fokusiranijim i determinističkim, dok više vr
```
Vrijednosti temperature se obično kreću od 0,0 do 1,0:
- **0,0-0,2**: Vrlo fokusirani i deterministički odgovori, idealni za analizu i planiranje koda
- **0,3-0,5**: Uravnoteženi odgovori sa malo kreativnosti, dobro za opšte razvojne zadatke
- **0,6-1,0**: kreativniji i raznovrsniji odgovori, korisni za razmišljanje i istraživanje
@@ -230,17 +263,20 @@ Vrijednosti temperature se obično kreću od 0,0 do 1,0:
Ako temperatura nije navedena, OpenCode koristi standardne postavke specifične za model; obično 0 za većinu modela, 0,55 za Qwen modele.
---
### Maks. stepenice
Kontrolirajte maksimalni broj iteracija agenta koje agent može izvesti prije nego što bude prisiljen da odgovori samo tekstom. Ovo omogućava korisnicima koji žele kontrolirati troškove da postave ograničenje na akcije agenta.
Ako ovo nije postavljeno, agent će nastaviti iterirati sve dok model ne odluči da se zaustavi ili korisnik ne prekine sesiju.
```json title="opencode.json"
{
"agent": {
"agent": {
"brzo mislilac": {
"opis": "Brzo razmišljanje s ograničenim iteracijama",
"prompt": "Vi brzo mislite. Riješite probleme minimalnim koracima.",
"koraci": 5 }
"koraci": 5
}
}
}
```
@@ -253,6 +289,7 @@ Naslijeđeno polje `maxSteps` je zastarjelo. Umjesto toga koristite `steps`.
---
### Onemogući
Postavite na `true` da onemogućite agenta.
```json title="opencode.json"
@@ -268,13 +305,15 @@ Postavite na `true` da onemogućite agenta.
---
### Prompt
Navedite prilagođenu sistemsku prompt datoteku za ovog agenta sa `prompt` konfiguracijom. Datoteka s promptom treba da sadrži upute specifične za svrhu agenta.
```json title="opencode.json"
{
"agent": {
"agent": {
"recenzija": {
"prompt": "{file:./prompts/code-review.txt}" }
"prompt": "{file:./prompts/code-review.txt}"
}
}
}
```
@@ -284,15 +323,18 @@ Ova putanja je relativna u odnosu na mjesto gdje se nalazi konfiguracijski fajl.
---
### Model
Koristite `model` konfiguraciju da nadjačate model za ovog agenta. Korisno za korištenje različitih modela optimiziranih za različite zadatke. Na primjer, brži model za planiranje, sposobniji model za implementaciju.
:::tip
Ako ne navedete model, primarni agenti koriste [model globalno konfiguriran](/docs/config#models) dok će podagenti koristiti model primarnog agenta koji je pozvao subagenta.
:::
```json title="opencode.json"
{
"agent": {
"agent": {
"plan": {
"model": "anthropic/claude-haiku-4-20250514" }
"model": "anthropic/claude-haiku-4-20250514"
}
}
}
```
@@ -302,6 +344,7 @@ ID modela u vašoj OpenCode konfiguraciji koristi format `provider/model-id`. Na
---
### Uvijek
Kontrolirajte koji su alati dostupni u ovom agentu koristeći konfiguraciju `tools`. Možete omogućiti ili onemogućiti određene alate tako što ćete ih postaviti na `true` ili `false`.
```json title="opencode.json" {3-6,9-12}
@@ -346,7 +389,9 @@ Također možete koristiti zamjenske znakove za kontrolu više alata odjednom. N
---
### Dozvole
Možete konfigurirati dozvole za upravljanje radnjama koje agent može poduzeti. Trenutno se dozvole za alate `edit`, `bash` i `webfetch` mogu konfigurirati na:
- `"ask"` — Zatražite odobrenje prije pokretanja alata
- `"allow"` — Dozvoli sve operacije bez odobrenja
- `"deny"` — Onemogućite alat
@@ -364,13 +409,15 @@ Možete nadjačati ove dozvole po agentu.
```json title="opencode.json" {3-5,8-10}
{
"$schema": "https://opencode.ai/config.json",
"$schema": "https://opencode.ai/config.json",
"dozvola": {
"edit": "odbiti" },
"agent": {
"edit": "odbiti"
},
"agent": {
"build": {
"dozvola": {
"uredi": "pitaj" }
"uredi": "pitaj"
}
}
}
}
@@ -399,13 +446,14 @@ Možete postaviti dozvole za određene bash komande.
```json title="opencode.json" {7}
{
"$schema": "https://opencode.ai/config.json",
"$schema": "https://opencode.ai/config.json",
"agent": {
"build": {
"dozvola": {
"bash": {
"git push": "pitaj",
"grep *": "dozvoli" }
"grep *": "dozvoli"
}
}
}
}
@@ -434,13 +482,14 @@ Budući da posljednje podudarno pravilo ima prednost, prvo postavite zamjenski z
```json title="opencode.json" {8}
{
"$schema": "https://opencode.ai/config.json",
"$schema": "https://opencode.ai/config.json",
"agent": {
"build": {
"dozvola": {
"bash": {
"*": "pitaj",
"git status *": "dozvoli" }
"git status *": "dozvoli"
}
}
}
}
@@ -452,6 +501,7 @@ Budući da posljednje podudarno pravilo ima prednost, prvo postavite zamjenski z
---
### Mode
Kontrolirajte način rada agenta koristeći konfiguraciju `mode`. Opcija `mode` se koristi da specificira kako se agent može koristiti.
```json title="opencode.json"
@@ -467,7 +517,9 @@ Kontrolirajte način rada agenta koristeći konfiguraciju `mode`. Opcija `mode`
Opcija `mode` se može postaviti na `primary`, `subagent` ili `all`. Ako `mode` nije specificirano, podrazumevano je `all`.
---
### Skriveno
Sakrij podagenta iz `@` menija za automatsko dovršavanje sa `hidden: true`. Korisno za interne podagente koje bi drugi agenti trebali programski pozvati samo preko Task alata.
```json title="opencode.json"
@@ -488,6 +540,7 @@ Odnosi se samo na `mode: subagent` agente.
---
### Dozvole za zadatak
Kontrolirajte koje podagente agent može pozvati preko Task alata sa `permission.task`. Koristi glob uzorke za fleksibilno uparivanje.
```json title="opencode.json"
@@ -509,7 +562,7 @@ Kontrolirajte koje podagente agent može pozvati preko Task alata sa `permission
Kada se postavi na `deny`, subagent se u potpunosti uklanja iz opisa alata za zadatak, tako da ga model neće pokušati pozvati.
:::tip
Pravila se procjenjuju po redoslijedu i **pobjeđuje **poslednje odgovarajuće pravilo**. U gornjem primjeru, `orchestrator-planner` odgovara i `*` (odbije) i `orchestrator-*` (dozvoli), ali pošto `orchestrator-*` dolazi nakon `*`, rezultat je `allow`.
Pravila se procjenjuju po redoslijedu i **pobjeđuje **poslednje odgovarajuće pravilo\*_. U gornjem primjeru, `orchestrator-planner` odgovara i `_`(odbije) i`orchestrator-_`(dozvoli), ali pošto`orchestrator-_`dolazi nakon`\*`, rezultat je `allow`.
:::
:::tip
Korisnici uvijek mogu pozvati bilo kojeg subagenta direktno preko `@` menija za autodovršavanje, čak i ako bi dozvole za zadatak agenta to uskratile.
@@ -518,16 +571,19 @@ Korisnici uvijek mogu pozvati bilo kojeg subagenta direktno preko `@` menija za
---
### Boja
Prilagodite vizualni izgled agenta u korisničkom sučelju s opcijom `color`. Ovo utiče na to kako se agent pojavljuje u interfejsu.
Koristite važeću heksadecimalnu boju (npr. `#FF5733`) ili boju teme: `primary`, `secondary`, `accent`, `success`, `warning`, `error`, `info`.
```json title="opencode.json"
{
"agent": {
"agent": {
"kreativno": {
"boja": "#ff6b6b" },
"code-reviewer": {
"boja": "akcent" }
"boja": "#ff6b6b"
},
"code-reviewer": {
"boja": "akcent"
}
}
}
```
@@ -535,6 +591,7 @@ Koristite važeću heksadecimalnu boju (npr. `#FF5733`) ili boju teme: `primary`
---
### Leglo P
Kontrolirajte raznolikost odgovora s opcijom `top_p`. Alternativa temperaturi za kontrolu nasumice.
```json title="opencode.json"
@@ -550,18 +607,21 @@ Kontrolirajte raznolikost odgovora s opcijom `top_p`. Alternativa temperaturi za
Vrijednosti se kreću od 0,0 do 1,0. Niže vrijednosti su više fokusirane, više vrijednosti raznovrsnije.
---
### Dodatni
Sve druge opcije koje navedete u konfiguraciji agenta će biti **direktno proslijeđene** dobavljaču kao opcije modela. Ovo vam omogućava da koristite karakteristike i parametre specifične za provajdera.
Na primjer, sa OpenAI-jevim modelima rezonovanja, možete kontrolisati napor rasuđivanja:
```json title="opencode.json" {6,7}
{
"agent": {
"agent": {
"duboki mislilac": {
"opis": "Agent koji koristi veliki napor u razmišljanju za složene probleme",
"model": "openai/gpt-5",
"reasoningEffort": "visoko",
"textVerbosity": "niska" }
"textVerbosity": "niska"
}
}
}
```
@@ -574,6 +634,7 @@ Pokrenite `opencode models` da vidite listu dostupnih modela.
---
## Kreirajte agente
Možete kreirati nove agente koristeći sljedeću naredbu:
```bash
@@ -581,6 +642,7 @@ opencode agent create
```
Ova interaktivna komanda će:
1. Pitajte gdje da sačuvate agenta; globalno ili specifično za projekat.
2. Opis onoga što agent treba da uradi.
3. Generirajte odgovarajući sistemski prompt i identifikator.
@@ -588,8 +650,11 @@ Ova interaktivna komanda će:
5. Konačno, kreirajte markdown datoteku s konfiguracijom agenta.
---
## Slučajevi upotrebe
Evo nekoliko uobičajenih slučajeva upotrebe različitih agenata.
- **Build agent**: Potpuni razvojni rad sa svim omogućenim alatima
- **Agent za plan**: Analiza i planiranje bez unošenja promjena
- **Agent za pregled**: Pregled koda sa pristupom samo za čitanje plus alati za dokumentaciju
@@ -597,7 +662,9 @@ Evo nekoliko uobičajenih slučajeva upotrebe različitih agenata.
- **Docs agent**: Pisanje dokumentacije sa operacijama datoteka, ali bez sistemskih naredbi
---
## Primjeri
Evo nekoliko primjera agenata koji bi vam mogli biti korisni.
::: momak
Imate li agenta kojeg biste željeli podijeliti? [Pošalji PR](https://github.com/anomalyco/opencode).
@@ -608,22 +675,20 @@ Imate li agenta kojeg biste željeli podijeliti? [Pošalji PR](https://github.co
### Agent za dokumentaciju
```markdown title="~/.config/opencode/agents/docs-writer.md"
---
opis: Piše i vodi projektnu dokumentaciju
način rada: subagent
alati:
bash: lažno
---
Vi ste tehnički pisac. Kreirajte jasnu, sveobuhvatnu dokumentaciju.
Fokusirajte se na:
- Jasna objašnjenja
- Pravilna struktura
- Primjeri kodova
- Jezik prilagođen korisniku
```
---
@@ -649,3 +714,4 @@ Look for:
- Dependency vulnerabilities
- Configuration security issues
```
````