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

  1. Navigate to Control Hub → Agents
  2. Click “Create New Agent”
  3. 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. Start minimal, then iterate. 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. Use a response framework. 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. Include canonical examples. A few well-chosen examples are worth more than paragraphs of rules. Show the agent what good looks like for your most common scenarios. Define clear escalation paths. 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.” Avoid laundry lists of edge cases. Stuffing your prompt with every possible rule creates confusion. Focus on general principles that help the agent reason through novel situations. Organize longer prompts into sections. 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. Provide context about data and systems. 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’ll see built-in tools offered by that provider (Anthropic, Google, or OpenAI). These include capabilities like code execution, image generation, web search, and specialized skills—all running 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
  • Google Sheets: Read and update spreadsheets

​
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

​
Multi-Agent Workflows

Design complex workflows with multiple specialized agents: Example Workflow:
  1. Research Agent: Gathers information from web and databases
  2. Analysis Agent: Processes data and identifies insights
  3. Presentation Agent: Creates formatted reports and presentations
  4. 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:
  1. In the agent editor, find the Tags field under General settings
  2. Click “Add tag…” to select existing tags or create new ones
  3. Type a new tag name and press Enter to create it instantly
  4. 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

Curate a minimal set. 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. Match tools to purpose. Only enable tools your agent actually needs. Extra tools create decision overhead and can slow response time. Keep tool guidance high-level. 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.