---
title: "AI Agents: Set Up and Get Started"
description: Create a TimeSentry AI agent, configure prompts and scheduled runs, start chats, and review sessions and results in the right company workspace.
---

[Skip to content](https://help.timesentry.ai/ai-agents-get-started#main-content)

English

Show submenu for translations

![Logo TRS](https://help.timesentry.ai/hubfs/Brand%20Assets/Logo%20TRS.svg)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [Contact us](https://timesentry.ai/contact)

[Contact us](https://timesentry.ai/contact)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [TimeSentry Knowledge Base](https://help.timesentry.ai/?hsLang=en)
2. [Other Platform Features](https://help.timesentry.ai/other-platform-features?hsLang=en)

# AI Agents: Set Up and Get Started

## Create an agent, configure its instructions, and review its work.

Create a managed AI agent for a defined purpose, then configure its instructions and review its results. The agent has its own company context, access, and API identity rather than sharing a human login.

### Understand the agent entity

In TimeSentry, an AI agent is a company-type actor with its own work, access, and API identity. It is not merely a user preference or a shared login. Handler relationships determine which people or companies supervise it.

### Create a managed agent

1. Open **Organization \> Agents** and choose the create action.
2. Enter a clear name.
3. Select the available provider and model.
4. Under **Advanced**, optionally review the system prompt and description.
5. Create the agent.
6. Copy the `tsk_` API key from the success screen if the agent will call TimeSentry. It is shown only once.
7. Choose **Open workspace**.

If you miss the one-time key, rotate it later from **Access & API key**. Rotation invalidates the previous key.

### Complete workspace setup

Review the system prompt, assign skills, configure tools and credentials, add handlers, and test the agent in a new chat. For managed agents, decide whether a scheduled heartbeat is appropriate.

### Manage lifecycle

Review handler access and credentials after ownership changes. Rotate a suspected key immediately. Before deleting an agent, preserve required work records and session evidence according to company policy.

### Edit the system prompt

Open the agent workspace and select **System prompt**. State the agent's purpose, permitted work, escalation rules, output expectations, and important restrictions. Avoid putting passwords or reusable secrets in the prompt.

Prompt changes apply to new chat sessions. Sessions already open keep the prompt they started with. Start a new chat when testing a change.

### Configure heartbeat

For a managed agent, open **Heartbeat**. Choose whether it is enabled, select the interval, and review or edit the heartbeat prompt. A heartbeat wakes the agent on a schedule so it can work through assigned tasks.

Runs are skipped when there is nothing to do. Completed heartbeat runs appear as sessions labeled **Auto**. **Run now** requests an immediate heartbeat but can still be skipped when no open tasks exist.

### Use scheduling safely

Begin with a conservative interval and limited permissions. Review several Auto sessions before relying on unattended execution. The heartbeat expands frequency, not authority: the agent can use only its assigned access, skills, tools, and credentials.

### Troubleshoot

Check that heartbeat is enabled, the next-run time is present, open tasks exist, and the agent has the tools and permissions required. Review the most recent Auto session or status before shortening the interval.

### Start a chat

Open the managed agent's workspace and select the chat area. There is no separate start step: sending the first message creates a session and titles it from that message. Give the agent a clear objective, relevant constraints, and an expected output.

### Work with sessions

The session rail lists chats for the agent. Select a session to reopen its history. You can rename a session to make its purpose clearer. Heartbeat-created sessions are marked **Auto**.

Prompt, skill, tool, or permission changes generally apply to new sessions. Start a fresh chat when testing changed configuration rather than assuming the open session adopted it.

### End, archive, or delete

End or archive a completed session to remove it from active work while preserving it according to the available workflow. Delete only when permanent removal is intended; deletion can also remove the provider-side session and cannot be treated as a reversible archive.

### Review agent work

Inspect actions, created records, tool results, and errors. Confirm company scope, client/project classification, and any time entries or tasks before approval. Escalate unexpected access immediately and rotate the agent's API key if compromise is suspected.

### Related guide

- [AI Agents: Access & Tools](https://help.timesentry.ai/ai-agents-access-tools?hsLang=en)

- [Getting Started](https://help.timesentry.ai/getting-started?hsLang=en#main-content)

    - [Clio and MyCase onboarding checklists](https://help.timesentry.ai/getting-started?hsLang=en#clio-and-mycase-onboarding-checklists)
    - [Capture and sync your first time entries](https://help.timesentry.ai/getting-started?hsLang=en#capture-and-sync-your-first-time-entries)
    - [Review your week in TimeSentry](https://help.timesentry.ai/getting-started?hsLang=en#review-your-week-in-timesentry)
- [Integrations](https://help.timesentry.ai/integrations?hsLang=en#main-content)

    - [Practice Management](https://help.timesentry.ai/integrations?hsLang=en#practice-management)
    - [Email, Calendar, Chat & Phone](https://help.timesentry.ai/integrations?hsLang=en#email-calendar-chat-phone)
    - [Accounting & Payroll](https://help.timesentry.ai/integrations?hsLang=en#accounting-payroll)
    - [Desktop, Browser, Mobile & Office](https://help.timesentry.ai/integrations?hsLang=en#desktop-browser-mobile-office)
    - [Choose & Manage Connections](https://help.timesentry.ai/integrations?hsLang=en#choose-manage-connections)
- [Settings](https://help.timesentry.ai/settings?hsLang=en#main-content)

    - [Preferences & Rules](https://help.timesentry.ai/settings?hsLang=en#preferences-rules)
    - [Company settings and team access](https://help.timesentry.ai/settings?hsLang=en#company-settings-and-team-access)
    - [Account & Subscription](https://help.timesentry.ai/settings?hsLang=en#account-subscription)
    - [Privacy & Recording](https://help.timesentry.ai/settings?hsLang=en#privacy-recording)
    - [API Keys & MCP](https://help.timesentry.ai/settings?hsLang=en#api-keys-mcp)
- [Troubleshooting](https://help.timesentry.ai/troubleshooting?hsLang=en#main-content)

    - [Login & Access](https://help.timesentry.ai/troubleshooting?hsLang=en#login-access)
    - [Missing or Incorrect Entries](https://help.timesentry.ai/troubleshooting?hsLang=en#missing-or-incorrect-entries)
    - [Billing & Sync](https://help.timesentry.ai/troubleshooting?hsLang=en#billing-sync)
    - [Capture Apps](https://help.timesentry.ai/troubleshooting?hsLang=en#capture-apps)
- [Time](https://help.timesentry.ai/time?hsLang=en)
- [Expense](https://help.timesentry.ai/expense?hsLang=en)
- [Tasks](https://help.timesentry.ai/tasks?hsLang=en)
- [Notes](https://help.timesentry.ai/notes?hsLang=en)
- [Documents](https://help.timesentry.ai/documents?hsLang=en)
- [Finance](https://help.timesentry.ai/finance?hsLang=en)
- [Analytics](https://help.timesentry.ai/analytics?hsLang=en)
- [Org](https://help.timesentry.ai/org?hsLang=en)
- [Other Platform Features](https://help.timesentry.ai/other-platform-features?hsLang=en)
- [FAQs](https://help.timesentry.ai/faqs?hsLang=en)
- [Archive](https://help.timesentry.ai/archive?hsLang=en)

[![TimeSentry AI Logo](https://help.timesentry.ai/hubfs/timesentry_rebrand%20copy-2.png "TimeSentry AI Logo")](http://www.timesentry.ai)

<https://www.facebook.com/> <https://www.twitter.com/> <https://www.instagram.com/timesentry.ai/> [mailto:email@email.com](mailto:email@email.com)

Copyright © 2026, TimeSentry