Autonomy dokumentatsioon
AI Assistants

Saadaolevad toimingud

23 MCP-tööriista projektide, testjuhtumite, testiplaanide, käivituste, keskkondade ja probleemide jaoks.

Autonomy MCP-l on 23 tööriista, üks iga HTTP API toimingu kohta, samade argumentide, tulemuste ja reeglitega. Tööriista nimi on autonomy_ pluss toimingu nimi, milles punktid on asendatud alakriipsudega: run.get on autonomy_run_get.

Projektid

TööriistEesmärk
autonomy_project_listLoetle projektid, millele sul on ligipääs. Alusta siit, et leida projectId, mida teised tööriistad vajavad.
autonomy_project_getToo üks projekt koos selle tooteteadmistega.

Testjuhtumid

TööriistEesmärk
autonomy_test_case_listLoetle testjuhtumid, uusimad eespool. Filtreeri projectId, platform või nimepäringu query järgi. Kasuta seda enne testjuhtumi loomist, et olemasolevat katvust taaskasutada.
autonomy_test_case_getToo üks testjuhtum koos selle oodatud tulemustega sammude ja nende manustega.
autonomy_test_case_createLoo projektis testjuhtum oodatud tulemustena kirjutatud sammudest.
autonomy_test_case_update_stepsAsenda testjuhtumi kogu sammude loend. Nõuab alati confirm: true.
autonomy_test_case_archiveArhiveeri testjuhtum. Selle käivitused ja tulemused säilivad.

Iga samm on lihtsas keeles oodatud tulemus (text) koos püsiva id ja valikuliste manustega attachments: account, inbox, phone, file, screenshot või data. Manused on testandmed, kui exact ei ole true. data-manus võib kanda väärtust value (ka kujul {{env.NAME}}) või kirjeldust intent, näiteks „A strong password“, mille järgi agent väärtuse valib. Väärtusega secret: true saab väärtust ainult kirjutada. Kõiki välju ja piiranguid näed jaotises Sammud oodatud tulemustena.

Testiplaanid

TööriistEesmärk
autonomy_test_plan_listLoetle testiplaanid. Filtreeri projectId või nimepäringu query järgi.
autonomy_test_plan_getToo üks testiplaan koos selle järjestatud testjuhtumitega.
autonomy_test_plan_createLoo projektis testiplaan, soovi korral koos esimeste testjuhtumitega.
autonomy_test_plan_set_membersAsenda testiplaani testjuhtumid. Nõuab confirm: true, kui testjuhtumeid eemaldataks.

Käivitused

TööriistEesmärk
autonomy_run_triggerLisa järjekorda ühe testjuhtumi või ühe testiplaani käivitused salvestatud keskkonnas või värskete sihtmärkide vastu. Tagastab kohe.
autonomy_run_listLoetle hiljutised käivitused, uusimad eespool. Filtreeri projectId, testCaseId, status, environmentSlug või branch järgi. Vaata siit enne, kui sama tööd uuesti alustad.
autonomy_run_getToo käivituse tulemus, iga sammu tulemus ja see, mida käivitus lõi. Ootab väljadega cursor ja waitMs muutust.
autonomy_run_step_actionsLoetle kõik, mida agent iga sammu oodatud tulemuseni jõudmiseks tegi, sealhulgas Final check. Väärtused, mille salvestasid saladustena, on maskeeritud.
autonomy_run_evidenceToo iga sammu oodatud tulemus, tulemus, selgitus, Final check ning lühiajalised ekraanipiltide ja video lingid.

Keskkonnad

TööriistEesmärk
autonomy_environment_listLoetle keskkonnad koos nende platvormi sihtmärkidega. Väärtuste nimed on näha, väärtused mitte kunagi.
autonomy_environment_getToo üks keskkond slug'i järgi.
autonomy_environment_upsertLoo projektis keskkond või uuenda olemasolevat slug'i järgi. Uuendamine nõuab confirm: true.

Probleemid

TööriistEesmärk
autonomy_issue_listLoetle probleemid, uusimad eespool. Filtreeri projectId, environmentSlug, status, kind või runId järgi, et näha ühe käivituse probleeme.
autonomy_issue_createRegistreeri Bug või Risk keskkonnas, kus seda nähti, ja viita käivitustele väljaga runIds.
autonomy_issue_commentLisa probleemile lihttekstis kommentaar.
autonomy_issue_set_statusSea probleemi olekuks open, resolved või ignored.

Probleem ei muuda kunagi käivituse ega sammu tulemust.

MCP lisasisendid

Iga tööriist aktsepteerib lisaks:

  • response_format: "markdown" (vaikimisi) või "json". Mõlemaga tuleb kaasa sama struktureeritud tulemus; see muudab ainult teksti, mida assistent loeb. Väga pikk tekst lõigatakse 24 000 märgi juurest; kasuta kitsamaid filtreid või väiksemat limit-it.
  • idempotencyKey (midagi muutvad tööriistad): MCP-s valikuline. Kui klient selle ära jätab, loob Autonomy iga kutse jaoks uue, nii et korratud kutset ei tunta kordusena ära ja see võib töö kaks korda ära teha. Anna oma võti, kui kordus ei tohi muudatust korrata, näiteks tööriistaga autonomy_run_trigger.

Vead tulevad tagasi tööriista veana tekstiga <CODE>: <message> ja kasutavad samu veakoode nagu HTTP API.

Asendamiste kinnitamine

Autonomy ei esita MCP-s teist küsimust. Tööriistad, mis midagi asendaksid, vajavad confirm: true:

  • autonomy_test_case_update_steps alati, sest see asendab kogu sammude loendi.
  • autonomy_test_plan_set_members, kui testjuhtumeid eemaldataks.
  • autonomy_environment_upsert, kui slug on olemas ja anti välju või sihtmärke.

Ilma selleta ei kirjutata midagi. Tööriist tagastab INVALID_ARGUMENT koos väärtusega confirmRequired: true ja kokkuvõttega wouldChange. Loe kokkuvõte läbi, näita seda vajaduse korral inimesele ja alles siis kutsu uuesti koos confirm: true-ga. Ära lisa kinnitust mehaaniliselt.

Käivituse jälgimine

  1. Alusta. Kutsu autonomy_run_trigger väljaga testCaseId (või testPlanId) ning environmentSlug või targets. Jäta runIds meelde.
  2. Oota. Kutsu autonomy_run_get väljaga runId. Salvesta cursor. Kuni next on wait, kutsu uuesti selle cursor-i ja väärtusega waitMs: 25000. timedOut: true tähendab ainult, et ootamise ajal midagi ei muutunud: kutsu uuesti.
  3. Vaata, mida agent tegi. Kutsu autonomy_run_step_actions, ühele sammule keskendumiseks koos väljaga stepIndex. Kuni käivitus käib, loe iga kord algusest uuesti, kui runCursor muutub.
  4. Loe tõendeid. Kui käivitus lõpeb, ja eriti kui next on evidence, kutsu autonomy_run_evidence. Igal sammul on oodatud tulemus, tulemus, selgitus, Final check ja meedialingid. Lingid aeguvad 15 minuti pärast; värskete saamiseks kutsu tööriista uuesti.
  5. Vaata probleemid üle. Kutsu autonomy_issue_list väljaga runId, et näha probleeme, mille käivitus leidis või mida see näitas. Neid hoitakse tulemusest eraldi.

next on soovitus, mitte määrav juhis. Otsusta oleku status ja sammude põhjal. Käivitus lõpeb olekuga passed, failed, couldnt_start või cancelled. Läbikukkunud sammu selgitus ütleb, kas oodatud tulemuseni ei jõutud või agent ei suutnud näidata, et jõuti; loe seda, enne kui käsitled läbikukkumist veana. Samm väärtusega failureCategory: "runner" kukkus läbi Autonomy, mitte rakenduse tõttu. Kõiki välju näed lehel Käivitused ja tõendid.

Käivituse sihtmärgid

autonomy_run_trigger aktsepteerib välja platforms väärtustega web, api, ios ja android. Kasuta environmentSlug-i, kui sihtmärk on salvestatud, või targets-it värske juurutuse või buildi jaoks, mitte mõlemat.

PlatvormSihtmärgi väljad
Veebtargets.web.baseUrl
APItargets.api.baseUrl, valikuline targets.api.runtimeValues
iOS (tulekul)targets.ios.bundleId ning targets.ios.artifactUrl või skannitud targets.ios.storageId
Androidtargets.android.packageName ning targets.android.artifactUrl või skannitud targets.android.storageId

Lisa branch, pr ja deployment.commitSha, et siduda käivitused pull request'i või commit'iga.

OAuthi õigused

ÕigusTööriistad
autonomy:readKõik loetlemis- ja toomistööriistad, autonomy_run_step_actions, autonomy_run_evidence
autonomy:test_cases:writeautonomy_test_case_create, autonomy_test_case_update_steps, autonomy_test_case_archive
autonomy:test_plans:writeautonomy_test_plan_create, autonomy_test_plan_set_members
autonomy:runs:writeautonomy_run_trigger
autonomy:environments:writeautonomy_environment_upsert
autonomy:issues:writeautonomy_issue_create, autonomy_issue_comment, autonomy_issue_set_status

Kuidas iga õigus nõusolekuekraanil paistab, vaata lehelt Organisatsiooni juurdepääs.

Valmisviibad assistendile

Olemasoleva katvuse kontrollimine

Codetext
Kasuta Autonomy MCP-d, et leida selle hoidla projekt, ja loetle siis selle asjakohased testjuhtumid, testiplaanid ja hiljutised käivitused.
Kui selle haru või PR-i jaoks on käivitus juba olemas, võta selle olek kokku, enne kui midagi uut alustad.

PR-i eelvaate käivitamine

Codetext
Kasuta Autonomy MCP-d, et käivitada asjakohane testjuhtum selle eelvaate URL-i vastu.
Anna kaasa haru, PR-i number ja commit'i SHA ning oma idempotencyKey. Oota, kuni käivitus lõpeb, ja võta siis kokku iga sammu tulemus ja selgitus.

Läbimata käivituse diagnoosimine

Codetext
Too Autonomy käivitus, selle Step Actions ja tõendid enne, kui parandust pakud.
Viita sammule, selle selgitusele, Final check'ile ja meedialingile, mis sinu järeldust toetavad.
Loetle kõik probleemid, mille käivitus leidis.

Ei leidnud?

On this page