Last updated: December 2, 2024
For an intro on command nodes and all non-AI commands, see Command nodes
When you trigger an AI command, the AI is given a prompt composed of a request + your data.
The challenge of writing prompts is that it's hard to get it right the first time. To get it right necessitates rapid iteration cycles where you can compare and contrast results, and you need to understand exactly what gets sent to AI when you run that command.
This is what the Prompt workbench was built for.
Many of the AI commands will ask for a prompt. The Prompt workbench is available for these, including:
Here's a quick primer on how it works:
${name}. For more, see below.Open GPT log monitorPrompt expressions in Tana are built like Title expressions, with some extra functionality:
${name}${field label}.${sys:context}${sys:tags}${sys:content} ${sys:currentDate} and ${sys:currentDateTime} respectively. Keep in mind that GPT doesn't know the current date or time natively. ${sys:nodeURL} and ${sys:nodeId} respectively.Reminder: Prompt expressions only work in nodes. They do not work if within references.
This operator will include the expanded owned content of references that are direct children of the target. This is handy if you want to include content that is not directly related to the node you're running the command on, if you want the results of a search node reference to be included, or if there are field values you want expanded in the prompt.
Can be run on a single node, a single field, or can be configured with prompts, batch processing, temperature etc. Accepts user-provided OpenAI keys.
A generic AI query command that streams content into Tana. Accepts user-provided OpenAI keys.
Making an API request involves specifying the API endpoint, choosing the appropriate HTTP method, providing any necessary headers or authentication, and handling the response from the API. This process allows different software systems to exchange data and functionality seamlessly.
Returns an AI-generated image using DALL-E.
Takes a list of children, gets embeddings, and does unsupervised clustering. Given that you have to manually specify number of clusters, this is more of an experiment until we have server-side processing.
System command that uses the field's context to fill empty AI fields
Sends an audio file to WhisperAI and returns a transcription.
Add tags using GPT interpretation
Send a meeting agent to a video call to transcribe what participants are saying. Many of these fields map onto the ones being synced by the Calendar integration.
Take a transcript (or any text), extract summaries and other things, put them in a target location.
Note: If all you define is the Transcript source, the processing agent will create a summary of the transcript, output as a child of the node.
Note: if no tags are defined, the processor will not look for anything specific and only run the summary.
Note: If you don't set targets, things are placed as children
EXAMPLE PROMPT:
GOAL:
- You are a senior UX researcher tasked with finding relevant “user observations”
in an onboarding transcript and reporting them back classified according to
the provided tags.
TASK:
- Find all moments in the transcript when the user experience any of the
described types of observation found in the supplied tags.
- You work for Acme Inc., and it is the experiences of the user - not the
team member - you want to observe and capture. The person with the #team acme
tag works at Acme Inc. The person being onboarded is tagged #person.
- Find at least 10 items, and at least 2 of each type.
${sys:context} gives context of node and children.${sys:context} will not convert. See FAQ on why prompt variables have to be plain nodes.256x256, 512x512, or 1024x1024 for dall-e-2. Must be one of 1024x1024, 1792x1024, or 1024x1792 for dall-e-3 models.dall-e-3, only n=1 is supported.Settings > Private keyboard shortcuts to the shortcut you just made and expand it. You'll find the command written out in a node.🙏 Thanks to Chuck for surfacing this excellent tip for all keyboard users out there doing incremental/bullet journaling and who find that command buttons just aren't their thing! For more stuff like this, join our community to share and learn about all things Tana 🫶
Use one keyboard shortcut to bring up a very specific set of commands.
For this example, we're going to build one command that brings up a set of commands for a bullet journaling practice. People who practice bullet journalling (or BuJo) usually decide on a list of keys or "signifiers": bullet symbols that mean different things to the writer. Here's an example of things that might be in this list:
In Tana, we can assume each item in the list is a separate supertag.
Bujo:".Bujo:. To test it, use the keyboard shortcut Cmd/Ctrl+Shift+P
Bujo: in the command lineThat's it 🙌
🙏 Thanks to many community members but especially Ready and Navigator Dee for surfacing this tip in a recent conversation! For more stuff like this, join our community to share and learn about all things Tana 🫶
To move all nodes to a single place when they get tagged. This is useful if you want nodes of a certain type to live in a place that makes sense for breadcrumb navigation.
For this example, we're going to build a command that moves all tagged nodes to the Library.
Library from the dropdown. There are other locations to choose from as well, and you can insert a reference to any node you want as the targetunchecked so it leaves a reference of the node in the original locationcheck it. This ensures that even when you use the Add tag action on a reference, it moves the original node to the desired location and not the reference (which won't achieve the goal of this command)To test it, use the supertag on a node:
That's it 🙌
Community member Jérémie asked: "I created a new supertag called #feedback to collect feedback from my team. They can easily add a comment and add the supertag. Is there a way to receive a notification when the tag has been added?"
Great question! Below was the solution that worked 👇 For more stuff like this, join our community to share and learn about all things Tana 🫶
Notify @[your tana account email]. Example: Notify @fei@tana.incTest the command by adding the supertag. You should
🙌 That's it!
🙏 Credit goes to Ulises RJ and Navigator Theo for coming up with this elegant solution! Join our community to share and learn about all things Tana 🫶
You want to build one command that toggles the state of something, like a checkbox. The key that unlocks this is the obscure Run commands in parallel command, and this is an excellent use for it. The uses for a toggle are endless; this example will demonstrate how to build a visibility switch for command buttons.
Let's call it the single-command toggle.
Note: This is more like a proto-command, something that isn't useful on its own, but unlocks many creative uses.
Always>NOT:: >is visible:: true (checked)Fields to set: >is visible:: true (checked)>is visible:: true (checked)Fields to remove: is visible (field definition)Commands to run, add references to the two commands you created earlierThe commands are now ready to go.
To configure the commands you want to toggle the visibility on, each command will need a node filter where the checked state of the is visible field determines whether they show up or not:
>Node filter:: >is visible:: true (checked)Test the command again by running the Toggle visibility command on the node. It should make the buttons appear/disappear.
🙌 That's it!
There is a command called Set view definition. It can set the Group, Sort and Display settings of a node view.
There is no good UX for this at the moment, so the instructions are not conventional nor friendly for beginners. But right now, this is one way of doing it:
When you run this command on a node, this should change the view settings according to your configuration.
Use Insert relative date command, here's an example:
The Autofill command can generate a new node title and description based on the URL.
To set up the command
Autofill fields commandAutofill title and Autofill description parameters to change bothModel to use to control which model you prefer. If left empty, Tana will pick the one that returns the answer with best quality and consistencyTo run the command
