tools.mdx 8.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379
  1. ---
  2. title: Værktøjer
  3. description: Administrer de værktøjer, en LLM kan bruge.
  4. ---
  5. Verktøy lar LLM utføre handlinger i kodebasen din. OpenCode kommer med et sett med innebygde verktøy, men du kan utvide det med [egendefinerte verktøy](/docs/custom-tools) eller [MCP servere](/docs/mcp-servers).
  6. Som standard er alle verktøy **aktivert** og trenger ikke tillatelse for at kjøre. Du kan kontrollere verktøyets oppførsel gjennom [tillatelser](/docs/permissions).
  7. ---
  8. ## Konfiguration
  9. Brug feltet `permission` for at kontrollere verktøyets oppførsel. Du kan tillate, avslå eller kreve godkjenning for hvert verktøy.
  10. ```json title="opencode.json"
  11. {
  12. "$schema": "https://opencode.ai/config.json",
  13. "permission": {
  14. "edit": "deny",
  15. "bash": "ask",
  16. "webfetch": "allow"
  17. }
  18. }
  19. ```
  20. Du kan også bruge jokertegn for at kontrollere flere verktøy samtidig. For eksempel, for at kreve godkjenning for alle verktøy fra en MCP-server:
  21. ```json title="opencode.json"
  22. {
  23. "$schema": "https://opencode.ai/config.json",
  24. "permission": {
  25. "mymcp_*": "ask"
  26. }
  27. }
  28. ```
  29. [Finn ut mer](/docs/permissions) om konfigurering av tillatelser.
  30. ---
  31. ## Indbyggede
  32. Her er alle de innebygde verktøyene som er tilgængelige i OpenCode.
  33. ---
  34. ### bash
  35. Utfør shellkommandoer i prosjektmiljøet ditt.
  36. ```json title="opencode.json" {4}
  37. {
  38. "$schema": "https://opencode.ai/config.json",
  39. "permission": {
  40. "bash": "allow"
  41. }
  42. }
  43. ```
  44. Dette verktøyet lar LLM kjøre terminalkommandoer som `npm install`, `git status` eller en hvilken som helst annen shell-kommando.
  45. ---
  46. ### edit
  47. Endre eksisterende filer ved at bruge eksakte strengerstatninger.
  48. ```json title="opencode.json" {4}
  49. {
  50. "$schema": "https://opencode.ai/config.json",
  51. "permission": {
  52. "edit": "allow"
  53. }
  54. }
  55. ```
  56. Dette verktøyet utfører nøyaktige redigeringer av filer ved at erstatte eksakte teksttreff. Det er den primære måten LLM endrer kode på.
  57. ---
  58. ### write
  59. Opret nye filer eller overskriv eksisterende.
  60. ```json title="opencode.json" {4}
  61. {
  62. "$schema": "https://opencode.ai/config.json",
  63. "permission": {
  64. "edit": "allow"
  65. }
  66. }
  67. ```
  68. Brug denne for at la LLM lage nye filer. Den vil overskrive eksisterende filer hvis de allerede eksisterer.
  69. :::note
  70. `write`-verktøyet kontrolleres av tillatelsen `edit`, som dekker alle filendringer (`edit`, `write`, `patch`, `multiedit`).
  71. :::
  72. ---
  73. ### read
  74. Les filinnholdet fra kodebasen din.
  75. ```json title="opencode.json" {4}
  76. {
  77. "$schema": "https://opencode.ai/config.json",
  78. "permission": {
  79. "read": "allow"
  80. }
  81. }
  82. ```
  83. Dette verktøyet leser filer og returnerer innholdet. Den støtter lesing av spesifikke linjeområder for store filer.
  84. ---
  85. ### grep
  86. Søk i filinnhold ved hjelp av regulære uttrykk.
  87. ```json title="opencode.json" {4}
  88. {
  89. "$schema": "https://opencode.ai/config.json",
  90. "permission": {
  91. "grep": "allow"
  92. }
  93. }
  94. ```
  95. Rask innholdssøk på tvers av kodebasen din. Støtter full regex-syntaks og filmønsterfiltrering.
  96. ---
  97. ### glob
  98. Finn filer etter mønstermatching.
  99. ```json title="opencode.json" {4}
  100. {
  101. "$schema": "https://opencode.ai/config.json",
  102. "permission": {
  103. "glob": "allow"
  104. }
  105. }
  106. ```
  107. Søk etter filer ved at bruge glob-mønstre som `**/*.js` eller `src/**/*.ts`. Returnerer samsvarende filbaner sortert etter endringstid.
  108. ---
  109. ### list
  110. List filer og kataloger i en gitt bane.
  111. ```json title="opencode.json" {4}
  112. {
  113. "$schema": "https://opencode.ai/config.json",
  114. "permission": {
  115. "list": "allow"
  116. }
  117. }
  118. ```
  119. Dette verktøyet viser kataloginnhold. Den aksepterer glob-mønstre for at filtrere resultater.
  120. ---
  121. ### lsp (experimental)
  122. Samhandle med dine konfigurerte LSP-servere for at få kodeintelligensfunksjoner som definisjoner, referanser, sveveinformasjon og anropshierarki.
  123. :::note
  124. Dette verktøyet er bare tilgængelig når `OPENCODE_EXPERIMENTAL_LSP_TOOL=true` (eller `OPENCODE_EXPERIMENTAL=true`).
  125. :::
  126. ```json title="opencode.json" {4}
  127. {
  128. "$schema": "https://opencode.ai/config.json",
  129. "permission": {
  130. "lsp": "allow"
  131. }
  132. }
  133. ```
  134. Støttede operasjoner inkluderer `goToDefinition`, `findReferences`, `hover`, `documentSymbol`, `workspaceSymbol`, `goToImplementation`, `prepareCallHierarchy`, `incomingCalls` og `outgoingCalls`.
  135. For at konfigurere hvilke LSP-servere som er tilgængelige for prosjektet ditt, se [LSP-servere](/docs/lsp).
  136. ---
  137. ### patch
  138. Brug patcher på filer.
  139. ```json title="opencode.json" {4}
  140. {
  141. "$schema": "https://opencode.ai/config.json",
  142. "permission": {
  143. "edit": "allow"
  144. }
  145. }
  146. ```
  147. Dette verktøyet bruger opdateringsfiler til kodebasen din. Nyttig for at påføre diff og lapper fra forskjellige kilder.
  148. :::note
  149. `patch`-verktøyet kontrolleres av tillatelsen `edit`, som dekker alle filendringer (`edit`, `write`, `patch`, `multiedit`).
  150. :::
  151. ---
  152. ### skill
  153. Last inn en [ferdighet](/docs/skills) (en `SKILL.md` fil) og returner innholdet i samtalen.
  154. ```json title="opencode.json" {4}
  155. {
  156. "$schema": "https://opencode.ai/config.json",
  157. "permission": {
  158. "skill": "allow"
  159. }
  160. }
  161. ```
  162. ---
  163. ### todowrite
  164. Administrer to-doslister under kodingssessioner.
  165. ```json title="opencode.json" {4}
  166. {
  167. "$schema": "https://opencode.ai/config.json",
  168. "permission": {
  169. "todowrite": "allow"
  170. }
  171. }
  172. ```
  173. Opreter og opdaterer oppgavelister for at spore fremdrift under komplekse operasjoner. LLM bruger dette til at organisere flertrinnsoppgaver.
  174. :::note
  175. Dette verktøyet er deaktivert for subagenter som standard, men du kan aktivere det manuelt. [Finn ut mer](/docs/agents/#permissions)
  176. :::
  177. ---
  178. ### todoread
  179. Les eksisterende to-doslister.
  180. ```json title="opencode.json" {4}
  181. {
  182. "$schema": "https://opencode.ai/config.json",
  183. "permission": {
  184. "todoread": "allow"
  185. }
  186. }
  187. ```
  188. Leser nuværende to-doslistestatus. Bruges av LLM for at spore hvilke oppgaver som venter eller er fullført.
  189. :::note
  190. Dette verktøyet er deaktivert for subagenter som standard, men du kan aktivere det manuelt. [Finn ut mer](/docs/agents/#permissions)
  191. :::
  192. ---
  193. ### webfetch
  194. Hent nettinnhold.
  195. ```json title="opencode.json" {4}
  196. {
  197. "$schema": "https://opencode.ai/config.json",
  198. "permission": {
  199. "webfetch": "allow"
  200. }
  201. }
  202. ```
  203. Lar LLM hente og lese nettsider. Nyttig for at slå opp dokumentasjon eller forske på nettressurser.
  204. ---
  205. ### websearch
  206. Søk på nettet for informasjon.
  207. :::note
  208. Dette verktøyet er bare tilgængelig når du bruger OpenCode-leverandøren eller når miljøvariabelen `OPENCODE_ENABLE_EXA` er satt til en sannverdi (f.eks. `true` eller `1`).
  209. Slik aktiverer du når du starter OpenCode:
  210. ```bash
  211. OPENCODE_ENABLE_EXA=1 opencode
  212. ```
  213. :::
  214. ```json title="opencode.json" {4}
  215. {
  216. "$schema": "https://opencode.ai/config.json",
  217. "permission": {
  218. "websearch": "allow"
  219. }
  220. }
  221. ```
  222. Utfører nettsøk med Exa AI for at finne relevant informasjon på nettet. Nyttig for at undersøke emner, finne aktuelle hendelser eller samle informasjon utover treningsdataavbruddet.
  223. Ingen API-nøgle kreves — verktøyet kobles direkte til Exa AIs vertsbaserte MCP-tjeneste uten autentisering.
  224. :::tip
  225. Brug `websearch` når du trenger at finne informasjon (oppdagelse), og `webfetch` når du trenger at hente innhold fra en bestemt URL (henting).
  226. :::
  227. ---
  228. ### question
  229. Still brugeren spørsmål under utførelse.
  230. ```json title="opencode.json" {4}
  231. {
  232. "$schema": "https://opencode.ai/config.json",
  233. "permission": {
  234. "question": "allow"
  235. }
  236. }
  237. ```
  238. Dette verktøyet lar LLM stille spørsmål til brugeren under en oppgave. Det er nyttig for:
  239. - Samle brugerpreferanser eller krav
  240. - Avklarende tvetydige instruksjoner
  241. - Få beslutninger om gjennomføringsvalg
  242. - Tilbyr valg om hvilken retning du skal ta
  243. Hvert spørsmål inkluderer en overskrift, spørsmålsteksten og en liste over alternativer. Brugere kan velge fra de angitte alternativene eller skrive inn et brugerdefineret svar. Når det er flere spørsmål, kan brugerne navigere mellom dem før de sender inn alle svarene.
  244. ---
  245. ## Brugerdefinerede værktøjer
  246. Egendefinerte verktøy lar deg definere dine egne funksjoner som LLM kan kalle. Disse er definert i konfigurasjonsfilen din og kan kjøre vilkårlig kode.
  247. [Finn ut mer](/docs/custom-tools) om at lage tilpassede verktøy.
  248. ---
  249. ## MCP-servere
  250. MCP (Model Context Protocol) servere lar deg integrere eksterne verktøy og tjenester. Dette inkluderer databasetilgang, API-integrasjoner og tredjepartstjenester.
  251. [Les mer](/docs/mcp-servers) om konfigurering av MCP-servere.
  252. ---
  253. ## Interne
  254. Internt bruger verktøy som `grep`, `glob` og `list` [ripgrep](https://github.com/BurntSushi/ripgrep) under panseret. Som standard respekterer ripgrep `.gitignore`-mønstre, noe som betyr at filer og kataloger som er oppført i `.gitignore` vil bli ekskludert fra søk og lister.
  255. ---
  256. ### Ignoreringsmønstre
  257. For at inkludere filer som normalt vil bli ignorert, lag en `.ignore`-fil i prosjektroten. Denne filen kan eksplisitt tillate visse stier.
  258. ```text title=".ignore"
  259. !node_modules/
  260. !dist/
  261. !build/
  262. ```
  263. For eksempel lar denne `.ignore` filen ripgrep søke i `node_modules/`, `dist/` og `build/` kataloger selv om de er oppført i `.gitignore`.