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
- Navigate to Control Hub → Agents
- 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.
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:
{{USER_NAME}}: Personalizes responses with the user’s name{{ORG_NAME}}: References your organization name{{CURRENT_DATE}}: Includes today’s date for time-sensitive responses- Custom Variables: Define your own organization-specific variables
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.
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
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:
- 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
Organize your agents with tags to help your team discover and select the right agent for their needs.
Tags are created automatically when you assign them to an agent:
- In the agent editor, find the Tags field under General settings
- Click “Add tag…” to select existing tags or create new ones
- Type a new tag name and press Enter to create it instantly
- Add multiple tags to categorize your agent (recommended: 1-3 tags per agent)
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.
- 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
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.