Agents are the core building blocks of Piper. Each agent is an AI assistant configured for specific tasks within your organization.
Creating an Agent
Navigate to Agents in the sidebar and click Create Agent. Every agent requires:
- Name: Display name shown to users (e.g., “Customer Support Agent”)
- Primary Task Description: Instructions that define the agent’s purpose and behavior
Agent Configuration
Basic Settings
| Field | Description |
|---|
| Name | Display name for the agent |
| Internal Name | Optional identifier for API integrations |
| Primary Task Description | System prompt that defines the agent’s role, capabilities, and constraints |
| Business Information | Context about your organization (inherited from org settings, can be overridden per-agent) |
| Languages | Language codes the agent supports (default: en-US) |
| Active | Whether the agent is available for conversations |
Model Selection
Each agent can use a specific LLM provider and model. If not specified, the agent uses your organization’s default provider, or falls back to the system default.
| Field | Description |
|---|
| Provider | LLM provider (Groq, OpenAI, Anthropic, Google, Together AI, Cerebras) |
| Model | Specific model from the selected provider |
- Go to Agents → select your agent → Edit
- Scroll to the Model section
- Select a Provider from the dropdown
- Choose a Model from the available options
Available models depend on which LLM providers your organization has configured. Configure providers in Settings > LLM Providers.
Model Resolution Order
When an agent processes a request, Piper determines which model to use:
- Agent-specific model — If the agent has a provider and model set, use it
- Organization default — If the org has configured that provider, use it
- System default — Fall back to the system-wide default provider
Best Practices
Writing Effective Task Descriptions
Your primary task description is the most important configuration. Be specific about:
- Role: What persona should the agent adopt?
- Scope: What topics can the agent help with? What’s out of scope?
- Tone: How should the agent communicate?
- Constraints: What should the agent never do?
Example:
You are a customer support agent for Acme Corp. Your role is to help
customers with product questions, troubleshooting, and account issues.
Guidelines:
- Be friendly and professional
- If you don't know something, say so—don't make things up
- For billing issues, collect details and escalate to the Billing Agent
- Never share internal pricing or roadmap information
You have access to our files. Search them before asking customers
for clarification.
