Discord Setup Guide

Click here to introduce our bot to your server.

Go to our dashboard and click on the SparkAI Chat tab to get started

If you're unsure about setting up our bot, feel free to ask @communityone on Discord for guidance. Our bot is knowledgeable about its own features and can answer related questions directly. No need to provide any knowledge documents; you can see our bot in action right away!"

Spark setup consists of two parts: the Knowledge Center and Agents.

1. Knowledge Center: where you can set up everything related to your community knowledge. This includes .txt files and other third-party integrations such as Gitbook.

2. Agents: This is where you configure how Spark should behave, including custom instructions, conversation styles, and safety and compliance settings.

AI Agents

AI agents is where you can customize how our bot should behave across your various channels. You can add multiple agents for different purposes (e.g., testing and production) and for different style (short casual answers vs long technical details). To get started, just click on the "Add Agent" buttom.

Channel Configuration

1. Channel Configuration is the only required field for your AI agents to be functional.

2. You can set up multiple different channels with the same agent as shown above.

3. There are two different response modes:

   1. Every Message: This is our old instant response mode. It replies to every message, no matter what.

   2. Unanswered Questions: We will only answer when we detect that the user is asking a question and no one has responded to the question in the past x minutes. In addition, you can select whether we should respond to moderators or not.

AI Instructions - Highly Recommended

This is where you can add rules on what our mod should and should not do. You can instruct our bot on anything. The custom prompt is part of your Spark native "system prompt".

Conversation Style

Conversation style is a premium feature because we make an additional call for each message to ensure that it complies with your instructions. If you are using our free version, add your style instructions to the custom prompt, and your Spark should be able to adhere to most of your instructions.

With the Style guide, you can further specify HOW you want your Spark to talk. One of the most frequently requested features is to make Spark talk more like a human. Interestingly, different people have different thoughts on what constitutes a human-like interaction.

We made a separate input field for length so that you can control how long Spark messages should be.

AI Rules — A.K.A If x Do Y

You can set a certain number of conditions and ask Spark to say specific things. For example, if you think this is a spam message from the user, ask Spark not to repeat anything the user says. This is because sometimes spammers try to trick Spark into making an "official" announcement. Don't worry, we've built in a lot of security measures natively. A more common example can be, if a user has a question about x, tag this person or refer them to this website.

Customizing Agent Knowledge Sources

By default, every Spark agent has access to all the knowledge and integrations you've added in the Knowledge Center. However, you can restrict an agent so it only answers questions based on specific sources.

When creating or editing an Agent in your dashboard, look for the Knowledge Sources section:

1. Toggle "Customize knowledge sources for this agent" to enable selective knowledge.

2. Integrations: You can individually enable or disable access to specific third-party integrations (GitBook, GitHub, Notion, YouTube, Discord Knowledge, and Knowledge Gap Fill). (Note: These will only be clickable if you have already connected them in the Knowledge Center).

3. Text Documents: You can multi-select exactly which uploaded .txt files this specific agent is allowed to read.

Tip: Leave the toggle off if you just want the agent to use all available knowledge sources.

Safety & Compliance

If your server is sensitive and you would like to attach a disclaimer, you can add it here. Additionally, you can choose to display the disclaimer either once a day per user or with every message. Disclaimers will show up as a lightly italicized text font.

In addition, we've added two guardrail rules for all Spark Agents. One: Spark doesn't mention anyone. There may be instances where we would write "@everyone" in a message, but all messages are processed so that it is escaped and displayed purely as text. You can verify this by noticing that there is no highlighted background for these messages.

Second, we do not display clickable URLs unless we can find a relevant reference within the knowledge document. There may be instances where Spark may write "apple.com", but we have processed the content so that it is displayed as pure text.

Auto-onboarding

Auto-onboarding means that our bot will automatically open up a private channel when a new user is onboarding to your community. Our bot will greet the new user with your custom messages, and the new user can choose to chat with our bot.

Auto-onboarding is ideal if your server is relatively small and a few people are joining every day. It provides your new member with a "safe space" to engage and learn more about the community before joining the general chat. In addition, all channels will be deleted automatically after 24 hours of inactivity, so you don't have to worry about channel handles.

However, auto-onboarding is not recommended if you expect a large influx of users, as this will result in the creation of numerous private channels. Here is an example:

Agent Status

You need to designate one agent as your primary agent. This is the agent that we will use if someone tags Spark during onboarding. If you delete your primary agent, we will automatically assign the next available agent as the "primary agent".

Quick Fixes

You can get access to some of the most common configurations via Quick Fixes once you set up your agents.

• Auto-oboarding: You can turn on and off whether Spark creates private onboarding channels for new members.

• Response Type: You can configure whether Spark should respond to all messages instantly, or select questions when no one is answering questions.

Join Discord for questions, comments, and a little gift or back to CommunityOne Home