Skip to main content

Agents

Create and use a reusable Agent, inspect its setup, and distinguish it from chat helpers and automations.

Start with a Skill for reusable instructions

For new work, use a Skill to reuse task instructions and a Space to keep project context together. Keep a classic Agent when maintaining an existing saved chat setup. Where an eligible item offers Convert to skill, review the proposed Skill and test it before replacing the original.

Building AI Agents on Hatz

This article covers:

  • Creating your first AI agent

  • Configuring agents with models, sources, and tools

  • Writing effective system prompts

  • Sharing agents with your organization

  • Using agents in Chat and Workshop

  • Best practices for agent development

  • Enabling Auto Tool Selection for your Agent

  • Viewing and managing your Agent's tools in chat

What are AI Agents?

AI Agents are reusable, conversational chatbots with a specific persona, knowledge base, and set of tools. Unlike regular chat conversations, agents remember their instructions and can access specific sources and integrations every time you interact with them.

Agents are perfect for:

  • Marketing teams creating brand-consistent content

  • Sales teams managing prospect research and outreach

  • Operations teams automating administrative workflows

  • Finance teams handling data analysis and reporting

  • Any role where repetitive tasks can be automated

Your team members can focus on the work they were hired to do, while agents handle the routine admin work.


How to Create an Agent

To create an Agent:

  1. Navigate to the Workshop and click New

  2. Select Agent from the options

This takes you to the agent setup flow, where you'll configure your agent step-by-step.


Configuring Your Agent

Basic Information

  • Agent Name Give your agent a descriptive name that reflects its purpose. For example: "Brand Voice Marketing Agent" or "Sales Prospecting Assistant."

    • You can also give your agent a creative, personalized name if you prefer!

  • Description Add a brief description to help you keep track of what each agent does. This is especially useful if you're managing multiple agents.

    • Example: "Follows company brand guidelines and creates marketing content."

  • Category Select a category to make your agent easy to find later. Categories include Marketing, Sales, Operations, Finance, and more.

AI Model Selection

Choose the AI model your agent will run on. This works similarly to selecting a model in the chat interface.

Important: Make sure the model you select supports tool calling if your agent needs to use integrations or built-in tools.

Model selection is largely based on personal preference, but consider the specific capabilities your agent will need.

Sources

Upload documents and files that your agent should reference. This could include:

  • Brand guidelines

  • Company policies

  • Product documentation

  • Style guides

  • Color palettes

  • Standard operating procedures

Sources can be uploaded directly or accessed from connected services like OneDrive.

Tools & Integrations

Select which tools and integrations your agent can access. The manual picker allows up to three selected entries. Automatic tool discovery is a separate path.

Auto Tool Selection

Instead of manually picking up to three tools, you can enable Auto Tool Selection to let your Agent choose relevant tools for each request. When enabled, the Agent evaluates each message and selects the tools it needs for that response.

This is a great option for agents that handle a wide variety of requests, or for teams who want a simpler setup experience.

You can still manually select up to three specific tools if you prefer more control over exactly what your Agent can access. If you are troubleshooting whether a tool can run, use a model that supports tool calling and test with either Auto Tool Selection on or the specific tool selected manually.

System Prompt (Instructions)

The system prompt is the core instruction set that defines how your agent behaves. These instructions run behind the scenes every time you interact with your agent—so you only need to write them once.

Here are the 5 key components of a good system prompt:

  1. Role/Identity

    1. Clearly define who or what the AI should be (e.g., "You are a helpful customer service representative").

  2. Context

    1. Provide relevant background information, knowledge, or situational details the AI needs to respond appropriately.

  3. Instructions/Tasks

    1. Specify what the AI should do, how it should behave, and what actions it should take.

  4. Constraints/Guidelines

    1. Define boundaries, limitations, and rules for what the AI should avoid or how it should handle specific situations.

  5. Output Format

    1. Describe how responses should be structured, styled, or formatted (e.g., tone, length, use of markdown).

Creating a System Prompt

Ask Hatz: “Help me write instructions for an assistant that drafts our weekly project update. Include its role, context, tasks, boundaries and output format.” Review the draft, paste it into the Agent’s Instructions field and adjust it to your team’s needs. Test it with a short example.

Agent Icon (Optional)

Add a custom icon so your team can recognize the Agent. You can ask Hatz to create an icon and use an image-generation option available to your account.

Sharing and Deploying Agents

Once you've created your agent, you can control who has access to it.

Sharing Settings

By default, all new agents are set to Private (only you can access them).

Share with Organization Enable this to make the agent available to everyone in your organization. This is perfect for company-wide tools like brand voice agents or customer service assistants.

Share with Community Once an agent is shared with your organization, you can optionally share it with the broader Hatz community. Only do this if the agent doesn't contain company-specific information.

To update sharing settings:

  1. Click on your agent

  2. Select Share Settings

  3. Choose your sharing level

  4. Click Save Settings


Using Your Agent

You can interact with your agent in two ways:

From the Workshop

Interact with your agent directly from the Workshop view where you created it.

From Chat

  1. Navigate to the Chat interface

  2. Click the agent selector (look for the robot icon)

  3. Choose your agent from the list

  4. Start chatting!

Seeing your Agent's tools and tool connection status in chat

When you select an Agent in Chat, the tool selector shows its configured tools. The selector will show a connected count (e.g., "2/3 connected") so you always know the status of your Agent's tools at a glance.

If any tools need to be reconnected, an inline alert will appear above the chat input with a one-click option to reauthenticate — so you can fix it instantly without leaving the conversation.

The agent will automatically:

  • Follow the system prompts you configured

  • Reference uploaded sources

  • Use the tools and integrations you enabled

  • Maintain brand voice and guidelines

Example Interaction

Instead of having to say:

"You are a marketing agent. Here are our brand guidelines... Use our company voice... Format the output like this..."

You can simply say:

"Create a LinkedIn post about our newest features" + [link to changelog]

The agent already knows how to act because you configured all of that in the system prompt!


Tips for Building Effective Agents

Start Simple

Begin with a clear, specific use case. Don't try to build an agent that does everything—focus on one job done well.

Use Descriptive Names

Name your agent steps and sources clearly so you can easily identify them later.

Test Thoroughly

Run several test conversations with your agent to ensure it behaves as expected before sharing with your organization.

Leverage Multiple Agents

For focused instructions and sources, consider specialized agents for different tasks:

  • Content Agent: OneDrive + Notion + Slack

  • Social Media Agent: LinkedIn + X + Reddit

  • Research Agent: Google Search + Tavily + Firecrawl

You can switch between agents mid-conversation to access different tool sets!

Keep System Prompts Updated

As your needs evolve, don't be afraid to update your agent's system prompts and sources.

Think About Your Team

What repetitive tasks take up your team's time? Those are perfect candidates for automation with agents.


Have ideas for agents you'd like to see? Let us know! We love hearing about creative use cases from the Hatz community.


Reconnecting Disconnected Tools

Check the Agent’s tools and connection status in Chat. Use the offered reconnect action for a personal connection, or ask the administrator who manages a shared connection.


Frequently Asked Questions

Can I change an Agent's tools from the chat window? No — the tool selector is read-only when an Agent is selected. To update an Agent's tools, you'll need to edit the Agent's configuration directly.

What does the connected count mean? The connected count (e.g., "2/3 connected") shows how many of the Agent's tools are currently active and authenticated. If the numbers don't match, one or more tools need to be reconnected.

What happens if I don't reconnect a disconnected tool? The Agent will still work, but it won't be able to use any tools that are disconnected. We recommend reconnecting them to get the best results.

Why is my Agent not following its instructions? First confirm the correct Agent is selected in Chat or open the Agent from Workshop. Then review the System Prompt (Instructions) and make the role, task, constraints, and output format explicit. Test with a short request that checks one instruction at a time.

Why is my Agent not using a tool or source? Check that the tool is enabled in the Agent's Tools settings or that Auto Tool Selection is enabled. Make sure the Agent's model supports tool calling, reconnect any disconnected tools, and confirm the needed source is attached. For OneDrive, also confirm the file or folder is within the Agent's configured OneDrive scope.

Can I change an Agent's tools while chatting with it? No. When an Agent is selected in Chat, the tool selector shows the Agent's configured tools and connection status. To change the tools, edit the Agent's configuration in Workshop.

Yes. In a classic Workflow, open the Prompt Step’s model selector and choose your Agent under My Agents. Check the Agent’s instructions, sources and tools, then test the step with the expected inputs.

Do chat folders combine context for an Agent? No. Folders help organize chats, but they do not merge every conversation in the folder into one shared context window. For ongoing work, continue in the same chat when you need prior messages available, or attach stable files and instructions to the Agent itself.


Create a saved automation from Auto

If your account can create automations, select Auto in Chat for a repeatable or scheduled procedure. Selecting an Agent backed by Auto is a separate choice. Compare Skills, automations and classic items.

Chat confirms the Cedar Project Update Skill was saved and is undergoing its safety check.

Watch: build and use a Skill

Watch: use an Agent in a workflow step

Select Cedar Action Brief for a classic workflow prompt step, then check its completed answer in Run History.

Convert an Agent to a Skill

Bring an Agent’s saved instructions into a reusable Skill.

  1. Open Workshop → My Items, find the Agent and choose Convert to skill from its menu.

  2. Review the selected items, then choose Review. Check the proposed Skill’s name, source and any items the plan says will not carry over.

  3. Choose Create skill. When it finishes, open the saved Skill and review its instructions.

  4. Choose Try in chat, keep Auto selected and send a fresh example. Compare the answer with the information you supplied.

Watch: convert an Agent to a Skill

Convert Cedar Action Brief, review the saved instructions and try the new Skill with fictional project notes.

Check what a recipient can do with a shared Agent

After sharing an Agent with a group, check its controls from a recipient’s account. In the walkthrough, the owner could edit the Agent and manage its audience. A group member who was also a Client Admin could chat with it and manage sharing, but could not edit its content.

Did this answer your question?