Skip to main content

​
Overview

Aster Agents makes it easy to create custom AI agents that can perform specific tasks, access your data, and integrate with your workflows. Whether you need a customer support agent, data analyst, or specialized assistant, you can build exactly what your team needs.

​
Getting Started

​
Creating Your First Agent

Open the Agents section

Navigate to Control Hub → Agents.

Create a new agent

Click “Create New Agent”.

Configure the basic settings

  • Name: What your team will call this agent
  • Description: What this agent does and when to use it
  • Stage: Development (for testing) or Released (for team use)

​
Agent Configuration

​
System Prompt

The system prompt is the foundation of your agent’s behavior.
Begin with a simple prompt using your best available model, then add instructions based on failure modes you observe during testing. Resist the urge to anticipate every edge case upfront.
Give your agent a clear process to follow (e.g., “1. Understand the request, 2. Gather context, 3. Provide solution, 4. Confirm resolution”). This creates consistency without rigid scripting.
A few well-chosen examples are worth more than paragraphs of rules. Show the agent what good looks like for your most common scenarios.
Agents perform better when they know exactly when to ask for help. Be explicit: “Escalate billing disputes over $500” is better than “escalate complex issues.”
Stuffing your prompt with every possible rule creates confusion. Focus on general principles that help the agent reason through novel situations.
For complex agents, use clear headers or XML-style tags to separate concerns (role, guidelines, process, output rules). This helps the model parse your intent and makes prompts easier to maintain.
If your agent queries databases or accesses specific tools, briefly explain what data is available and any relevant business logic. Agents perform better when they understand the context they’re operating in.
Include platform context. Help your agent understand its environment—the current date, who they’re talking to, and how their output is displayed. We recommend including this at the end of your system prompt: 
The current date is {{CURRENT_DATE}} and the user is {{USER_EMAIL}}.

<aster_context>
You are an AI Agent on the Aster Agents platform. When you call tools, the user can see both your inputs and the results. Your messages are rendered using markdown, so use formatting like **bold**, *italic*, `code`, lists, and tables to organize your responses.
</aster_context>

​
Model Selection

Choose the AI model that powers your agent:
  • Default Models: Use your organization’s default chat model
  • Specialized Models: Select specific models for different capabilities
  • Reasoning Models: Use advanced models like o1 for complex problem-solving
  • Performance Models: Balance speed and capability based on your needs

​
Prompt Variables

Customize your agent’s behavior with dynamic variables (case-insensitive):
  • {{USER_EMAIL}}: The current user’s email address
  • {{USER_NAME}}: The current user’s full name
  • {{ORG_NAME}}: Your organization’s name
  • {{CURRENT_DATE}}: The current date and time (UTC)
You can also use nested access like {{user.email}} or {{org.name}}.

​
Tools & Capabilities

​
Provider Tools

When you select a model, you may see built-in tools offered by that provider (e.g., Google Search for Gemini, Web Search for OpenAI, Image Generation for GPT models). These run directly within the provider’s infrastructure with no setup required. Provider tools appear automatically based on your selected model. Just toggle them on like any other tool.

​
Built-in Tools

Give your agent access to powerful capabilities:

Web & Research

  • Web Search: Find current information online
  • URL Scraping: Extract content from specific websites
  • Ask Web: Get AI-powered answers from web sources

Data & Analysis

  • Execute Python: Run code for data analysis and processing
  • Database Queries: Connect to Postgres, Snowflake, and other databases
  • Knowledge Base Search: Access your organization’s documents

Communication & Productivity

  • Send Email: Automate email communications
  • Generate PowerPoint: Create presentations from data
  • API Calls: Integrate with external services
  • Schedule Task: Create scheduled tasks during conversations (e.g., “send me a daily report”)

Social Media & Content

  • Reddit Search: Research discussions and communities
  • TikTok Search: Find relevant video content

​
Multi-Agent Capabilities

Create sophisticated workflows with agent collaboration:
  • Call Agent Tool: Let agents work together on complex tasks
  • Agent Hierarchies: Design workflows where specialized agents handle specific parts
  • Task Delegation: Route different types of requests to appropriate agents

​
Integrations

Connect your agent to your existing tools and data:
  • Database Connections: Postgres, Snowflake, and more
  • Cloud Storage: Access files and documents
  • Third-party APIs: Connect to your business systems
  • Knowledge Bases: Search your organization’s documents

​
Advanced Configuration

​
Agent Stages

Manage your agent development lifecycle:
  • Development: Test and iterate on agent behavior
  • Released: Deploy to your team for production use
  • Visual Grouping: Development agents appear separately in selection menus

​
Version History

Every time you save an agent, its configuration (system prompt, model, tools, and connected knowledge bases, skills, and MCP servers) is captured as a version automatically — no extra step.
  • Open an agent and click History to see the timeline of changes, newest first.
  • The version currently in use is marked Current.
  • Click Restore on any earlier version to roll the agent’s configuration back to that point. Restore takes effect immediately.
Save or discard any unsaved edits before restoring — restore replaces the agent’s current configuration, so it’s blocked while you have pending changes.
Identical saves are de-duplicated, so the history only grows when something actually changes.

​
Multi-Agent Workflows

Design complex workflows with multiple specialized agents: Example Workflow:

Research Agent

Gathers information from web and databases.

Analysis Agent

Processes data and identifies insights.

Presentation Agent

Creates formatted reports and presentations.

Review Agent

Quality checks and finalizes deliverables.

​
Knowledge Base Integration

Connect your agents to your organization’s knowledge:
  • Selective Access: Choose which knowledge bases each agent can search
  • Automatic Discovery: Agents find relevant information during conversations
  • Context Awareness: Search results inform agent responses naturally

​
Agent Tags

Organize your agents with tags to help your team discover and select the right agent for their needs.

​
Adding Tags

Tags are created automatically when you assign them to an agent:

Find the Tags field

In the agent editor, find the Tags field under General settings.

Add a tag

Click “Add tag…” to select existing tags or create new ones.

Create new tags instantly

Type a new tag name and press Enter to create it instantly.

Categorize your agent

Add multiple tags to categorize your agent (recommended: 1-3 tags per agent).

​
Using Tags in Chat

When starting a conversation, users can filter agents by tag:
  • Click Switch Agent to open the agent selector
  • Use the left sidebar to browse by tag category
  • Select a tag to see only agents in that category
  • Combine with search to find specific agents within a category

​
Tag Best Practices

Start Simple: Begin with 3-5 broad categories (e.g., “Sales”, “Support”, “Analytics”), then add more specific tags as your library grows.
Common Tag Categories:
  • By Function: Sales, Customer Support, Marketing, Data Analysis
  • By Department: Finance, Engineering, Operations, Legal
  • By Specialty: Technical, Creative, Research, Reporting
Naming Tips:
  • Use clear, descriptive names (e.g., “Customer Support” not “CS”)
  • Keep tag names short (under 20 characters)
  • Be consistent with capitalization

​
Best Practices

​
Tool Selection

If a human can’t definitively say which tool should be used in a given situation, the agent won’t do better. Avoid overlapping functionality.
Only enable tools your agent actually needs. Extra tools create decision overhead and can slow response time.
Each tool has built-in instructions explaining how to use it. Your system prompt should focus on when to use tools in the workflow, which tools to prefer for which situations, and what not to do—not detailed instructions that duplicate or conflict with the tool’s own guidance.

​
Long-Running Workflows

Agents that perform multi-step work (building reports, processing many files, generating complex outputs) benefit from explicit workflow structure in the system prompt. Save intermediate results. When your agent builds something in stages (e.g., a multi-tab spreadsheet, a multi-section report), instruct it to save and publish each stage as a downloadable file before moving to the next. This protects against lost work and gives users visibility into progress. 
After completing each section, save the workbook and provide a download link
before proceeding to the next section.
Use auto-proceed prompts for chained work. If your workflow has multiple sequential steps that don’t need user input between them, tell the agent to proceed automatically rather than waiting for confirmation after each step. 
Complete all four report sections sequentially in a single response.
Do not wait for confirmation between sections. Save a checkpoint after each.

​
Knowledge Base Guidance in System Prompts

Guide file identification in multi-entity KBs. When a knowledge base contains documents from many similarly-named items (e.g., “Project Alpha-A”, “Project Alpha-B”, “Project Beta-A”), semantic search can return results from the wrong entity. Instruct your agent to filter extracted_data.json by exact field values rather than relying on search alone for file identification. 
To identify files for a specific entity, load extracted_data.json and filter
by the entity name field. Do not rely on search_knowledge_base to find all
files for an entity — search results are ranked by relevance and may include
files from similarly-named entities.
Tell the agent what data is already available. Agents have access to pre-extracted content in their Python sandbox (see Execute Python — Knowledge base file access), but won’t always use it unless guided. If your agent’s workflow involves processing many files, your system prompt should tell it which data source to start with and when to fall back to reading raw content.