Artificial intelligence has the potential to enhance our work and help us in our writing, thinking, and organization. Over time, Capacities will supercharge more and more workflows with the help of AI. The first step is the Capacities AI Assistant.

Overview

At the moment, Capacities supports the following AI features:

• AI Chats: If you want, you can start an AI chat based on your current note or the currently selected block. You can use commands to perform common tasks such as summarization and translation quickly. Any AI chat you started can be saved as an object to have permanent access to it.
• AI Panel: After selecting blocks in your content, you can quickly launch the AI panel to perform tasks such as translation, rewriting, or summarization.
• AI auto-tagging: AI identifies relevant tags from your existing tags and assigns them to that object. You can edit the selection if needed afterwards.
• AI collection selection: AI identifies relevant collections from your existing collections and assigns them to that object. You can edit the selection if needed afterwards.
• AI Property Auto-Fill: Rather than manually filling in the properties of your custom objects, you can rely on the AI model's knowledge to auto-fill them for you.
• Ask AI command: A quick and convenient way to ask a question without launching an AI chat. Simply type your question inside a new block in your content and then type "/Ask AI", and you will get a response to that question below.

Setup

Go to Settings > AI Assistant to activate and configure AI in Capacities.

Capacities AI

With your subscription, you get access to the Capacities AI. At the moment, the Capacities AI assistant uses the latest OpenAI GPT models.

You get a daily budget for the AI assistant. It is a budget for your Capacities account, not an individual space. You can see the status of your budget in Settings > AI Assistant.

Custom Model Provider

📺 Watch the setup video here.

If you want to use models from other providers or you need to use AI in Capacities beyond the daily budget, you can add an API key to add additional models to the Capacities AI. An API key is a unique credential that authenticates your account with a model provider, enabling direct access to their AI models in other applications.

You may connect your own API keys from a variety of leading LLM providers, giving you full control over the models you use and your usage limits.

Supported Providers

You can add API keys from the following providers:

Adding and Managing Keys

1. Go to Settings > AI Assistant > Custom AI Provider.
2. Click on + Add new API key.
3. Select the Provider and paste your API key.

Once a key is added, you can configure the following settings:

• Key Name (Alias): Set a recognizable alias (e.g., "Work Key," "Personal Billing") for the key. This name will appear in the model selection menu if you have multiple keys from the same provider.
• Available Spaces: Restrict this API key's usage to one specific space in your Capacities account.
• Max Budget: Set a monthly usage limit (in US dollars) for this key through Capacities. This is a safeguard against unexpected costs. It is set to unlimited by default.

Model Selection Logic

When using any AI feature, the Capacities AI Assistant attempts to use an available key in this order:

1. First custom key for the Current Space: From the API key settings, we'll automatically pick the first key (top to bottom) that is restricted to this particular space.
2. Capacities Default AI: If "Only use your own keys" is disabled, and no custom keys are set specifically for the current space, the Capacities AI (with its daily budget) will be used.

The AI Assistant model dropdown will display all models made available by your custom keys that are valid for the space you are in. If you have multiple keys from the same provider (e.g., two different OpenAI keys), the Key Name (Alias) will be displayed next to the model name (e.g., "GPT-5 (Work Key)").

AI Chat

You can launch the AI chat in the top left of the application by clicking on the "stars" icon or by using ⌘ + J on Mac or Ctrl + J on Windows.

You can start chatting right away.

Select a context

You can also choose to select some content from your notes to give the AI Assistant context. The content you select is passed to the AI as a reference.

Currently, the following options are available:

• A block selection
• The currently active object

If you select context first, you will get a floating AI chat window when you press Cmd + J. If you want to open it in the side panel, use Cmd + O (Mac) or Ctrl + O (Windows)

AI chat commands

If you have added some context, you have access to a range of commands to use with the AI chat. They are most valuable if used with a block selection.

You can trigger the command menu by typing / or +. There are several in-built commands that you can use:

1. Summarize
2. Continue writing
3. List key takeaways
4. Fix grammar
5. Simplify text
6. List TODOs
7. Translate to
8. List counter argument
9. Find evidence
10. Critique
11. Find research questions
12. Identify assumptions

After receiving a response from the AI, you can continue chatting to improve the result or ask follow-up questions.

Using the result in your notes

Once you have achieved your goal, you can select from different actions. You can choose them by clicking on the buttons or by pressing /

You can copy a message, replace your selection with the message, or append it to your active document.

If you want to start the chat again or use a different prompt, go to your original message, click the three dots, and 'rephrase'.

Saving AI chats as objects

You may want to save your most important or eye-opening AI chats for further reference. This brings you all the functionalities that other objects have:

• Organize your favorite AI chats in collections.
• Tag them to relate them to relevant topics.
• Use the object dashboard to get an overview of all your AI chats.
• Link to your AI chats from within any other content.
• Search your whole conversations via the full-text search.

Hover over the top of the AI chat and click the 'Save as object' button to do this.

Once you've saved the chat, you can open it on its own screen. Here you can add tags, add it to collections, and rename it for easy referencing from other content later.

If you have used any context for the chat, the saved AI chat will be referenced in that object's backlink section. You can also reference the AI chat as you would any other object, via the usual @ or [[]] commands. This helps truly integrate the AI chat into the rest of your knowledge work.

These saved chats are also fully searchable via the full-text search. The search results will take you to the message that holds the search term which allows you to quickly find content you know you've saved.

AI assistant on mobile

The AI assistant is especially helpful if you're on the go. It is fully supported in our mobile app except for the use of commands.

To launch the AI assistant in the mobile app, you can select a context (e.g., a block selection or by opening the corresponding note), then press the "AI Assistant" button. Saving your favorite AI chats as objects is supported on mobile too.

AI Panel

The AI panel is a quick way to perform tasks such as translation, rewriting, or summarization. The panel floats over the top of the text.

To open it, select text and click on the 'sparkle' icon that appears in the context menu.

The panel provides quick actions like Summarize, Translate, Improve Writing, and more. You can see the full list when you open the panel.

Ask AI command

If you don't want to launch the AI chat, there is a quick and convenient way to ask a question.

Type your question into a new block in your content and then type "/Ask AI"

You will get a response to that question below.

AI Auto-tagging

Tags are an important organizational structure in Capacities, and AI can help you use them.

AI identifies relevant tags from your existing tags and assigns them to that object. You can edit the selection if needed afterwards.

This option appears anywhere you see tags for an object.

Here's a video where you can see this in action:

AI Collection selection

Similar to the AI Auto-tagging, you can also use AI to select collections for your objects. Simply click on the AI button in the collection picker. The AI will then select the most relevant collections for your object. It will not create new collections but only select existing ones.

AI Property Auto-Fill

You can also use AI to auto-fill your properties. This allows you to quickly insert a fact summary or use the AI's knowledge so you don't have to research it.

This works for the following properties:

• Text
• Description
• Object select properties
• Date
• Number

You can activate the AI property auto-fill in the property settings. You can also choose to add more instructions in the property settings to get more accurate results.

It's important that you first add content to some other properties (at least the title) so the AI has some context to fill your property.

After activating auto-fill for your property, you can simply click on the button that appears in your property field when you hover over it.

If you have several properties with AI autofill, hover over the title of the object and click 'Fill properties' to fill them all at once.

Adding additional instructions to your property auto-fill

If you're not happy with the result, you can add additional instructions to your property auto-fill in the property settings.

Additional instructions are added to the context that is sent to the AI. This allows you to give the AI more information about what you want to achieve.

Here are some examples:

• Keep in mind that this is a summary for a mathematical concept. Keep it simple and concise.
• This property should be a short summary of the main idea of this book. Do not include any details and keep it to 2 to 3 sentences.
• Do not make things up. Only use information that is already in this object.

You might need to play around with different options. It helps to be very specific. You are also welcome to share your best practices in our community.

What's next

We envision AI to be used in every layer of Capacities to make your workflows simpler, faster, and more powerful. Read more about our AI roadmap.

If you have any ideas, problems, or feature requests, please let us know on the feedback board.

Error Messages

If you encounter an error message while using the AI assistant, the root cause is usually related to your API key, budget, or access permissions for the selected model provider.

FAQs

• How can I set up the AI Assistant in Capacities?
  You can configure the AI Assistant settings under Settings > AI Assistant where you can activate or hide all AI features. Additionally, you can bring your own API key from a model provider if you wish to use other models or use the AI assistant without any budget limits.
• What data is shared with the model provider when using Capacities AI features?
  If you use AI features in Capacities, some of your data will be shared with the selected model provider. You can find more information in our Terms and Conditions and our Privacy Policy. No data will be shared if you don't use any AI features.
• Is there a limit on how much I can use the AI Assistant in Capacities?
  Yes, the Capacities AI has a daily budget which will be dynamically adjusted. If you exceed this limit and wish to continue using the AI Assistant without disruption, you can add your own API keys from a model provider in Settings > AI Assistant > Custom AI Provider.
• Can I use the Capacities AI Assistant to automatically fill in properties in my objects?
  Definitely. Capacities offers an AI Property Auto-Fill feature which uses the AI's knowledge to auto-fill properties for you. You just need to activate AI auto-fill in the property settings, and ensure you have added some context like the title for the AI to work with.
• Is it possible to save AI chats as objects within Capacities? How can they be utilized later?
  Yes. You can save AI chats by clicking the Save as object button. These saved chats function as objects that you can organize in collections, tag, and link to for easy referencing. They're searchable via full-text search and appear in backlink sections of related objects.
• Can I bring my own API key to use with the Capacities AI Assistant?
  Yes. You can bring your own API key to use the AI assistant without any limits. You can read more about it in the Custom Model Provider section.
• Can I have multiple chats open?
  You can have multiple chats open. Just use the AI button or the shortcut again.
• Can AI Chats be exported?
  Yes, save the chat as an object then you can use any of the existing export options
• Can I use European-only models?
  You can bring your own Mistral API key and toggle on 'Only use my own keys' in Settings > AI Assistant > Preferences. Capacities' AI uses OpenAI, but by toggling this option on, you are replacing Capacities AI with your European model provider.
• Can I use local-only AI models?
  Not at this time, but we have this on the radar and may add it in the future. To be kept up to date, please vote here: https://feedback.capacities.io/p/expansion-of-ai-features-to-include-private-llm-local-and-azure-open-ai
• Can I use custom AI models?
  Not at this time, but we have this on the radar and may add it in the future. To be kept up to date, please vote here: https://feedback.capacities.io/p/expansion-of-ai-features-to-include-private-llm-local-and-azure-open-ai