Create your first agent

Learn how to set-up your first AI powered agent in Dust

In Dust, you can create your team of specialized agents to help you on your day-to-day tasks. Each agent has specific instructions and access to specialized tools that take their capabilities to the next level.

Let's discover how they work !

Overview

  • Instructions: Command or guideline you provide to your agent to direct its responses.
  • Tools: tools that your agent can use to answer - such as searching in your Data Sources or navigating the Web. Before replying, the agent will decide which tools to use (one or many) to provide you with the best possible answer.

Build your first agent

Step 1: Create an agent

Click "Create an Agent" from the home page. You can start with a new agent or start from a template. In this example, we'll start with a new agent.

Click "Create an Assistant" from the home page Start new or from a template. For this example, click "new assistant"

Step 2: Give it instructions

Instructions tell your agent how to behave. How to write effective Instructions

Together, we'll create an custom agent that can reply to the employee's questions using the internal documentation.

Instructions tell the assistant how to behave.

Replace the [X] with your the information that fits your situation. Note: you can follow the tips at the bottom to improve the agent's output. In this example, we'll make it an HR agent that answer questions regarding HR company policies.

Note: you can change the model the agent uses.

Chose the model you want your assistant to use

Step 3: Give it tools

Tools give your agent special abilities. In this case, we'll use generic search tool.

This tool will give the agent the ability to search through your documentation to find the most relevant documents and to use them as context to generate the answer.

Learn more about tools & capabilities

For this example, do the following:

  • Pick the right tool: search
  • Select the right data sources: in this case, I selected a HR documentation in Notion and some folders in Gdrive.
  • Add a small description of the data source: this will help the agent understand when to use the tool
Select the "search" tool

Select the right data sources

Add a small description. It helps your assistant understand when to use the tool

Step 4: Test your agent

You can test your agent at any time. Agents will usually require some iterations on the instructions or the tools to get to where you want it to be. It's ok ☀️

To open the preview mode, click on the discussion icon on the right.

Step 5: Give it a name, a description and share it with your team

Step 6: use your agent

  1. In the dust web app: Simply call your agent by beginning your message with@YOUR_AGENT_NAME in the Dust web app to use it.
  2. In Slack:
    1. Call you agent from Slack with @dust +YOUR_AGENT_NAMEbefore your message.
    2. Link your agent to a Slack channel. Everytime @dust is called in the Slack channel, your agent will answer (instead of the generic @dust agent)
  3. In Zapier: Using your agent in Zapier

Best practices

The three rules to create great agents

  • 1️⃣ The more data an agent has access to, the lower the chance of retrieving the correct information.
  • 2️⃣ You can "chain" agents in a conversation to complete more complex tasks.
  • 3️⃣ Invest some time in your agent's instructions: test different prompts and models and keep iterating. Good instructions make the difference between poor and great results.

👍

Good to know

  • Unsure how to use write best instructions, or what model to pick? Check-out our Best practices
  • Unsure what to use Dust for, or how to build it? Check-out our Use Cases & Guides

What’s Next