Starta din första agent

Det här bygger du

När du är klar med den här guiden har du:

• En agent som du själv har skapat och konfigurerat
• En yta där du och agenten pratar
• En avslutad körning, med incheckat arbete i en isolerad worktree och en rad i agentens körningslogg

Förkunskaper: Din första arbetsyta slutförd, så att arbetsytan har ett repo registrerat och minst en modellleverantör ansluten.

Steg 1: Skapa en agent

1. Gå till Inställningar → Arbetsyta → Agenter
2. Klicka på Ny agent. En agent som heter “Namnlös agent” skapas direkt och markeras i personallistan – det finns ingen skapandedialog och inget att bekräfta. Du konfigurerar den på plats.
3. Fyll i följande på fliken Inställningar:
   • Namn: något kort och lätt att komma ihåg, som alice. Det är det du skriver efter @.
   • Titel: vad den gör, t.ex. “Backend-utvecklare”
   • Adapter: Control Center (built-in). Välj den här medvetet – bara den inbyggda harnessen kan styras under en körning och pausas vid en turgräns, och den kräver inget CLI installerat på servervärden.
   • Modell: välj ur listan som den anslutna leverantören erbjuder
   • Färdigheter: koppla på de som passar, t.ex. testing eller architecture
4. Tryck på Spara ändringar

En agent utan adapter körs på den inbyggda loopen

När fältet Adapter är tomt faller dispatchningen tillbaka på Control Center (built-in) – agentloopen inuti servern, så det finns inget att installera på värden. Den behöver fortfarande en modell: utan någon angiven frågar den Anthropic efter sin standardmodell, vilket fungerar om du har anslutit ett Anthropic-konto och annars misslyckas med No credential for provider "anthropic". Ange båda uttryckligen ändå, annars kör du på en modell du inte har valt.

Kontrollpunkt. Raden i personallistan visar agentens namn och en ihålig statusring.

Steg 2: Starta en yta

1. Leta upp avsnittet Ytor i sidomenyn och klicka på +-knappen
2. Ge ytan ett namn
3. Välj agenten du just skapade under Lägg till agenter
4. Om arbetsytan har några repos väljer du vilka den här ytan ska arbeta mot
5. Klicka på Skapa

Ytan öppnas. I bakgrunden etablerar Control Center en copy-on-write-worktree av de valda repona för det här samtalet, på en egen gren. Din källkodsutcheckning muteras aldrig.

Steg 3: Skicka en uppgift

Skriv en konkret, liten uppgift mot repot du registrerade. Något med ett kontrollerbart utfall fungerar bäst – lägg till ett test, rätta en lint, byt namn på en symbol.

Tryck på Enter. Du behöver inte @-nämna någon: med en enda agent i ytan räcker ett vanligt meddelande för att väcka den. I en yta med flera agenter väljer @name en av dem.

Control Center sätter ihop prompten från agentens instruktioner, persona, skills och ytans kontext och skickar sedan i väg körningen.

Kontrollpunkt. Skicka-knappen i composern blir en stoppknapp – en agent arbetar i det här samtalet – och text börjar komma in.

Steg 4: Se den arbeta

Samtalet visar körningen medan den pågår:

• Resonemang, som visas infogat medan agenten tänker
• Verktygsanrop: filläsningar och filskrivningar, sökningar, skalkommandon, var och en med sitt resultat
• Text: sammanfattningar, förklaringar och frågor till dig

Om agenten frågar något svarar du i samtalet och den återupptas.

För en körnings egna mätvärden och dess kontroller för pausa, återuppta och stoppa letar du upp den körande agenten i avsnittet Agenter i ytans panel Allmänt och väljer Öppna aktivitet.

I aktivitetsrutan visar statusmärket Körs och sedan Lyckades när körningen tar slut. En körning som står stilla eller loopar visar Blockerad; en som får fel visar Misslyckades. I agentregistret är personallistans ring ihålig före den första körningen och fylld när agenten är inaktiv igen.

Vad som begränsar körningen: dess egen copy-on-write-worktree, de inloggningsuppgifter som förmedlas till den vid start och återkallas vid avvecklingen, en sanerad miljö, verktygsytan dess läge tillåter och åtgärdsräckena. Sidoeffekter som att pusha en gren eller öppna en pull request grindas separat – se Räcken.

Steg 5: Kontrollera resultatet

1. Öppna Inställningar → Arbetsyta → Agenter och välj din agent
2. Öppna fliken Loggar

Kontrollpunkt. En körningsrad som visar dess status, varaktighet, start- och sluttider och adaptern den kördes på.

Agentens ändringar checkas in på samtalets gren, i dess worktree. Commitarna författas som agenten, med dig krediterad i en Co-Authored-By:-rad.

Skaffa en pull request

Ingenting öppnar en pull request av sig självt. Om du vill ha en ber du om den i samma samtal:

Pusha den här grenen och öppna en pull request mot standardgrenen.

Att pusha (gitPush) och att skapa en PR (prCreate) frågar båda efter ditt godkännande som standard, så räkna med en bekräftelse före varje. Om ingen godkännare är ansluten när frågan ställs nekas åtgärden i stället för att tillåtas – räckena faller stängt.

PR:en öppnas under den GitHub-identitet vars token körningen använde – din, om du har lagrat en personlig token – inte under agentens namn. Agentens författarskap syns på commitarna.

Du kan också öppna den själv: ytans panel Källkontroll har en knapp Skapa pull request som tar med samtalets gren in i PR-utkastet, och Pull requests → Ny PR öppnar samma skärm tom. Det är där nästa guide tar vid.

Sammanfattning

Du skapade en agent, konfigurerade dess adapter och modell, gav den en yta och en uppgift och såg en riktig körning slutföras i en isolerad worktree utan att röra din källkodsutcheckning.

Nästa: Granska din första pull request för att lära dig granskningsflödet.

Mer om agenter: Agentmodellen. Mer om dispatch: Livscykel för agentdispatch.