Features

AI Assistant

Learn how to use the Capacities AI Assistant for writing, thinking, and organization.

Cover

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.

If you use AI features in Capacities, some of your data will be shared with the selected model providers. You can find more information in our Terms and Conditions and our Privacy Policy. We describe the data that is shared with model providers with every feature below. No data will be shared if you don't use any AI features.

If you want to use AI features, you agree to with the terms of use of the model provider you select. You can find their terms on the respective website. Model providers may disallow the use of AI for illegal activity, the generation of hateful or abusive content, the generation of malware, and more.

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.

With Capacities AI, your data is only processed by model providers, but not stored nor used for training and other purposes.

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:

Provider	API Key Management Link	Model Information
OpenAI	OpenAI Platform	OpenAI Models
Gemini (Google)	Google AI Studio	Gemini Models
Anthropic	Anthropic Console	Claude Models
Mistral AI	Mistral Platform	Mistral Models
xAI	xAI Platform	Grok Models
Perplexity	Perplexity AI	Perplexity Models

API usage with chatbot subscriptionsSome chatbot application memberships, like the ChatGPT Plus subscription, do not include API key usage. You must set up a separate billing method for API usage for your model provider account.

Models availableOnly models that produce text output are available for usage within Capacities. If you're missing a model or a provider, please create a ticket in our feedback board.

Training DataIf you want to use your own provider, please review their terms and conditions before generating an API token to understand that provider's policies on training with user data.

Adding and Managing Keys

Go to Settings > AI Assistant > Custom AI Provider.
Click on + Add new API key.
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.

How are costs calculated?Usage costs are calculated based on the public model prices in US dollars per million tokens, and the consumed tokens during usage (input, output and cached input).

Model Selection Logic

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

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.
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.

ai collections

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:

Data protectionYour current object's properties, and the beginning of your notes in that object will be sent as a context to the AI.

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.

property auto-fill

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.

Error Message / Category	Potential Cause(s)	How to Fix
"Invalid API Key"	The API key entered is incorrect, contains extra spaces, or has been revoked by the provider.	Double-check the key for typos. Try generating a new key from the provider's platform and try again.
"Insufficient Funds" / "Rate Limit Exceeded"	The key's account has run out of credit, or the key is hitting a provider-set spending limit.	Top up your balance or check your billing setup on the provider's platform (e.g., OpenAI Billing). Increase the Max Budget setting for the key in Capacities.
"Model Not Found" / "Permission Denied"	The specific model you selected (e.g., a newer GPT-4 variant) is not enabled for your API key, or your access tier does not include it.	Check the provider's documentation and your account settings (e.g., OpenAI Rate Limits) to confirm model access. Select a different, more widely available model.
"Quota Exceeded"	Your usage has hit a time-based limit (e.g., tokens per minute) set by the provider for the model.	Wait a few minutes and try again. For continuous high usage, check the provider's platform to see if you can request a rate limit increase.
"Internal Server Error"	A temporary issue on the model provider's side.	Try again in a few minutes. Check the provider's status page (if available) for known outages.
"Browser extensions blocking the AI assistant"	Security or ad-blocking extensions may interfere with the request.	Try disabling browser extensions or use the dedicated Capacities desktop application.

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

Account & Authentication

You can find all settings related to your account and authentication in the app settings (bottom left cog icon).

AI Roadmap