Skip to main content
Hyperagent
Reference

Agent configuration

Complete reference for all eight agent settings tabs and their fields.

Every agent in Hyperagent has eight configuration tabs. This page documents every tab and its fields.

Overview

The landing tab when you open agent settings. Displays a summary view of the agent.

FieldDescription
Agent nameDisplay name (read-only here; editable in Identity tab)
DescriptionShort summary of the agent's purpose (read-only here)
Thread countNumber of threads this agent has participated in
Last activeTimestamp of the most recent activity
Created dateWhen the agent was first created

Identity

Everything that defines who this agent is. The system prompt lives here alongside the name, not as a separate concept.

FieldDescription
NameThe agent's display name. Shown in agent picker, sidebar, and thread headers.
IconVisual identifier. Choose from built-in icons or emoji.
DescriptionA short summary of the agent's role and purpose. Shown in the agent picker when selecting an agent for a thread.
System PromptThe detailed instruction set that shapes the agent's behavior. This is the "job description." Write what the agent should do, how it should think, what format to use, what to avoid. There is no length limit, but focused prompts work better than sprawling ones.

Activity

A timeline of the agent's usage history.

FieldDescription
Recent threadsList of threads the agent has participated in, sorted by recency
Usage frequencyHow often the agent is used over time
Invocation historyLog of how the agent was triggered (thread, Slack, scheduled, etc.)

Model

Controls the underlying AI model and its behavior settings.

FieldDescription
Model IDWhich AI model to use (e.g., Claude Opus, Claude Sonnet). Different models have different capabilities, speeds, and costs.
Effort levelHow much processing effort the model applies. Higher effort produces more thorough results but takes longer and costs more.
Thinking tokensWhether the model should use extended reasoning. When enabled, the model "thinks" before responding, improving quality for complex tasks.
BudgetMaximum token spend per response or per run. Prevents runaway costs on complex or recursive tasks.
Subagent modelThe model used when the agent delegates work to a subagent. Often set to a faster/cheaper model than the main agent.

Invocations

All seven trigger methods plus Live Mode configuration.

Invocation TypeDescriptionStateful?
ThreadDefault. Open a thread and select the agent.Per thread
SlackAgent responds to @mentions in connected Slack channels.Per thread
TelegramAgent paired with a Telegram bot via BotFather.Per thread
ScheduledCron-based timer. Each run creates a new thread. Configure schedule, timezone, prompt, and delivery channel.No (new thread)
Webhook / APIHTTP POST endpoint. Each request creates a new thread. Returns an endpoint URL and auth token.No (new thread)
EmailDedicated email address. Incoming emails trigger runs. Subject + body become the prompt.No (new thread)
Live ModeInterval-based with a checklist. Stays in the same thread. Silent by default; speaks up when something changes.Yes (same thread)

Coming soon: SMS and MCP Server.

Tools & Integrations

Toggle built-in tools and connect third-party services.

Tools are built-in capabilities toggled on or off:

CategoryExamples
Search & ResearchWeb search, image search
Content CreationImage generation, video generation, audio generation, avatar videos
Data & CodeCode execution, table creation, file management
DocumentsDocument creation, webpage publishing, slide creation
Maps & LocationMap generation, geocoding, directions, Street View
CommunicationSuggest follow-ups

Integrations are connected third-party services requiring OAuth or API keys:

IntegrationCapabilities
GitHubRead repos, create issues, commit code
SlackPost messages, read channels
Google SheetsRead/write spreadsheet data
GmailSend/read emails
LinearManage tasks and projects
NotionRead/write pages and databases
And more...New integrations are added regularly

Skills

Attach, pin, and manage skills for this agent.

ConceptDescription
Pinned skillsAlways loaded into context. Use for skills the agent needs in every conversation.
Available skillsLoaded when the agent determines they are relevant to the current task.
Discoverable skillsNot attached to the agent directly, but available through search if the agent looks for them.

See How Agents Load Skills for the full loading mechanism.

Knowledge

Everything the agent knows beyond its base training.

FieldDescription
MemoriesLearned facts, preferences, and context. Managed via importance levels (1-5) and categories.
Memory ScopeControls which memories the agent sees.
DocumentsReference materials attached to the agent. These are documents the agent can access in any conversation.
Context filesUploaded files that provide background information. PDFs, text files, spreadsheets -- any file the agent might need to reference.
Knowledge Access presetsControls how knowledge is shared in team workspaces. Determines whether memories and context are shared across team members or kept private.