Om Agenda te Outomatiseer

U kan kragtige werkvloeie skep deur Agenda te outomatiseer, wat op ’n hoë vlak gedoen kan word met byvoorbeeld Siri-kortpaaie of die Kortpaaie-toep, of op ’n lae vlak deur byvoorbeeld x-callback-url-ondersteuning. Die moontlikhede is eindeloos!

Toep-kortpaaie

Vanaf Agenda 15 is Toep-kortpaaie maniere om vinnig een of meer take in Agenda deur middel van die Kortpaaie-toep af te handel. Deur verskeie Agenda-kortpaaie te kombineer, opsioneel met dié van ander toeps, kan u u werkvloeie skep en outomatiseer. Van die eenvoudige oopmaak van ’n spesifieke nota vanaf die Tuisskerm van u iPad, of die aktivering van ’n nuwe nota ná ’n dubbeltik agterop u foon, tot komplekse werkvloeie wat al die dinge wat u vandag moet doen uit verskillende toeps gryp en met een tik ’n nuwe projek skep.

Agenda vir iOS ondersteun ook Siri-kortpaaie vir algemene aksies soos die oopmaak van ’n sekere nota, projek of oorsig.

Deursoek Notas in Kortpaaie

U kan die Deursoek Notas-aksie in die Kortpaaie-toep gebruik om notas te vind wat aan spesifieke kriteria voldoen. Dit is ook via x-callback-url beskikbaar. Soekbevrae ondersteun aksiesintaksis soos \color, \done, \pinned, en meer, wat u dieselfde krag as soektogte binne die toep vanuit u outomatiserings gee.

Siri

U kan Siri gebruik om u notas te deursoek en met Agenda te werk. Vra Siri byvoorbeeld net om iets in Agenda te soek, en u kan die resultate direk voorskou. Siri ondersteun ook ryker uitruil van data tussen Agenda en ander toeps.

Beheersentrum

Op iOS bied Agenda Beheersentrum-knoppies wat u toelaat om vinnig na die Vandag- of Op die Agenda-oorsigte te spring sonder om eers die toep oop te maak. U kan hierdie knoppies in u toestel se Beheersentrum-instellings byvoeg.

x-callback-url-ondersteuning

Agenda ondersteun ook x-callback-URL’e. Hierdie laat u toe om werkvloeie tussen toeps te koppel en/of sekere aksies binne Agenda te outomatiseer. Dit word ook deur Apple se Kortpaaie-toep ondersteun.

’n Vinnige inleiding tot x-callback-URL’e:

Die BA-skema is agenda of agenda-notes
Bevele sluit tans on-the-agenda, today, open-project, ens. in.
Vir “open-project” en “open-note” kan u die teiken met ’n title-parameter bepaal.
Soos gewoonlik kan u terugroep-URL’e verskaf via die opsionele x-success- en x-error-parameters.

Byvoorbeeld, om Agenda by ’n nota met die naam “Meeting With Peta” oop te maak, kan u hierdie BA gebruik: agenda://x-callback-url/open-note?title=Meeting%20With%20Peta

Nuut in Agenda 23: die move-note-aksie laat u toe om ’n nota tussen projekte te skuif vanuit ’n ander toep of kortpad: agenda://x-callback-url/move-note?title=Meeting%20With%20Peta&project-title=Archive

MCP (Model Context Protocol)-integrasie

Agenda bevat ’n ingeboude MCP-bediener op macOS wat KI-assistente toelaat om met u notas, projekte en kategorieë te werk. MCP is ’n oop protokol wat gereedskap soos Claude Code, Claude Desktop, Cursor en Codex gebruik om met toeps te kommunikeer.

Om die MCP-bediener te aktiveer

Die MCP-bediener is by verstek af. Om dit te aktiveer, gaan na die Agenda-kieslys en kies Integrasies > Enable MCP. Die bediener loop plaaslik op u Mac by http://127.0.0.1:16106/mcp en is slegs vanaf u eie masjien toeganklik.

Die Integrasies-kieslys bied ook opsies om konfigurasiebevele te kopieer om verskeie KI-gereedskap te verbind, sowel as ’n Claude Desktop-inprop wat direk afgelaai en geïnstalleer kan word.

Beskikbare gereedskap

Die MCP-bediener bied die volgende gereedskap vir KI-assistente om te gebruik:

Vind en lees

search_notes — Deursoek u notas volgens teks, etikette, datums en ander kriteria
get_note — Haal die volledige inhoud van ’n spesifieke nota op
get_selection — Kry die nota of projek wat u in Agenda gekies het, sodat u “hierdie nota” kan sê
list_projects — Lys alle projekte, opsioneel met inbegrip van gearchiveerdes
list_categories — Lys alle kategorieë
list_templates — Lys u notasjablone, om ’n nota uit een te skep
list_overviews — Lys u gestoorde oorsigte
list_attachments — Lys die lêers en tekeninge in ’n nota (nuut in Agenda 23.4)
get_attachment — Kry die oorspronklike lêer van ’n aanhegsel (nuut in Agenda 23.4)

Wys in Agenda

open_note — Maak ’n spesifieke nota in Agenda oop
open — Bring Agenda na vore en gaan na Vandag, Op die Agenda, ’n soektog, ’n projek of ’n gestoorde oorsig

Skep en verander

create_note — Skep ’n nuwe nota in ’n projek, met opsionele lêeraanhegsels
append_to_note — Voeg inhoud en/of lêeraanhegsels by ’n bestaande nota
edit_note — Wysig die inhoud van ’n bestaande nota, met opsionele lêeraanhegsels
move_note — Skuif ’n bestaande nota na ’n ander projek
trash_note — Skuif ’n nota na die asblik
untrash_note — Herstel ’n nota uit die asblik
create_project — Skep ’n nuwe projek
update_project — Hernoem ’n projek, skuif dit na ’n ander kategorie, verander die sorteervolgorde, argiveer dit, of skuif dit na die asblik en terug
create_category — Skep ’n nuwe kategorie
update_category — Hernoem ’n kategorie, verander die kleur, plaas dit onder ’n ander kategorie, of skuif dit terug na die boonste vlak

Uitvoer

export_pdf — Stoor notas, of ’n hele projek, as een PDF-lêer

Niks kan permanent deur MCP geskrap word nie. ’n Nota of projek wat ’n assistent na die asblik skuif, bly daar totdat u die asblik leegmaak, en kategorieë kan glad nie geskrap word nie.

Om KI-gereedskap te verbind

Om ’n KI-gereedskap aan Agenda se MCP-bediener te verbind, gebruik die konfigurasiebevel uit die Integrasies-kieslys, of stel dit handmatig op:

Claude Code:

claude mcp add --transport http agenda http://localhost:16106/mcp

Claude Desktop / Cursor: Gebruik npx mcp-remote http://localhost:16106/mcp as die bevel in u MCP-konfigurasie. As alternatief kan u die Claude Desktop-inprop direk vanuit die Integrasies-kieslys installeer.

Codex: Voeg die volgende by ~/.codex/config.toml:

[mcp_servers.agenda]
url = "http://127.0.0.1:16106/mcp"

Aanhegsels

Die create_note-, append_to_note- en edit_note-gereedskap ondersteun die byvoeging van lêeraanhegsels by notas. Aanhegsels word as base64-geënkodeerde data gestuur, sodat ’n KI-assistent ’n lêer van u Mac kan lees, dit kan enkodeer, en dit in een stap aan ’n nota kan heg. U kan byvoorbeeld u KI-assistent vra om “hierdie PDF aan my Vergaderingsnotas te heg” en dit sal die res hanteer.

Elke aanhegsel vereis ’n filename (met uitbreiding, sodat Agenda die lêertipe ken) en die base64-geënkodeerde lêer-data. U kan opsioneel beheer hoe die aanhegsel gewys word met displayStyle (inline, thumbnail, thumbnail-with-details, of full-width) en displaySize (small, medium, of large).

Beperkings: tot 20 aanhegsels per versoek, met ’n totale maksimum van 100 MB aan lêerdata.

Lêers uit ’n nota kry (nuut in Agenda 23.4)

’n Assistent kan ook ’n lêer weer uit ’n nota haal, byvoorbeeld om ’n PDF te lees wat u aangeheg het of om dit elders op te laai. Die list_attachments-gereedskap lys die lêers en tekeninge in ’n nota. Die get_attachment-gereedskap maak dan ’n leesalleen-kopie van die oorspronklike lêer, met die naam wat u in Agenda sien, en gee die assistent die ligging daarvan. Die kopie is tydelik: Agenda verwyder dit die volgende keer wat dit begin.

As u KI-gereedskap nie lêers uit Agenda se vouer kan lees nie, kan dit eerder die inhoud van die lêer direk vra (tot 100 MB, slegs lêers). ’n Vouer of pakket word as ’n vouer gegee, en ’n tekening word as sy voorskoubeeld gegee. Aanhegsels in vergrendelde notas is nie beskikbaar nie.

Hulpbronne vir hulp

Die MCP-bediener stel ook hulpbronne beskikbaar wat algemene onderwerpe uit die Agenda-dokumentasie dek, sodat KI-assistente kan naslaan hoe kenmerke werk en beter antwoorde oor Agenda kan gee.

Wat u kan vra

Sodra u KI-gereedskap verbind is, kan dit u notas op versoek lees en wysig. ’n Paar voorbeelde van wat goed werk:

“Vat my vergaderingsnotas van hierdie week saam in ’n nuwe nota in die Weekly Reviews-projek.”
“Vind enigiets wat met #followup geëtiketteer is en wat Anna noem, en lys dit.”
“Voeg die aksie-items uit hierdie PDF onderaan my Project Kickoff-nota by.” (die KI kan ook lêers heg)
“Skuif die ‘Q2 Planning’-nota van Drafts na die Strategy-projek.”
“Skep ’n nuwe projek genaamd Holiday en saai dit met ’n paklys.”
“Haal die faktuur-PDF uit my ‘March Billing’-nota en sê vir my wat die totaal is.”

Omdat die MCP-bediener plaaslik op u Mac loop, verlaat u notas nooit u masjien op pad na die KI-gereedskap nie — slegs die spesifieke teks wat die assistent lees of skryf word daardeur gestuur.

Probleemoplossing

As u KI-gereedskap nie Agenda kan sien nie:

Is MCP geaktiveer? Gaan Agenda > Integrasies > Enable MCP na. Die kieslysitem verander na Disable MCP wanneer die bediener loop.
Loop Agenda? Die bediener leef binne die Agenda-toep — as Agenda afsluit, stop die bediener saam daarmee.
Het die KI-gereedskap herverbind nadat MCP geaktiveer is? Sommige kliënte kas die verbinding by aanvang. Herbegin die KI-gereedskap as dit reeds geloop het voordat u MCP geaktiveer het.
Word poort 16106 deur iets anders gebruik? ’n Vinnige toets vanuit Terminaal: curl http://127.0.0.1:16106/mcp behoort ’n antwoord te lewer (nie “connection refused” nie).

Let wel: Die MCP-bediener is slegs op macOS beskikbaar.