Skip to main content
BETA This feature is currently in active development and is subject to change.
Overview

​
Overview

Ravenna lets you create and deploy custom AI Agents directly into your Slack channels. Build agents that triage requests, answer questions, and automate routine tasks. All configured through natural language prompts. Customize everything from response logic and tool integrations to personality, tone, and communication style. Whether you need instant FAQ responses, intelligent ticket routing, or automated workflows with third-party tools, Ravenna Agents can handle it.

​
Setting Up

Setting Up an AI Agent

For a detailed walkthrough on creating and deploying AI Agents, please refer to our Getting Started guide.

​
Capabilities

​
Skills

Skills are specialized instructions that define how your agent handles specific scenarios. Each skill teaches your agent a particular capability using natural language prompts. You can @ mention Ravenna resources like Forms, Knowledge Folders, and Tools to give your agent context-aware abilities.

​
What are skills?

Skills are the building blocks of your agent’s behavior. Each skill contains:
  • Title: A descriptive name for the skill (e.g., “Password Reset Handler”)
  • Instruction: Natural language instructions that tell the agent what to do and when
  • Enabled/Disabled toggle: Control whether the skill is active

​
When to use skills

Use skills when you want your agent to:
  • Handle specific types of requests consistently
  • Route requests to the correct Form
  • Reference specific Knowledge sources for answers
  • Follow a defined process for common scenarios
  • Provide specialized responses for particular topics

​
Writing effective skills

Be specific about triggers: Clearly define when the skill should activate.
When a user asks about password resets, account lockouts, or login issues...
Reference resources with @ mentions: Use @ to link to specific Ravenna resources.
Check `@IT Knowledge Base` for relevant articles before responding.
Create a ticket with `@Form - Password Reset` if action is needed.
Define the expected outcome: Tell the agent what success looks like.
Inform the user that their request has been logged and provide the ticket number.
Keep instructions focused: Each skill should handle one type of scenario. Create multiple skills for different use cases rather than one complex skill.
Knowledge-first response
When a user asks a question, first check `@IT Knowledge Base` for relevant 
articles. If you find an article that answers the question, provide a summary 
and link to the article. If no articles are found, create a support ticket 
with `@Form - General Inquiry` and inform the user that their request 
has been logged.
Password reset handling
When a user requests a password reset or reports being locked out of their 
account, create a ticket with `@Form - Password Reset`. Confirm to 
the user that their request has been submitted and that IT will process it 
shortly.
Software access requests
When a user requests access to software or applications, ask them to specify 
which application they need and their business justification. Then create a 
ticket with `@Form - Software Access Request` including the details 
they provided.
Hardware issues
When a user reports hardware problems (laptop, monitor, keyboard, mouse), 
first ask clarifying questions about the issue. Then create a ticket with 
`@Form - Hardware Support` and let them know an IT technician will 
follow up.
  • Use clear, conversational language: Write instructions as if you’re explaining to a colleague
  • Break complex logic into steps: Number your steps for multi-part processes
  • Include fallback behavior: Tell the agent what to do if the primary action isn’t possible
  • Specify tone when needed: Add guidance like “respond empathetically” for sensitive topics
  • Workflows: Workflows are not currently supported natively within Skills. To trigger workflows, create a workflow that activates on ticket creation for a specific Form, then have your skill create tickets with that Form.
  • Form access: You must reference Forms within skills for the agent to create tickets of that type. Your agent does not have access to all Forms by default.
  • Skill conflicts: If multiple skills could apply to a request, the agent uses its judgment to select the most appropriate one. Keep skills distinct to avoid ambiguity.

​
Tools

Tools extend your agent’s capabilities by connecting to external integrations. Tools are available through integrations that support tool actions—once an integration is installed, its tools become available to reference within your Skills.
Tools are used within Skills by @ mentioning specific tool actions. When writing a Skill, you reference tools to tell the agent exactly when and how to use them.For example, if someone messages about their device being slow:
Device Troubleshooting Skill
When a user reports their device is slow or having performance issues, `@Look up device with Fleet` to get the device information, then `@Run query with Fleet` to check system diagnostics. Analyze the returned information and provide basic troubleshooting steps based on what you find.
Tools require the corresponding integration to be connected to your organization. If an integration is disconnected, tools for that integration will show a warning indicator.
Tools are organized by integration. Available tools include:Fleet (Device Management)
  • Host Info - Get basic information about a user’s device (hostname, platform, OS version, status)
  • Host Health - Check the health status of a device
  • List Queries - List available saved queries
  • Run Saved Query - Execute a saved query on a device
HubSpot (CRM)
  • Search Contacts - Find contacts by email address
  • Search Companies - Search for companies in HubSpot
  • Search Deals - Search and filter deals
  • Get Deal - Retrieve details about a specific deal
  • List Deals - List deals with optional filters
  • List Owners - List HubSpot users/owners
Ravenna
  • Web Search - Search the web for information relevant to user queries

​
Knowledge

Select specific Knowledge Folders for your agent to access when answering user questions. This ensures the agent provides accurate and relevant information based on your organization’s knowledge base.

​
Identity

​
Personality

Provide a custom prompt to define your agent’s personality, tone, and communication style. This prompt will guide how the agent interacts with users.
Avoid including instructions about tools/processes in this section.** Focus on the agent’s character and manner of speaking.
Select the desired length of the agent’s responses: Concise, Balanced, or Verbose.
Choose the tone of the agent’s communication: Business, Casual, or Humourous.
Set whether the agent should use emojis in its responses and if so, how often: None, Minimal, Moderate, High

​
Slack

Define how the agent should respond to messages in Slack channels.
  • Respond to all messages - The agent will reply to every message in the channel.
  • Respond to mentions only - The agent will only reply when directly mentioned.
  • Respond to requests only - The agent will only reply to messages that are detected as requests for assistance.
Define how the agent should respond to messages in a Slack thread.
  • Respond to all messages - The agent will reply to every message in the thread.
  • Respond to mentions only - The agent will only reply when directly mentioned.

​
Response elements

Configure what UI elements appear in the agent’s Slack responses. These settings control the visual components displayed alongside AI answers when the response includes citations from your knowledge base.
Display the source link in agent responses. When enabled, users see links to the knowledge base articles or documents that the AI used to generate its answer.Default: EnabledThis helps users verify information and explore related documentation.
Display thumbs up/down feedback buttons below AI responses. When enabled, users can indicate whether the response was helpful.Default: EnabledFeedback data helps you identify knowledge gaps and improve your documentation.
Display a button that allows users to create a support ticket directly from the AI response. This is useful when the AI answer doesn’t fully resolve the user’s question and they need human assistance.Default: Disabled
The create ticket button only appears when the ticket has not already been published.

​
Create ticket on 👎

Enable this option to automatically create a support ticket whenever a user reacts with a thumbs down (👎) emoji to the agent’s response.
This setting only appears when Show feedback buttons is enabled.

​
Auto-respond

Enable automatic AI responses for tickets created from Email and Integration sources (Jira, Linear, GitHub, etc.). When enabled, the agent will automatically respond to new tickets using its assigned knowledge bases.
Enable this option to automatically respond to tickets created from inbound emails. The agent will analyze the email content and provide a response based on its knowledge bases.
Enable this option to automatically respond to tickets created from integrations such as Jira, Linear, and GitHub. The agent will analyze the ticket content and provide a response based on its knowledge bases.
Set a delay (0-300 seconds) before the agent responds. This can be useful to allow time for additional context to be added to the ticket before the AI responds. Options include:
  • Immediate (0 seconds)
  • 5 seconds
  • 10 seconds
  • 30 seconds
  • 1 minute
  • 2 minutes
  • 5 minutes
If the agent cannot provide a definitive answer, the ticket will be tagged with ai-unresolved for human follow-up.

​
Connections

Select which Channels the agent should be deployed to. You can add or remove channels at any time after deployment.

​
Chat logs

All interactions between users and the agent are logged and can be reviewed in the Chat Logs section. This allows you to monitor the agent’s performance, review conversations, and make adjustments to improve its effectiveness.