Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.xpander.ai/llms.txt

Use this file to discover all available pages before exploring further.

Personal Agents are great for day-to-day assistance, but you can create Specialized Custom Agents for dedicated tasks like customer support, weekly reporting, and bug hunting. Custom Agents run on the Agno framework and give you full control over the model, memory, instructions, tools, and channels.
Need to run on a framework other than Agno (e.g., OpenAI Agents SDK, LangChain, Google ADK, AWS Strands)? Framework choice is available on the Enterprise plan. Contact sales to enable it for your workspace.

Create Your Agent

1

Sign in

Go to app.xpander.ai and sign in or sign up. New users get a 14-day free trial.
2

Start a new agent

Click + New Agent in the top right of the Agents page.
xpander Agents page with the + New Agent button in the top right
3

Name your agent

Environment will already be set to xpander-cloud, which is the default hosting setup, fully-managed by Xpander.
Create New Agent dialog with Agent name field and Environment dropdown showing xpander cloud
On the Self-hosted Enterprise plan, you can spin up Xpander’s AI Agents on your own compute environments. Contact sales to learn more.
4

Wait for provisioning

Xpander sets up your agent’s container and wires up memory, built-in tools, and networking. This one-time setup takes a minute or two.Agent setup modal showing container spinning up
5

Open the Agent Studio

You’re ready to try out your newly created agent.Click the gear icon in the top left to open the configuration panel.Agent Studio showing Builder view with chat interface and gear icon
6

Publish

When you’re ready, click Publish in the top right. You need to publish every time you change configuration before it takes effect.

Tour the Agent Studio

The Agent Studio has two views:
  • Builder: Configure your agent and chat with it directly
  • Monitor: View conversation logs, performance metrics, and task history
Agent Studio header showing Builder and Monitor tabs

Configuration Quick Reference

Xpander’s Custom Agents expose full Agno configuration options. Click the gear icon in the Builder view to open the configuration panel.
Agent Studio configuration panel with General, Instructions, Tools, Channels, and Memory tabs
TabWhat you configure
GeneralModel, access, output format, guardrails, notifications.
InstructionsSystem prompt - role, goals, rules, expected output.
ToolsBuilt-in tools, connectors, thinking controls.
ChannelsAPI, SDK, Chat, Slack, Webhook, Task, MCP, A2A.
MemorySession history, user and agent memories, compression.

General

High-level agent properties and model selection.
SettingWhat it does
NameYour agent’s display name.
LLM settingsPick a provider and model. See AI Models & Intelligence.
AccessPrivate to you, or shared with your organization.
Output formatFree-form text, Markdown, Structured output, or Voice.
LearningCapture user profiles and knowledge over time. See Memory & State.
LLM GuardrailsPII detection, prompt injection blocks, and OpenAI moderation. See LLM Guardrails.
Multi-AgentAttach other agents for orchestration.
Knowledge basesAttach knowledge bases for retrieval. See Knowledge Bases.
TemplatesSave the current configuration as a reusable template.
NotificationsSuccess and error alerts via Email, Webhook, or Slack.
Danger zoneDisable or delete the agent.

Instructions

The agent’s system prompt.
Instructions tab showing agent role, goals, instructions, and expected output fields
FieldWhat it does
Agent roleThe agent’s role or personality.
GoalsWhat the agent should accomplish.
InstructionsRules and behavior constraints.
Expected outputHow the agent should format its responses.
Click Write instructions with AI to prompt an LLM to fill these fields for you.

Tools

Built-in tools, connectors, and thinking controls. See Tools & Connectors.
Tools tab showing built-in tools, connector tools, thinking & planning, and advanced configuration
SectionWhat it does
Built-in toolsToggle xpander’s built-in tools (Send Email, OCR, etc.).
ToolsConnect external apps via MCP or API. See Tools & Connectors.
Agent Thinking & PlanningChecklist Toolkit, Checklist Enforcement, and Reasoning Toolkit. See AI Models & Intelligence.
Advanced ConfigurationMax tool calls per run.

Channels

How users and systems reach your agent - API, SDK, Chat, Slack, Webhook, Task, MCP, and A2A. See Deploy an Agent for setup on each channel.
Channels tab showing API, SDK, Chat, Slack, Webhook, Task, MCP, and A2A options

Memory

What the agent remembers across conversations. See Memory & State.
Memory tab showing session storage, memories, compression, and optimization settings
SettingWhat it does
Session storagePersist chat history across sessions.
User MemoriesStore per-user memories.
Agent MemoriesStore agent-wide memories across all users.
Max tool calls from historyCap tool calls included in context.
Session summariesSummarize long conversations automatically.
Tool calls compressionShrink verbose tool outputs in context.
Memory optimization strategyOptimize the context window during execution.

Common Use Cases

I want my agent to…What to configure
Answer questions about my company’s docsAttach a Knowledge Base with your documents
Send emails and search the webEnable built-in tools (Send Email, Web Search)
Integrate with Slack, Jira, GitHub, etc.Install connector tools from the catalog
Remember user preferences across conversationsEnable User Memories in the Memory tab
Learn and improve over timeEnable Agent Memories with agentic management
Handle complex multi-step tasksEnable Checklist Toolkit or Planning Mode
Give deeper, more thorough answersEnable Reasoning Toolkit or increase reasoning effort
Respond in structured JSONSet Output format to Structured output in General tab
Run on a framework other than AgnoContact sales to enable framework choice on Enterprise
Run agents in your own infrastructureContact sales to enable self-hosted locations on Enterprise

Next Steps

Tools & Connectors

Browse 100+ connectors and configure tool behavior

AI Models & Intelligence

Providers, planning mode, and reasoning mode

Memory & State

Session storage, user memories, and agent memories

Deploy an Agent

Publish and connect to Slack, API, SDK, and more