Mitä tekoälyagenttini teki? Neljä kysymystä, joihin vastataan todisteilla

Saadaksesi selville, mitä tekoälyagenttisi teki, älä aloita sen yhteenvedosta. Tarkista neljä asiaa: mikä yhteys teki työn, mikä muuttui (osoitettuna jollain, minkä voit itse avata), mitä jäi tekemättä ja mitä päätettiin ja miksi. Jos yksikin näistä neljästä lepää pelkän agentin sanan varassa, sinulla on kertomus, ei kirjaus.

Me teemme Weftiä. Muita tuotteita koskevat tiedot ovat niiden virallisilta sivuilta, tarkistettu 27.10.2026.

Miksi "valmis"-kommentti ei riitä?

Kommentti on agentin kuvaus omasta työstään. Se voi hyvin olla paikkansapitävä, mutta kommentti ei voi osoittaa sitä, koska kirjoittaja on juuri se osapuoli, jota yrität tarkistaa. Tieto siitä, että agentti koski tehtävään, vastaa kysymykseen kuka. Se ei vastaa siihen, onko työ sitä, mitä luulet sen olevan.

Hypertaskin artikkeli tekoälytyön attribuutiosta tekee reilun huomion: agenttien työn pitäisi päätyä samalle taululle kuin ihmisten työn eikä päätelokiin, jota kukaan ei lue. Hypertask antaa agenteille myös oman identiteetin palvelutileinä, joten kirjoitukset merkitään agentille eikä sinulle, ja siinä on tehtävien todisteet ja leaset, vaikka sen ohjeiden mukaan ne ovat vain REST-päätepisteitä, eivät MCP-työkaluja, tarkoituksella. Me eroamme siinä, mitä kirjauksen pitäisi sisältää. Kommenttiketju agentin tulosteineen on loki siitä, mitä agentti sanoi. Me haluamme kirjaukseen todisteet.

Tässä oppaassa ei ole kyselytutkimusten lukuja. Voit testata neljä kysymystä omalla taulullasi vielä tänään, ja se kertoo enemmän kuin toimialan keskiarvo.

Mitkä ovat ne neljä kysymystä?

Valitse mikä tahansa tehtävä, jonka agentti sai valmiiksi viime viikolla. Sinun pitäisi pystyä vastaamaan jokaiseen näistä alle minuutissa kysymättä agentilta tai avaamatta sen keskustelua:

1. Kuka sen teki? Mikä asiakas, millä yhteydellä, varasi tehtävän ja sai sen valmiiksi.
2. Mikä muuttui? Lopputulos sekä artefaktit, jotka voit tarkistaa luottamatta agenttiin: commit-tiiviste, URL, tiedosto, viestin id.
3. Mitä jäi tekemättä? Osat, jotka se ohitti, ja asiat, joista se oli epävarma.
4. Mitä päätettiin ja miksi? Matkan varrella tehdyt valinnat punnittuine vaihtoehtoineen sekä jokainen kerta, kun palautit työn.

Mistä tiedän, mikä agentti sen teki?

Weft yhdistää tekoälyasiakkaisiin Model Context Protocolin kautta yhdessä päätepisteessä, https://letsweft.com/api/mcp. Jokainen OAuth-asiakas ja jokainen henkilökohtainen käyttötunnus on oma toimijansa. Tehtävä kirjaa, mikä asiakas sen loi, ja taulu näyttää nimen, jolla asiakas rekisteröityi kirjautuessaan, sekä kuvakkeen. Jokainen tehtävän lokin tapahtuma tallentaa, tuliko se ihmiseltä vai MCP:n kautta ja mikä asiakas sen lähetti.

Koko loki (get_task_history full-tilassa) näyttää jokaisen tapahtuman raa'an asiakas-id:n: OAuth-asiakkaan id:n tai mcp-token ja perään tunnuksen id. Se ei ole ystävällinen nimi, mutta se on tarkka, ja se erottaa kaksi yhteyttä silloinkin, kun ne tulevat samasta tuotteesta.

Omistajuus työn aikana on myös eksplisiittinen. Agentti kutsuu start_task-työkalua, joka varaa tehtävän 20 minuutin leasella ja siirtää sen Doingiin. report_progress uusii leasen. Toinen agentti, joka yrittää samaa tehtävää, saa vastauksen already_claimed, ja rauennut lease vapauttaa tehtävän muille. Varaussilmukan opas käy tämän läpi vaihe vaiheelta, ja usean agentin ajaminen yhdellä taululla kattaa monen asiakkaan tapauksen.

Yksi käytännön sääntö: anna jokaiselle työkalulle oma yhteytensä. Jos kaksi asiakasta jakaa yhden käyttötunnuksen, taulu näkee yhden toimijan, ja kuka-kysymys menettää vastauksensa.

Mikä muuttui, ja voinko tarkistaa sen kysymättä agentilta?

Kun agentti on valmis, se kutsuu complete_task-työkalua. Vain tehtävän id on pakollinen; kaikki muu on valinnaista, eikä kutsu koskaan epäonnistu puuttuvien todisteiden takia. Se on tarkoituksellista: valmiin työn menettäminen on pahempaa kuin sen kirjaaminen varmistamattomana. Mitä kuitti voi sisältää:

• outcome: enintään 1 000 merkkiä siitä, mitä tehtiin ja missä tulos on.
• artifacts: enintään 20 merkintää, kussakin laji (url, file, message, commit ja niin edelleen), sijainti ja valinnaisesti sha256-tiiviste.
• claims: mitä agentti väittää tehneensä, tallennettuna väitteinä eikä varmennettuina faktoina.
• notDone ja unknowns: käsitellään seuraavassa osiossa.
• nextStep: mitä agentti tekisi seuraavaksi, jos hyväksyt.

complete_task({
  "id": "<task id>",
  "runId": "<from start_task>",
  "leaseToken": "<from start_task>",
  "outcome": "Rate limiting added to /login; PR open, not merged.",
  "artifacts": [
    { "kind": "commit", "uri": "<repo>/commit/<hash>" },
    { "kind": "url", "uri": "<repo>/pull/<number>" }
  ],
  "notDone": ["Did not change the signup endpoint"],
  "unknowns": ["Limit of 5 per minute is a guess; no traffic data"],
  "nextStep": "Merge the PR to main"
})

Lopputulosrivi on yhä kertomusta. Artefaktit ovat se osa, jonka voit tarkistaa. Commit-tiiviste joko löytyy repositoriostasi tai ei. URL latautuu tai ei. Tiedoston sha256 täsmää tai ei. Jos kuitissa on lopputulos mutta ei artefakteja, kohtele sitä agentin ilmoittamana työnä, koska sitä se on. Verkossa Done-kortit näyttävät, onko tehtävä Varmennettu vai Agentin mukaan.

Mitä agentti jätti tekemättä?

Tämä on kysymys, jonka useimmat kirjaukset ohittavat, ja se, joka puree kahden viikon päästä. complete_task-työkalussa on sitä varten kaksi listaa, kumpikin enintään 20 merkintää à 500 merkkiä: notDone sille, minkä agentti jätti tarkoituksella pois, ja unknowns sille, mistä se on epävarma. Työkalun oma kuvaus pyytää agentteja kertomaan ääneen, mitä ne eivät tehneet. Juuri se erottaa tuloksen, johon voi luottaa, tuloksesta, joka on selvitettävä uudelleen.

Lue nämä listat ensin. "En ajanut testejä staging-tietokantaa vasten" muuttaa sitä, mitä teet seuraavaksi. Kuitti, jossa ei ole yhtään notDone-merkintää isossa tehtävässä, on jo itsessään kysymyksen arvoinen.

Mitä päätettiin ja miksi?

Keskustelussa tehdyt päätökset katoavat, kun keskustelu vierii pois näkyvistä. record_decision säilyttää ne kahdella tavalla:

• Erillinen päätöskirjaus: otsikko, lopputulos, konteksti, oikeasti punnitut vaihtoehdot, seuraukset ja ehto, jolla päätös arvioidaan uudelleen. Kirjauksia ei voi muuttaa; muuttaminen tarkoittaa uuden, edellisen korvaavan päätöksen kirjaamista, ja vanha jää näkyviin korvatuksi merkittynä.
• Ratkaisun välitys: kun sanot agentille keskustelussa "hyväksytty", "tee uudelleen X:llä", "hylkää" tai "ei nyt", se kirjaa ratkaisun tehtävään muistiinpanosi kera.

get_task_history lukee sen takaisin kolmessa tilassa: summary (kortti, sen viimeisin kuitti ja lukumäärät), decisions (jokainen tehtävää koskeva päätös, mukaan lukien syy palauttamiseen, joka säilyy myöhemmänkin hyväksynnän jälkeen) ja full (raaka loki, enintään 100 tapahtumaa). get_context antaa voimassa olevat päätökset seuraavalle agentille token-budjetin puitteissa, joten seuraava ajo alkaa siitä, mitä päätettiin, eikä tyhjästä. Lisää kirjoituksessa miksi tekoälykeskustelujen päätökset katoavat.

Missä katselmoin sen, ja mitä klikkaan?

Oletuksena valmistunut tehtävä menee suoraan Doneen. Se pysähtyy Saapuneisiisi, kun tehtävä vaatii katselmointia tai tarkistus epäonnistuu. Siellä näet kuitin ja neljä painiketta: Hyväksy, Korjattavaksi, Myöhemmin ja Hylkää. Korjattavaksi pyytää muistiinpanon, ja se menee takaisin agentille.

Jos agentti antoi nextStepin, se näkyy Hyväksy-painikkeen yläpuolella, ja hyväksyminen hyväksyy täsmälleen sen vaiheen. Hyväksyntä on voimassa 72 tuntia ja palaa agentille get_my_work- tai start_task-kutsun kautta ainoana seuraavaksi tehtävänä vaiheena. Kysymykset, jotka agentti esittää request_input-työkalulla, saapuvat samoihin Saapuneisiin verkossa sekä iOS- ja Android-sovelluksissa push-ilmoituksen kera.

Saapuneilla on tarkoituksella raja: 5 odottavaa kohtaa yhden hengen työtilassa, 10 tiimissä tai 45 minuuttia arvioitua katselmointiaikaa, kumpi tahansa tulee ensin. Kun se on täynnä, start_task kieltäytyy vastauksella attention_queue_full, joten agentit viimeistelevät tai selkeyttävät työtä sen sijaan, että kasaisivat sinulle lisää tarkistettavaa.

Mitä todisteita kannattaa pyytää tehtävätyypin mukaan?

Kirjoita nämä tehtävän kuvaukseen, jotta agentti tietää, millaisia todisteita odotat:

• Koodi: commit-tiiviste ja PR:n URL artefakteina. notDone-listan pitäisi nimetä ajamatta jääneet testit, soveltamatta jääneet migraatiot ja tarkoituksella koskematta jätetyt tiedostot.
• Sisältö: julkaistu URL tai luonnostiedosto sha256-tiivisteineen, jos se ei ole vielä julkaistu. unknowns-listan pitäisi luetella faktat, joita agentti ei voinut vahvistaa.
• Tutkimus: lähde-URL jokaiselle keskeiselle väitteelle sekä muistiinpanotiedosto. unknowns-listan pitäisi erottaa se, mitä lähde sanoo, siitä, mitä agentti päätteli.
• Yhteydenotot: jokaisen lähetetyn viestin id sekä vastaanottajalista tiedostona. notDone-listan pitäisi kertoa, keihin ei otettu yhteyttä ja miksi.

Miten rajaan alun perin, mitä agentti voi tehdä?

Jälkikäteinen attribuutio toimii parhaiten, kun rajat on asetettu etukäteen. Weftissä jokaisella OAuth-yhteydellä on yksi kolmesta oikeustasosta, joka asetetaan suostumusnäkymässä tai myöhemmin kohdassa Asetukset, Yhdistetyt tekoälyasiakkaat:

• full (oletus): kaikki 32 työkalua.
• write: kaikki paitsi kolme tuhoavaa työkalua (trash_task, archive_done_tasks, complete_sprint).
• read: vain 11 vain luku -työkalua.

Tarkistus tehdään jokaisessa kutsussa. Katkaise yhteys peruu yhteyden refresh-tunnukset ja torjuu seuraavassa kutsussa jokaisen ennen katkaisua myönnetyn tunnuksen. Henkilökohtaisilla käyttötunnuksilla, jotka on tarkoitettu asiakkaille ilman OAuthia, ei ole rajauksia: yksi tunnus yltää kaikkiin 32 työkaluun, ja sen peruminen tulee voimaan seuraavassa kutsussa. Agentit voivat siirtää tehtäviä 30 päivän roskakoriin, mutta eivät poistaa niitä lopullisesti; palautus roskakorista on Pro-ominaisuus.

Mitä Weft ei tässä tee?

• Siinä ei ole GitHub- tai Slack-integraatiota, joten Weft ei hae commitejasi tai viestejäsi puolestasi. Avaat artefaktin itse.
• Siinä ei ole julkista REST API:a, webhookeja tai CLI:tä kuittien työntämiseen muihin järjestelmiin. JSON- ja Markdown-vienti on olemassa.
• Se ei jäljitä mallin vaiheita. Työkalut, jotka kirjaavat kehotteet, tokenit ja viiveet mallikerroksessa, tekevät eri työtä, ja saatat haluta sellaisenkin.
• Agentit kirjoittavat kuittinsa itse. Weft tekee väitteen ja todisteen välisen kuilun näkyväksi; se ei voi tehdä agentista rehellistä.

Jos haluat agentit palvelutileinä REST API:n kautta, CLI:n CI-skripteihin tai sisäänrakennetut tekoälyominaisuudet, kuten tehtävien kirjoittamisen ja lajittelun, Hypertask sopii siihen paremmin. Hypertask-vaihtoehto-sivumme vertailee niitä rinnakkain.

Eikö git-historia riitä kertomaan, mitä agenttini teki?

Git näyttää, mikä koodissa muuttui. Se ei näytä, mitä agentti ohitti, mistä se oli epävarma tai minkä valinnan se teki kahden vaihtoehdon välillä. Käytä commit-tiivistettä tehtävän artefaktina ja pidä loput kuitissa ja päätöskirjauksessa.

Eikö agentti voi vain keksiä artefaktin?

Se voi lähettää minkä tahansa merkkijonon. Artefaktin idea on, että voit avata sen: tiivisteen, jonka voit hakea, URL:n, jonka voit ladata, viestin id:n, jonka voit löytää. Keksitty kaatuu heti, kun tarkistat sen, mitä kommentti ei koskaan tee. Kun tehtävällä on tarkistus ja estävä tarkistus epäonnistuu, tehtävä pysyy poissa Donesta.

Odottaako jokainen valmis tehtävä katselmointiani?

Ei. Oletuksena valmistunut tehtävä menee Doneen. Se odottaa Saapuneissasi (Hyväksy, Korjattavaksi, Myöhemmin tai Hylkää) vain, kun tehtävä vaatii katselmointia tai tarkistus epäonnistuu.

Mitkä tekoälyasiakkaat voivat kirjoittaa kuitteja Weftiin?

Mikä tahansa MCP-asiakas. ChatGPT:ssä Weft on julkaistu lisäosa kaikilla tasoilla, myös Freellä. Claude Code yhdistää komennolla claude mcp add --transport http weft https://letsweft.com/api/mcp. Claude.ai ja Claude Desktop käyttävät mukautettua liitintä. Asennussivuja on 33 asiakkaalle, kuten Claude Code, ChatGPT, Cursor ja Codex.

Mitä tämä maksaa?

Free kattaa 50 tehtävää ja 200 tekoälykutsua kuukaudessa. Pro maksaa 8,16 € paikalta kuukaudessa tai 69,03 € paikalta vuodessa (sis. alv). Weftissä ei ole tekoälykrediittejä: ajattelu tapahtuu omassa tekoälyasiakkaassasi. Katso hinnoittelu.