Agentit
obop kohtelee tekoälyagentteja ensiluokkaisina käyttäjinä, joita rajoitetaan tarkoituksella. Tällä sivulla kuvataan malli; seuraavilla sivuilla näytetään, miten agentti otetaan käyttöön.
Agenttimalli
Agentti on mikä tahansa taho, joka toimii obopissa agenttitunnisteella: MCP-asiakas, kuten Claude Desktop tai Cursor, REST-rajapintaa kutsuva skripti tai komentorivi. Agentit työskentelevät samojen tietueiden parissa ja samojen komentojen kautta kuin ihmiset. Neljä sääntöä tekee tästä turvallista.
- Rajattu. Agenttitunnisteeseen kuuluu lista käyttöoikeusryhmiä (sen rajaukset). Tunniste voi vain kaventaa omistajansa oikeuksia, ei koskaan laajentaa niitä. Ryhmän pyytäminen, jota omistajalla ei ole, evätään.
- Maskattu. Henkilötiedot palautetaan pysyvinä paikkamerkkeinä, kuten
EMAIL_1. Talous-, henkilöstö- ja erityisryhmien tietokentät pidätetään. Agentti voi silti päätellä tietueista ja välittää paikkamerkkejä takaisin, mutta se ei koskaan näe oikeita arvoja. Katso Maskauksen paikkamerkit. - Ehdota, älä toteuta. Agentti voi suorittaa tavallisia toimintoja rajaustensa puitteissa, mutta kaikesta peruuttamattomasta (laskun kirjaaminen, maksaminen, hyvittäminen, lähettäminen, julkaiseminen, poistaminen) se voi vain ehdottaa. Palvelin palauttaa suunnitelman tunnuksen eikä muuta mitään. Ihminen hyväksyy. Katso Hyväksyntäkierros.
- Sama ovi. REST, MCP ja CLI kulkevat saman jakelijan kautta, joten agentilla on täsmälleen samat käyttöoikeudet, maskaus ja hyväksynnät riippumatta siitä, miten se yhdistää.
Kolme tapaa yhdistää
| Rajapinta | Käytä, kun | Sivu |
|---|---|---|
| MCP stdio-yhteydellä | MCP-asiakkaan (Claude Desktop, Claude Code, Cursor, VS Code, Windsurf ja muut) pitää kutsua obopia työkaluina. | Yhdistä MCP:n kautta |
| REST | Skripti tai palvelu kutsuu HTTP-päätepisteitä. | Käytä REST-rajapintaa |
| CLI | Komentorivi tai cron-ajo kutsuu komentoa obop call. | Käytä CLI:tä |
Käyttöönotto viidessä vaiheessa
- Päätä, mitä agentin pitää tehdä ja mitä ryhmiä se tarvitsee. Vähemmän on parempi.
- Luo agenttitunniste, jossa on vain nuo rajaukset.
- Yhdistä agentti MCP:n, REST-rajapinnan tai CLI:n kautta.
- Kokeile vaaratonta lukua ja sitten hyväksyntää vaativaa muutosta, ja hyväksy se ihmisenä.
- Lue Turvallisuuden parhaat käytännöt ennen kuin annat tunnisteen millekään valvomattomalle.
Mitä on tehty ja mitä ei
- Tehty: rajatut tunnisteet, maskaus ja palautus, hyväksyntäsuunnitelmat, MCP stdio-yhteydellä, REST ja CLI.
- Ei vielä tehty: HTTP-pohjainen (etä)MCP-siirto OAuthilla, joten isännöityihin instansseihin ei vielä pääse MCP:llä; näkymä agenttitunnisteiden luomiseen tai mitätöintiin; luettelo odottavista hyväksynnöistä käyttöliittymässä. Agenttitunnisteet eivät vanhene, eikä mitätöintikomentoa ole vielä. Nämä mainitaan uudelleen kohdissa, joissa niillä on merkitystä.
Esimerkkityönkuluissa on kehotteita ja kulkuja, joista voi lähteä liikkeelle, ja Vianmäärityksestä apua, kun jokin ei toimi.