Agenttiympäristö

Tämä sivu kuvaa kontitetun agenttiympäristön Roihussa. Varmista, että luet Käyttöä ennen luettava -osion ennen käyttöä, ja noudata CSC AI Agent Policy -ohjetta.

Käyttöä ennen luettava

Datan yksityisyys

Oletuksena OpenCode on määritetty käyttämään OpenCode Zen -mallipalveluntarjoajaa, jota ylläpitää OpenCodea ylläpitävä Anomaly Innovations. He tarjoavat tietyn määrän käyttöä maksutta, mutta kaikki mitä kirjoitat tai mitä agentti lukee lähetetään Anomaly Innovationsille ja sitä käytetään heidän käyttöehtojensa mukaisesti.

Claude Code ja Codex lähettävät kehotteesi ja tiedostot, joita agentti lukee, palveluihin Anthropic ja OpenAI vastaavasti. Se, miten tätä dataa säilytetään ja voidaanko sitä käyttää mallien kouluttamiseen, riippuu sen tilin ehdoista, jolla kirjaudut sisään. CSC ei tarjoa päätepistettä eikä voi määrittää tätä puolestasi, joten tarkista omaan tilaukseesi sovellettavat ehdot ennen kuin käytät Claude Codea tai Codexia luottamuksellisen materiaalin kanssa.

Vastuu: Olet aina vastuussa siitä, mitä agenttisi tekee. Jokainen komento, jonka se suorittaa, ajetaan henkilökohtaisella tunnuksellasi.
Tietoturva: Agentilla on pääsy hakemistoon, josta käynnistät sen, kaikkiin sen alihakemistoihin sekä muutamiin muihin hakemistoihin määrityksiä varten. Täydellinen lista löytyy repositoriosta. $HOME itse ei ole oletuksena käytettävissä.
Työkalujen käyttö: Oletuksena agentti voi käyttää monia vain luku -työkaluja ilman lupaa, mutta pyytää vahvistuksen kaikille kirjoitustoiminnoille. Tarkista repositoriosta täydellinen lista käyttöoikeuksista.
Kokeellinen tila: Agenttiympäristö on edelleen kokeellinen ja voi muuttua ilman ennakkoilmoitusta.

Käyttöohjeet

Jos haluat käyttää OpenCodea tai Claudea projektihakemistossasi, siirry hakemistoon ja suorita seuraavat komennot:

module load roihu-agent-env

opencode
# or
claude
# or
codex

Voit tehdä ympäristössä näkyviksi lisää hakemistoja käyttämällä --roihu-bind- ja --roihu-ro-bind-valitsimia agenttia käynnistettäessä. Tämä toimii kaikille agenteille. --roihu-ro-bind sallii hakemistoon vain luku -käyttöoikeuden. Esimerkki:

claude --roihu-bind /path/to/dir1,/path/to/dir2

Agenttien määrittäminen

OpenCode

Suosittelemme käyttämään Aitassa ylläpidettyjä malleja, joka on CSC:n palvelu.

Info

Vain käyttäjät, joilla on LUMI-projekti, voivat käyttää Aittaa. Työskentelemme sen parissa, että pääsy voidaan tarjota kaikille, joilla on Roihu-projekti.

Aitta sisältyy OpenCoden oletusmääritykseen. Sinun tarvitsee vain hakea API-avaimesi Aitasta Generate token -painikkeesta ja tallentaa se $AITTA_KEY-ympäristömuuttujaan ennen agentin käynnistämistä.

export AITTA_KEY=<YOUR_KEY_HERE>

Helpointa on lisätä tämä rivi ~/.bashrc-tiedostoosi, jotta sitä ei tarvitse asettaa jokaisella kirjautumiskerralla.

Jos haluat käyttää eri mallipalveluntarjoajaa, muuttaa työkalujen käyttöoikeuksia tai lisätä MCP-palvelimia, voit lisätä määrityksesi tiedostoon ~/.config/opencode/opencode.json tai lisätä määrityksen sisältävän opencode.json-tiedoston projektihakemistoosi. Ohjeet mukautettuihin määrityksiin löytyvät OpenCoden dokumentaatiosta.

Claude Code

Aitta ei tarjoa Anthropicin kanssa yhteensopivaa päätepistettä, joten et voi käyttää sitä Claude Coden päätepisteenä.

Kuten OpenCoden kanssa, voit muuttaa asetuksia JSON-tiedostolla, joka sijoitetaan polkuun $HOME/roihu-claude/settings.json. Huomaa, että tämä polku poikkeaa virallisesta polusta $HOME/.claude/settings.json. Tämä johtuu siitä, että claude tallentaa joitakin asioita tiedostoon ~/.claude.json, mikä vaatisi $HOME-hakemiston sitomisen. Mukautetun hakemiston avulla voimme välttää tämän. Asetusten muotoa ja muita määritystiedostoon liittyviä yksityiskohtia varten katso Claude Coden dokumentaatio.

Vaihtoehtoisesti voit muuttaa asetuksia Claude Codessa, jolloin tiedosto luodaan automaattisesti.

Codex

Codex ei tue Aitan tarjoamaa päätepistemuotoa, joten et voi käyttää Aittaa päätepisteenä.

Voit muuttaa asetuksia ja MCP-palvelimia tiedostossa config.toml, joka sijoitetaan hakemistoon $HOME/roihu-codex. Katso tarkemmat tiedot täsmällisestä muodosta Codexin dokumentaatiosta.

Voit lisätä MCP-palvelimia komennolla

codex mcp add <server-name> --env VAR1=VALUE1 --env VAR2=VALUE2 -- <stdio server-command>

Kaikki taidot, jotka haluat lisätä, tulee sijoittaa hakemistoon $HOME/roihu-codex/skills.

MCP-palvelimet

Model Context Protocol (MCP) on standardoitu tapa, jolla AI-agentit voivat käyttää monia eri työkaluja. Yleisen johdannon löydät MCP-dokumentaatiosta.

Agenttiympäristö sisältää kaksi MCP-palvelinta: yhden Slurm-komentojen suorittamiseen ja CSC-docs-palvelimen CSC:n käyttöoppaan hakemiseen. Voit vapaasti lisätä lisää.

Slurm

Agentit eivät pysty suorittamaan Slurm-komentoja kontin sisältä, joten Slurm MCP -palvelin on ainoa reitti. Se tarjoaa kiinteän joukon komentoja ja tallentaa tuloksia välimuistiin, joten toistetut tai tarpeettomat kutsut eivät kuormita Slurm-tietokantaa.

MCP tarjoaa seuraavat työkalut, ja kunkin kohdalla on lueteltu taustalla ajettava komento. Oletuksena agentti voi kutsua vain luku -työkaluja ilman lupaa, kun taas launch_job ja cancel_job vaativat luvan joka kerta.

Tool	Command	Needs permission
`my_jobs`	`squeue --me`	No
`job_history`	`sacct`	No
`sinfo`	`sinfo`	No
`batch_script`	`scontrol write batch_script` or `sacct -B`	No
`slurm_config`	`scontrol show config`	No
`reservations`	`scontrol show reservations`	No
`launch_job`	`sbatch`	Yes
`cancel_job`	`scancel`	Yes

CSC-docs

Agentit toimitetaan valmiiksi määritettyinä CSC-docs MCP -palvelimen kanssa. Voit lukea siitä lisää sivulta CSC-docs MCP.

Taidot

Agenttitaidot ovat Markdown-tiedostoja, jotka antavat agentille lisää kontekstia. Ne voivat tarjota agenteille seurattavia työnkulkuja, lisätietoa tai valmiita skriptejä.

Agentti ottaa taidot käyttöön automaattisesti tilanteissa, jotka se katsoo sopiviksi, mikä tekee niistä token-tehokkaita, koska niitä ei lueta muuten kuin silloin, kun niitä tarvitaan. Voit myös ottaa ne käyttöön manuaalisesti kirjoittamalla /<skill-name> kehotteesi alkuun sekä OpenCodessa että Claude Codessa. Voit lukea lisää agenttitaidoista agent skills documentation -sivulta.

Roihun agenttiympäristö sisältää oletuksena kolme taitoa: job-efficiency, software-environments ja batch-scripts. Voit lukea niistä lisää alta.

Työn tehokkuus

Hakee työn tehokkuusmittarit. Jos et anna työn tunnusta, agentti päättelee, mitä työtä tarkoitat.

Ohjelmistoympäristöt

Auttaa ohjelmistojen asentamisessa tai käytössä Roihussa. Tarkistaa, onko jokin jo asennettu Roihuun, miten sitä käytetään, jos se on, ja mitä asennusvaihtoehtoja on saatavilla, jos sitä ei ole.

Eräajokomennostot

Auttaa eräajo-/Slurm-komennostojen luomisessa, virheenkorjauksessa ja optimoinnissa. Varmistaa, että komennosto sisältää tarvittavat osat, ottaa huomioon joitakin yleisiä tapauksia (suuri I/O, MPI-työt jne.) ja mitä muutoksia ne vaativat eräajo-/Slurm-komennostoon.

Omien taitojen lisääminen

Voit lisätä agenteille omia taitoja. Luo taito standardien mukaisesti agent skills documentation -sivun ohjeiden mukaan ja lisää se hakemistoon $HOME/.agents/skills OpenCodea varten ja hakemistoon $HOME/roihu-claude/skills Claude Codea varten. Vaihtoehtoisesti voit lisätä taidot hakemistoon, josta käynnistät agentit, .claude/skills-kansioon edellä mainittujen hakemistojen sijaan. Sekä Claude Code että OpenCode tarkistavat tämän hakemiston. Muihin sijainteihin kuin $HOME/.agents, $HOME/roihu-claude tai $HOME/roihu-codex sijoitetut taidot rajataan siihen hakemistoon, johon ne on sijoitettu.

Löydät lisää CSC:n tekemiä taitoja Githubistamme, jotka voivat auttaa muiden CSC-palveluiden käytössä.