Agents
An agent is an AI assistant you configure and own. It runs on a model you choose, follows instructions you write, and can access tools like web search and a knowledge base.
Core settings
| Field | Required | Description |
|---|---|---|
| Name | Yes | Display name shown to users |
| Description | No | One-line summary shown on marketplace cards and agent listings |
| Category | No | Marketplace filter category (Finance, Content, Code, etc.) |
| Privacy | Yes | Private (org only) or Public (marketplace). Public requires Pro plan + passing quality check |
| Model | Yes | The AI model that powers this agent |
Instructions
System prompt
The system prompt is internal — only the AI sees it. It defines the agent's role, tone, and scope. Leaving it blank uses the model's default behavior.
You can import a .txt, .md, .json, or .yaml file to pre-fill the system prompt using the Import skill file button.
Starter prompts
Up to four clickable suggestions shown to users when they open a new conversation. Each starter prompt is limited to 75 characters. Leave all four blank to show no suggestions.
Capabilities
Toggle tools on or off from the Capabilities tab.
| Tool | Description | Plan |
|---|---|---|
| Web Search | Agent searches the internet for current information | Pro |
| Knowledge Base | Agent retrieves answers from uploaded documents | All |
| Subagents | Agent can delegate tasks to other agents in your org | All |
| App Integrations | Connect to 200+ apps via Composio (GitHub, Slack, Notion…) | All |
See Knowledge Base → for details on uploading documents.
App Integrations
When enabled, you select up to 3 app toolkits (e.g. GitHub + Slack + Notion). Users authenticate each app on their first use via a hosted OAuth flow. Kopai stores no credentials.
Economics
| Field | Description |
|---|---|
| Runtime infra | Read-only estimate of the infrastructure cost per message (based on model) |
| Free messages | 0–100 free messages before credits apply. Kopai subsidizes these. |
| Publisher add-on | Per-message credit charge you earn (public agents only). Set to 0 to charge only infra. |
| Estimated total | Runtime infra + publisher add-on. This is what users are charged per message. |
Feedback
The Feedback tab (visible after your agent is created) shows ratings and comments from users who have chatted with your agent. Use this to improve your system prompt and starter prompts.
Quality check
Before publishing, Kopai evaluates your agent on four dimensions:
| Dimension | What it checks |
|---|---|
| Prompt Clarity | Is your system prompt clear and specific? |
| Knowledge Base | Does your knowledge base cover the agent's stated scope? |
| Behavior | Does the agent respond appropriately in test scenarios? |
| Safety | Does the agent avoid harmful outputs? |
Score ≥ 70 is required to publish. Click Run Check in the header to start an evaluation (~30–60 seconds).
Agent status labels
| Label | Meaning |
|---|---|
| Private | Visible to org members only |
| Public · price required | Set to public but no price set yet |
| Published v# | Live on the marketplace (version number shown) |
Editing and deleting
Open your agent via Org → Agents → [Agent name] → Edit. All changes require clicking Save to persist.
To delete an agent, go to the agent settings in the Agent Builder and use the delete option. Deleting a public agent removes it from the marketplace immediately.