Bedste praksis for oprettelse og optimering af en Tilpasset agent

En veldesignet Tilpasset agent bruger færre Notion-kreditter og leverer bedre resultater. Her er hvordan du får mest muligt ud af hver kørsel:

• Brug Tilpassede agenter til tilbagevendende arbejde. Til engangsopgaver skal du i stedet bruge Notion-agent – den er inkluderet i dit Abonnement. Tilpassede agenter kører på Notion-kreditter, fordi de arbejder autonomt i baggrunden, uanset om du er online eller ej.

• Vælg specifikke Udløsere. Udløs på specifikke @-omtaler eller egenskabsændringer, ikke hver besked eller databaseopdatering. Færre falske starter, færre spildte kørsler.

• Hold konteksten stram. Peg din Tilpasset agent mod de specifikke sider eller databaser, den har brug for. På den måde læser den kun det, den skal, og hver kørsel forbliver fokuseret.

• Definer “Færdig” på forhånd. Fortæl din agent præcis, hvordan en fuldført kørsel ser ud. Jo renere instruktionerne er, jo hurtigere når den frem til resultatet.

• Batch uafhængige opgaver. Bed for eksempel din agent om at læse flere kilder på én gang i stedet for én ad gangen.

  • ✅ "Læs Projects-database og #support Slack-kanalen, og skriv derefter den ugentlige opdatering."

  • 🚫 "Læs Projects-database, og skriv derefter den ugentlige opdatering. Læs derefter #support Slack-kanalen, og tilføj til den ugentlige opdatering."

• Start med en eksisterende agent, når arbejdsgangen ligner. Hvis en arbejdsgang, du har brug for, allerede findes som en Tilpasset agent, skal du duplikere den i stedet for at bygge den fra bunden. Åbn agenten, vælg ••• og vælg dupliker.

  • Kopien er som standard privat.

  • Efter duplikering skal du godkende værktøjer som Slack igen, kontrollere at Udløsere blev overført som forventet, og geninstallere eventuelle Workers – de er ikke inkluderet i kopien. Dette er især nyttigt til hurtigt at oprette team-varianter af en fungerende agent. Lær mere om duplikering af en Tilpasset agent i denne artikel.

Tilpassede agenter er mest pålidelige, når de har en klar opgave, de rigtige kilder og en præcis definition af “Færdig”. Denne artikel om bedste praksis dækker, hvordan du skriver bedre instruktioner, vælger de rigtige Udløsere og forbedrer resultater over tid.

Hvis du ikke er sikker på, hvor du skal starte, så begynd med det arbejde, dit team ofte udfører. Tilpassede agenter er mest effektive, når arbejdsgangen er forudsigelig og nem at gennemgå.

Se efter arbejdsgange, der er:

• Gentagelige, såsom at udarbejde rapporter, prioritere indgående anmodninger eller besvare almindelige Slack-spørgsmål

• Hyppige, hvilket betyder, at de sker dagligt eller ugentligt

• Let at evaluere, så du hurtigt kan se, om resultatet er korrekt

Når du har valgt en arbejdsgang, skal du først bygge den enkleste version af din agent. Få den til at køre stabilt, før du tilføjer kompleksitet.

Når processen føles stabil og forudsigelig, kan du tilføje Udløsere eller tidsplaner for at automatisere den fuldstændigt.

Når du giver din Tilpassede agent klare instruktioner, producerer den mere konsistente og pålidelige resultater. Fokuser på, hvordan succes ser ud, og giv den den kontekst, den har brug for for at levere det.

Start med det resultat, du ønsker

• Beskriv, hvordan det endelige resultat skal se ud, frem for at opremse hvert trin

• Lad agenten bestemme, hvordan den når dertil

• Eksempel: "Opret en ugentlig statusopdatering, der opsummerer fuldførte opgaver, blokeringer og næste skridt."

Del et konkret eksempel

• Indsæt en tidligere statusopdatering, formateret rapport eller prioriteret anmodning

• Brug konkrete eksempler i stedet for abstrakte beskrivelser

Vær tydelig omkring format og destination

• Angiv, hvor resultatet skal sendes hen (Slack, en database eller en eksisterende side)

• Angiv, hvilke egenskaber eller sektioner der skal udfyldes

• Eksempel: "Slå opsummeringen op i #team-updates, og tilføj den til databasen Weekly Reports."

Opsæt enkle grænser

• Afklar, hvad agenten skal gøre, og hvad den skal undgå

• Eksempel: "Opdater den eksisterende ugentlige rapportside, ikke en ny," eller "Svar kun i #support."

Nævn grænsetilfælde

• Forklar, hvad der skal ske, hvis der ikke er nogen data eller intet nyt at rapportere

• Eksempel: "Hvis der ikke er nogen opdateringer i denne uge, så skriv 'Ingen opdateringer' i stedet for at springe over."

Hold instruktionerne korte og fokuserede

• Kortere instruktioner giver mere konsistente resultater

• Hvis din opsætning bliver lang, så opdel arbejdsgangen i flere agenter

Når du opsætter din Tilpassede agent, skal du beslutte, om arbejdet skal køre efter en tidsplan, som reaktion på en Handling eller begge dele.

Brug tidsplaner til forudsigeligt arbejde

• Vælg en tidsplan, når opgaven skal køre med en fast kadence, uanset aktivitet.

• Ideelt til tilbagevendende arbejde som ugentlige rapporter, daglige briefinger eller månedlige sammendrag

Brug Udløsere til responsivt arbejde

• Vælg en Udløser, når opgaven skal køre som reaktion på, at noget sker.

• Eksempler inkluderer en programfejl rapporteret i Slack, en ny side tilføjet til en database eller en e-mail fra en bestemt afsender

Kombiner tidsplaner og Udløsere efter behov

• Nogle arbejdsgange har to mønstre

• For eksempel kan én Udløser-baseret agent triagere programfejl, efterhånden som de kommer ind, mens en separat planlagt agent samler et ugentligt sammendrag af de triagerede programfejl

Start med lavere frekvens og Limited omfang

• Begynd med en ugentlig tidsplan i stedet for daglig

• Start med én kanal i stedet for fem

• Skaler op, når du har bekræftet, at resultatet er konsistent og pålideligt.

Før du aktiverer din arbejdsgang fuldt ud, bør du bruge tid på at teste og justere din opsætning.

Test før aktivering af Udløsere eller tidsplaner

• Klik på Kørsel for at udføre agenten manuelt

• Gennemgå resultatet for at bekræfte, at det opfører sig som forventet

• Slå først Udløser eller tidsplan til, når resultaterne ser rigtige ud

Test med en lille gruppe

• Del agenten med et par Teammedlemmer for at indsamle Feedback

• Brug tidlig Feedback til at fange problemer, før du udruller den bredere

Forvent iteration

• De fleste agenter kræver flere testkørsler for at blive helt rigtige.

• Forfin instruktionerne baseret på, hvad resultatet faktisk viser, ikke hvad du havde til hensigt, at instruktionerne skulle sige.

Tjek aktivitetslog først

• Klik på ur-ikonet for at se, hvad der udløste kørslen.

• Gennemgå, hvad agenten gjorde, og hvor den eventuelt fejlede

• Brug log til at diagnosticere problemer og bekræfte, at agenten opfører sig som forventet, før du udvider adgangen

Kend de almindelige rettelser

• "Forkert resultat" betyder normalt, at instruktionerne har brug for mere specificitet

• "Manglende data" betyder ofte, at agenten har brug for adgang til yderligere sider eller databaser under

  Værktøjer og adgang

• "Mislykkede kørsler" peger typisk på en tilladelsesbrist eller uklare instruktioner

En veldesignet agent kører hurtigere og undgår unødvendigt arbejde. Tre faktorer påvirker effektiviteten:

• Hvor ofte agenten kører,

• Hvor meget indhold agenten læser, og

• Hvor mange trin agenten tager for at fuldføre en opgave

Den nemmeste måde at forbedre ydeevnen på er at begrænse unødvendige kørsler. Design udløsere, så agenten kun kører, når det er sandsynligt, at den skal handle.

Start småt og skaler op

• Begynd med ugentlige kørsler i stedet for daglige

• Brug én arbejdsgang, før du udvider til flere

• Øg hyppigheden, når resultaterne er pålidelige

Brug udløsere med højt signal, så din agent kun kører, når det er nødvendigt

• For Slack: Udløser på @-omtale eller en specifik emoji-reaktion i stedet for alle beskeder

• For Notion: Udløser på specifikke egenskabsændringer i stedet for hver databaseopdatering

• For Notion Mail: Udløser på et filtreret sæt e-mails i stedet for hver besked

Forvent nogle kørsler af typen “Ingen handling påkrævet”

• Disse sker, når agenten fastslår, at der ikke er noget at gøre

• Dette er normalt og effektivt – agenten tjekker kun udløseren og instruktionerne, før den afsluttes

Jo mere indhold en agent læser, jo mere arbejde kræver hver kørsel. Hold omfanget begrænset.

• Peg agenten mod det mindst mulige omfang. Ideelt set en enkelt side eller et par sider, der linker til undersider, som agenten kun kan indlæse, hvis det er nødvendigt.

• Undgå at bede agenten om at søge bredt, hvis du allerede ved, hvilken database eller side agenten skal bruge som kilde til sandheden.

Hvert ekstra trin i en kørsel tilføjer arbejde, især når Tilpassede agenter udfører flere søgninger.

• Vær eksplicit omkring definitionen af Færdig, så agenten bliver færdig på færre trin.

• Det er mere effektivt, hvis agenten kalder flere værktøjer på samme tid. Tilskynd til parallel brug af værktøjer i dine instruktioner, når det er muligt.

  • Kan køre på samme tid: \"Læs Projekter-databasen, Engineering Slack-kanalen og siden med de seneste sprintnoter på samme tid.\" Disse tre kilder er uafhængige, så agenten læser dem alle samtidigt i stedet for én efter én.

  • Skal køre i rækkefølge: \"Opret en /sammendrag-side i Reports-database, og post derefter linket til #team-updates i Slack.\" Agenten har brug for side-URL'en, før den kan poste linket, så disse trin sker sekventielt.

Hvis agenten ofte stiller flere opfølgende spørgsmål, forsøger den samme handling igen, tjekker de samme sider igen eller fejler på forudsigelige måder, skal instruktionerne eller indstillingerne forbedres.

• Hvis kørsler ofte fejler på grund af tilladelser (ikke at have adgang til at svare i Slack eller en ikke-betroet URL), skal du justere agentens adgang under Tools and access eller fortælle agenten i instruktionerne, at den skal undgå disse handlinger.