Dokumentation

Olika sätt att starta arbete

Vägarna som arbete kommer in till Coroid via, hur förfrågningar kvalificeras och vilka fyra utfall de kan leda till.

Arbete når Coroid från personer i portalen, i Slack eller Telegram, från dina egna system och assistenter och från Coroids egen automatisering. Nytt arbete, där en person beskriver arbetet i portalen, är en av vägarna in. Alla vägar leder till samma genomförandeflöde — specifikation, planering, implementation, verifiering, granskning, pull request.

VägAnvänd när
Nytt arbeteNågon vill ha något och är här för att beskriva det
Importera ärendenFörfrågan finns redan i Jira, Linear, Trello eller GitHub Issues
Fråga CoroidDu föredrar att beskriva det i ett samtal
Slack eller TelegramNågon ber om det i en chatt
Arbetsintags-APIEtt annat system skickar in förfrågan, till exempel ett formulär för funktionsönskemål i din produkt
Händelsebaserad automatiseringNågot i GitHub, Slack, Telegram eller Jira ska bli arbete
Coroid MCPEn assistent eller agent, till exempel Hermes, Codex eller Claude Code, hanterar arbetet
SchemanUtlösaren är en tidpunkt
HooksUtlösaren är en plattformshändelse
Rapporter och fyndEn rapport eller kvalitetskontroll har hittat ett problem som behöver åtgärdas

Förfrågningar

  • Nytt arbete

    Någon beskriver arbetet

  • Importera ärenden

    Från ett ärendehanteringssystem

  • Inkommande förfrågningar via API

    Din produkt eller en agent

  • Händelsebaserade automatiseringar

    En pull request, en kommentar eller ett meddelande

Kvalificering

Sållar bland förfrågningar, tar bort dubbletter och verifierar förfrågan, och avgör sedan vart den ska gå. Inget skapas förrän förfrågan har godkänts.

Blir

  • Uppgift
  • Plan
  • Rapport
  • Schema

Välj ett alternativ eller låt Skapa stå på Automatiskt, så väljer kvalificeringen åt dig.

Kvalificering kontrollerar inte dessa. De skapar arbete direkt:Fråga Coroid · I ett samtalSchemalagda körningar · Vid en viss tidHooks · Vid en plattformshändelseRapporter och fynd · Ett problem att åtgärdaCoroid MCP · En extern agent

Uppgifter och planer: specifikation, planering, bygga, verifiera, granska, pull request

Förfrågningar bedöms innan något skapas och blir sedan en uppgift, en plan, en rapport eller ett schema. Uppgifter och planer följer samma väg till en pull request.

Kontrolleras och dirigeras sedan

En förfrågan från Nytt arbete eller en import skapas inte så fort den kommer in. Den går först igenom kvalificering. Coroid söker efter känsliga värden, kontrollerar förfrågan mot den aktuella versionen, letar efter dubbletter, verifierar det som går och avgör vad den ska bli. Inget skapas innan den har godkänts. Se Beskriva vad du behöver.

Förfrågningar från arbetsintags-API går också igenom den, liksom händelser som en automatisering skickar till kvalificeringen.

Det kan bli en av fyra saker:

VägResulterar i
UppgiftEn enskild uppgift som avslutas med en pull request
PlanEn plan i flera faser som du godkänner innan koden skrivs
RapportEn genererad rapport
AutomatiseringArbete som körs enligt ett schema eller när något händer

I formuläret Nytt arbete kan du själv välja väg eller låta det stå på Automatiskt så får kvalificeringen välja. Om du väljer en väg men kvalificeringen rekommenderar en annan får du se rekommendationen och bestämma.

Fråga Coroid fungerar annorlunda. I assistentläget skapar chattassistenten uppgifter och planer direkt, utan kvalificering. En chatt för att förbereda arbete, det guidade SDLC-flödet, skickar sin godkända specifikation till kvalificeringen innan planeringen börjar. Se Chattassistent.

De andra vägarna skapar arbete direkt, utan kvalificering. Deras egna inställningar avgör vad som får starta. För MCP-servern handlar det om dess godkännanden och automatiseringspolicyer.

När arbetet startar

Ingen väntar i portalen på en förfrågan från arbetsintags-API eller en händelsebaserad automatisering. Coroid skapar arbetet inom några minuter efter att det har godkänts i kvalificeringen. Om en uppgift också startar av sig själv beror på var förfrågan kom ifrån:

KällaStartar automatiskt
Ett tjänstekonto som är inställt på att automatiskt starta godkänt arbeteJa
En GitHub pull request eller ett ärende vars författare har skrivbehörighet till repotJa
En kommentar på GitHub som nämner Coroid; detta gäller bara för användare med skrivbehörighetJa
Ett annat tjänstekontoNej
Slack, Telegram, Jira och alla andra källorNej

En uppgift som inte startar automatiskt väntar på att någon ska starta den. Kvalificeringen visar förfrågan som väntande på att någon ska starta den, med en länk till uppgiften. Planer startar aldrig automatiskt: de väntar på godkännande, som tidigare. Ett schema väntar på granskning tills någon bestämmer när det ska köras.

Coroid skapar arbetet med den första aktiva medlemmen i den här listan som ansvarig: personen som skickade in förfrågan eller konfigurerade automatiseringen, tjänstekontots skapare, projektets skapare och en organisationsägare.

En förfrågan som inte anger något projekt hamnar i organisationens enda projekt. Om det finns flera projekt väntar förfrågan på granskning i kvalificeringen, där granskaren väljer projekt när den godkänner den.

Uppgift eller plan?

Det användbara testet är hur lätt arbetet är att granska. Om det färdiga arbetet är en enda pull request som en kollega kan läsa igenom i ett svep är det en uppgift. Om det krävs flera ändringar i en bestämd ordning, eller om du vill godkänna tillvägagångssättet innan något byggs, är det en plan.

Om du är osäker, välj en plan för allt som är omfattande. Med en plan får du en godkännandepunkt innan koden finns, vilket är det enklaste tillfället att ändra dig. En uppgift som visar sig vara för stor får helt enkelt inte plats.

Importerade ärenden

Ärenden som importeras från ett ärendehanteringssystem går igenom samma kvalificering. Dubbletter, ärenden som redan har åtgärdats och förfrågningar som inte går att verifiera stoppas där, och resten blir uppgifter eller planer. En backlog är en önskelista, så det här filtret är viktigare för importer än för något annat. Se Importera arbete.

Från dina egna system

Ett annat system kan skicka in förfrågningar via arbetsintags-API: till exempel ett formulär för funktionsönskemål i din egen produkt eller ett supportverktyg som vidarebefordrar kundernas önskemål.

API behöver ett tjänstekonto, som ingår i Professional- och Enterprise-planerna. Skapa ett under Inställningar → Tjänstekonton. Dess API-nyckel behöver följande scope: intake:write. Nyckeln visas bara en gång, när du skapar den, och om du inaktiverar tjänstekontot nekas alla dess nycklar.

Skicka varje förfrågan till API-gatewayen med nyckeln som bearer-token:

curl -X POST https://api.coroid.ai/api/v1/organizations/work/intake \
  -H "Authorization: Bearer ak_…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Export invoices as CSV", "content": "Customers want to download their invoices as CSV from the billing page."}'
FältObligatorisktBeskrivning
titleJaEtt kort namn, högst 500 tecken
contentJaSjälva förfrågan, högst 20 000 tecken
projectIdNejProjektet som arbetet tillhör
workTypeNejtask, plan, report eller schedule
signalNejFelet, aviseringen eller ärendet som förfrågan kommer från, beskrivet nedan

Utan en arbetstyp väljer kvalificeringen väg. Kvalificeringen körs för varje API-förfrågan och går inte att hoppa över.

När förfrågan kommer från övervakning eller en annan automatiserad källa beskriver du dess signal. Coroid använder den för att känna igen samma incident när den rapporteras två gånger, i vilket projekt som helst, och för att utforma uppgiftens resultatkontrakt.

signal -fältObligatorisktBeskrivning
fingerprintJaEn stabil identifierare för incidenten, till exempel ärende-ID:t i ditt felhanteringssystem
sourceNejVar signalen kommer ifrån, till exempel glitchtip eller sentry
routesNejDe rutter som påverkas av incidenten, högst 50
minExposureNejHur många förfrågningar på dessa rutter som måste hanteras innan resultatet bedöms
urlNejEn länk till incidenten

Med routes och minExposure, är åtagandet mätbart: incidenten måste bli tyst. Utan dem dokumenterar åtagandet att det inte går att mäta. En mandat kan vägra att påbörja arbete som inte går att mäta.

En kvalificerad uppgift från ett tjänstekonto väntar på att någon ska starta den. En ägare eller administratör kan ändra detta för kontot under Tjänstekonton med den här inställningen: Starta kvalificerade arbetsuppgifter automatiskt. Aktivera den bara när allt kontot skickar in kommer från personer du litar på. Se När arbetet startar.

Händelser i GitHub, Slack, Telegram och Jira kan också bli förfrågningar, utan att någon behöver skriva in dem igen. En händelseautomation skickar dem till kvalificeringen. Se Utlösare och destinationer.

Från dina assistenter

En assistent eller agent som du kör, till exempel Hermes, Codex eller Claude Code, kan arbeta med Coroid via dess MCP-server. Den kan läsa dina projekt och ditt arbete samt skapa, köra och leverera arbete inom de behörighetsomfång du ger den. Arbete som den skapar går inte via kvalificeringen. Se Coroid som MCP-server.

Automatiskt inflöde

Scheman och hooks öppnar arbete utan att någon ber om det. Det enda som skiljer dem åt är utlösaren: tid eller en händelse. Båda är automatiseringar, som visas i fabriken och skapas under Nytt arbete.

Kvalitetskontroller leder också till korrigeringsarbete. När en kvalitetsregel granskar en rapport och hittar problem i produkten öppnar Coroid en korrigeringsuppgift för dem. Mjukvarufabrik → Granskning visar testfel som inte ägs av någon uppgift. Åtgärda gör om ett sådant fel till en korrigeringsuppgift.

Allt detta förbrukar agentplatser och modellbudget på riktigt. Ge automatiserat arbete lägre prioritet än arbete som någon väntar på – se Kapacitet och agentplatser.

I det här avsnittet