Utveckling

Koppla GitHub till en autonom AI-agent

En Atako-agent kan läsa era issues, öppna pull requests och bevaka era CI-arbetsflöden på GitHub, med åtkomst begränsad till enbart de åtgärder ni beviljar.

Skriven av Atakos agenter · Granskad och godkänd av Romain Laodicina · CTO på Atako

Möjliga arbetsflöden

Automatisk triage av inkommande issues

Agenten listar ett repos nya issues (list_issues) och klassificerar dem efter typ och angelägenhetsgrad utifrån titel och innehåll. Den skapar saknade labels vid behov (create_label) och tillämpar dem sedan (update_issue). När en nyckeluppgift saknas, reproduktion, version, miljö, kommenterar den issuen (add_issue_comment) för att be författaren om den, och eskalerar bara ärendet till en människa om svaret uteblir.

Öppning av pull requests för mindre korrigeringar

På ett inaktuellt beroende, en stavfel eller en konfigurationsfil att rätta skapar agenten en gren (create_branch), ändrar berörda filer (create_or_update_file) och öppnar sedan pull requesten (create_pull_request). Den begär därefter en mänsklig granskning (create_review_request) och stannar där: på den här typen av flöde utlöses ingen sammanslagning någonsin utan en persons uttryckliga godkännande, även om de automatiska kontrollerna är gröna.

Uppföljning av CI-körningar och förberedelse av releaser

Agenten bevakar körningar av GitHub Actions-arbetsflöden (list_workflow_runs, get_workflow_run) och hämtar loggarna vid ett misslyckande (get_job_logs_download_url) för att förstå orsaken innan den varnar. Den granskar sedan redan publicerade releaser (list_releases) och förbereder, när alla kontroller är gröna, nästa release (create_release) med versionsanteckningar redo att godkännas av en människa innan publicering.

Kopplingens åtgärder

  • list_issues (läsning)

    Lista ett repos öppna issues.

  • get_pull_request (läsning)

    Läs detaljerna för en pull request.

  • list_workflow_runs (läsning)

    Lista senaste körningarna av Actions-arbetsflöden.

  • get_workflow_run (läsning)

    Läs detaljerna för en arbetsflödeskörning.

  • get_job_logs_download_url (läsning)

    Hämta URL:en till loggarna för ett jobb.

  • list_releases (läsning)

    Lista redan publicerade releaser.

  • create_label (skrivning)

    Skapa en ny label i repot.

  • update_issue (skrivning)

    Ändra en issue: labels, status, tilldelning.

  • add_issue_comment (skrivning)

    Lägg till en kommentar på en issue.

  • create_branch (skrivning)

    Skapa en gren från en referens.

  • create_or_update_file (skrivning)

    Skapa eller ändra en fil, med commit-meddelande.

  • create_pull_request (skrivning)

    Öppna en pull request från en gren till en annan.

  • create_review_request (skrivning)

    Begär en granskning från en eller flera personer.

  • create_release (skrivning)

    Publicera en release med tagg och anteckningar.

Förutsättningar

  • Ett GitHub-konto med skrivåtkomst till de aktuella repona.
  • En fine-grained token genererad från Settings, Developer settings, Personal access tokens.
  • Behörigheterna Contents, Issues och Pull requests i Read and write, Actions i Read.
  • Tokenet inklistrat i Atako, från Inställningar, Integrationer.
  • Ett uttryckligt grant: agent, anslutning, precisa åtgärder och omfång.

Så ansluter du

  1. 1

    Generera den fine-grained tokenet på GitHub

    Settings, Developer settings, Personal access tokens, Fine-grained tokens, Generate new token. Kryssa i Contents, Issues, Pull requests i skrivning och Actions i läsning, kopiera sedan tokenet som visas.

  2. 2

    Koppla tokenet i Atako

    Klistra in tokenet i Inställningar, Integrationer. Anslutningen blir tillgänglig för alla era agenter.

  3. 3

    Bevilja ett grant till agenten

    Från agentens sida väljer ni de precisa GitHub-åtgärderna och deras omfång. Som standard gäller deny-by-default: ingenting är åtkomligt från start.

  4. 4

    Starta det första scenariot

    Utifrån det beviljade grantet listar agenten issues, öppnar en pull request eller bevakar en CI-körning, och varnar om ett mänskligt beslut krävs.

Varför koppla en autonom agent till GitHub

GitHub samlar koden, issues, pull requests och CI-pipelines för ett tekniskt team. Det är naturlig mark för en autonom AI-agent i den mening Atako menar: den körs kontinuerligt i sin egen miljö och väljer sin egen väg, utan att vänta på utlösaren från ett klassiskt automationsverktyg.

Agenten agerar via precisa åtgärder som list_issues, create_pull_request eller get_workflow_run. Det är principen bakom tool calling: konnektorn exponerar en katalog av verkliga åtgärder, och agenten anropar de som är relevanta, utan att någonsin gå utöver det den beviljats. I ett scenario för triage av CI-incidenter bevakar den körningarna, korsar felloggar och öppnar en dokumenterad issue innan en människa upptäcker problemet.

En agent som körs hela natten behandlar issues löpande och förbereder pull requests så fort en korrigering identifieras. Se priser för att bedöma kostnaden utifrån volymen av agenter och aktiva anslutningar.

Begränsningar och bästa praxis

GitHub-åtkomsten fungerar enligt deny-by-default: ingen av de 37 tillgängliga åtgärderna är aktiv förrän ett uttryckligt grant beviljar den, åtgärd för åtgärd, i enbart läsning eller i skrivning. Det är den här mekanismen, inte förtroendet för agenten, som avgränsar vad den kan göra. Mänsklig kontroll är fortfarande rätt reflex för känsliga åtgärder: behåll create_review_request som valideringssteg innan all sammanslagning.

En autentiserad token är begränsad till 5 000 förfrågningar per timme enligt GitHub API:s officiella dokumentation, gott om marginal för normal användning men värt att bevaka om flera agenter delar samma token på ett mycket aktivt repo.

Vid sidan av den här klassiska integrationen erbjuder Atako också en intern funktion kallad Code, som låter en agent undersöka eller ändra ett repo mer direkt. Det är inte ämnet för den här sidan, men det är ett användbart komplement om era behov går utöver triage av issues och öppning av pull requests.

Relaterade användningsfall

Relaterade integrationer

Vanliga frågor

Kan agenten slå samman en pull request helt på egen hand på GitHub?

Åtgärden merge_pull_request finns och kan tekniskt beviljas en agent. Atako rekommenderar att förbehålla den och behålla create_review_request som mänsklig valideringspunkt innan all sammanslagning av kod.

Krävs en betald GitHub-plan för att koppla integrationen?

Nej, ett gratiskonto räcker så länge ni har skrivåtkomst till de repor som tokenet omfattar. Faktureringen beror enbart på ert Atako-abonnemang, inte på GitHub.

Hur återkallar man agentens åtkomst till GitHub?

Ta bort grantet från agentens sida i Atako, eller återkalla tokenet i GitHub, Settings, Developer settings, Personal access tokens. Åtkomsten stängs av omedelbart i båda fallen.

Läs härnäst

Källor

Romain Laodicina

CTO på Atako

Det här innehållet skrevs av Atakos AI-agenter och granskades, korrigerades och godkändes sedan av Romain Laodicina, CTO för Atako.

Driftsätt dina första AI-agenter

Skapa ditt konto gratis och starta en agent på några minuter, utan kod.

Ligg steget före inom AI.

Få produktnyheter, nya agenter och våra AI-analyser direkt i din inkorg. Ingen spam, avsluta prenumerationen när du vill.