Create and manage custom AI assistants combining Knowledge Bases, Tools, and Guardrails
Tired of repeating context to the base AI model, manually pasting internal documents, and re-stating answer formats every time?An Agent bundles a Knowledge Base + Tool + Guardrail + System Prompt together to create a per-department-optimized AI assistant.
In one line — bundle a system prompt + knowledge base + tools + guardrails into a task-specific AI tailored per team.
When does it fit? When the same context repeats turn after turn, or when answer format and internal-source citations must stay consistent
How long to build? A minimal prompt-only agent takes ~5 min · a full setup with KB, tools, and guardrails is closer to 30 min
What about cost? Each response adds KB retrieval and tool routing on top of the base model, so token usage is higher — for casual questions, the base model is cheaper
Is this the right tool? If branching and loops dominate, look at Flows. If you only need one or two tools, Tools alone may be enough
Example
“Show me this month’s sales status”
State
Behavior
Result
Base model
Guesses from general AI knowledge
”I cannot access sales data”
Agent (DB + KB connected)
Queries the sales DB + applies report format
Accurate sales data + tabular response
View created agents in Workspace > Agents
Agent Processing Pipeline
The agent receives a user question and generates a response through this pipeline.A guardrail validates the input, the Knowledge Base retrieves related documents, tools (API, DB) are invoked when needed, and the LLM produces the final response.
Which Should You Use?
Agent, Base Model, and Flow look similar but fit different situations.
Base Model
When — One-off questions, free-form answers, general knowledge.Casual prompts like “what does this code mean?” or “what’s today’s FX rate” are fastest and cheapest here. No KB retrieval or tool routing means lower token usage.
Agent
When — Repeated KB citations, fixed tone or format, guardrails required.HR policy Q&A, code reviewers, data analysts — the pattern of letting the LLM decide which KB to cite and which tool to call.
Flow
When — Branching, loops, or external API chains dominate.Form input → automated processing → notification, multi-step approvals, and similar automation. You specify the decision flow as nodes, so behavior is predictable.
When in doubt, start with an Agent. If it feels like overkill for simple questions, drop down to the base model; if you find yourself wanting if/else branches, move it to a Flow. You don’t have to pick the right one on the first try.
Creating an Agent
1
Enter basic info
Click Workspace > Agents > ”+ New Agent” and fill in basic info.
Set the agent's name, description, and profile image
Field
Description
Example
Agent Name
Agent display name
”Marketing Assistant”
Description
What the agent does
”Marketing content creation and analysis support”
Agent Image
Agent icon
Marketing-related image
2
Pick the base model
Choose the AI model the agent will use. Pick from the model list registered by the admin.
3
Write the prompts
Define the agent’s role, persona, and response rules.
Field
Description
Task Prompt
Defines the agent’s role, persona, restrictions, and concrete task instructions. Plays the role of the general system prompt.
Response Format Prompt
Specifies the response format and structure (markdown, table, etc.). This is the default answer format — when Response Formats are registered below, it is used when no registered format fits the question.
Response Formats
Optional. Use ”+ Add Response Format” to register multiple answer styles per question type; the agent automatically picks the one that fits each question. Leave empty and the Response Format Prompt above always applies.
Click the Generate with AI button next to each prompt field — it analyzes the agent’s name, description, and connected resources to draft the prompt automatically.
During AI auto-generation, technical instructions (tool usage, SQL writing rules, etc.) are automatically excluded. The platform handles those — the prompt only contains role, persona, and restrictions.
Write the Task Prompt (role definition) and Response Format Prompt (output format) separately
Example of a good task prompt
You are Cloocus's marketing assistant.## Role- Support marketing content creation- Draft social media posts- Analyze marketing data## Response Rules- Always respond in Korean- Maintain a professional yet friendly tone- Provide data-driven insights- Comply with brand guidelines## Restrictions- Do not disparage competitors- Do not use unverified statistics
Why are the Task Prompt and Response Format Prompt separated?
The two prompts are used at different stages of agent execution.
Task Prompt
Response Format Prompt
When applied
While the agent is using tools
When composing the final answer
Role
”What to do” (role, restrictions)
“How to answer” (markdown, tables, length)
Include
Role definition, behavior rules, restrictions
Output format, tone, structure
Don’t include
Output format specs
Role definition, behavior rules
Separating them lets you change just the output format while keeping the role, or vice versa.
4
Configure prompt suggestions (optional)
Set conversation-starter suggestions shown when an agent is selected in chat.
Option
Description
Default
Use system default suggestions
Custom
Set agent-specific suggestions
Providing example questions matched to the agent’s purpose helps users start conversations quickly.
Examples: “Summarize this month’s sales”, “Draft a social media post”
5
Connect Knowledge Bases
Attach documents the agent should reference.
Click “Select Knowledge” in the “Knowledge Base” section
Select Knowledge Bases to connect (multiple supported)
Connected Knowledge Bases are searched via RAG and used in answers, with citations.
When you connect multiple Knowledge Bases, the agent automatically picks the right one based on the question
6
Connect databases (optional)
Connect a Database (DbSphere) for natural-language data queries (NL-to-SQL).
Click “Select Database” in the “Database” section
Select databases (multiple supported)
Ask questions in natural language about the connected DB; the AI generates and runs SQL, returning results.
7
Connect glossaries (optional)
Connect a Glossary so the agent understands your organization’s business terminology.
Click “Select Glossary” in the “Glossary” section
Select glossaries (multiple supported)
Term definitions, synonyms, and context registered in the glossary are reflected in agent responses.
8
Connect tools (optional)
Connect tools for external system integration. In the “Tool Connections” section, choose MCP servers or OpenAPI servers.
Tool Type
Description
OpenAPI server
Interact with external services via REST API
MCP server
Tool integration via Model Context Protocol
If a connected tool’s description is empty, a warning banner appears at the top of the editor. The tool description is the LLM’s primary cue for “when to call this tool”, so a missing description leads to incorrect calls or unused tools. When the banner appears, fill in the description from the tool definition.
9
Capability settings (optional)
Configure advanced features the agent can use. Each capability has 3 states.
State
Description
Disabled
The capability is completely hidden in chat (default)
Default On
Auto-enabled at chat start, user can turn off
Default Off
Visible in chat, but user must turn it on
Capability
Description
Web Search
Real-time web search for up-to-date info. Configurable result count and domain filter
Image Generation
AI image generation engine integration. Pick which connection to use
Gmail
Read and send mail on the user’s behalf
Google Calendar
Read and create calendar events on the user’s behalf
Google Drive
Search files and create Google documents on the user’s behalf
Separately from those five, four settings on the same screen control how the agent answers. These take individual values rather than the three states above.
Setting
Description
Default
Show Reasoning
Show tool calls (arguments / results) and thinking as collapsible blocks before the answer. Choose Brief (tool name only), Detailed (live reasoning steps), or None
Brief
Grounding
Restrict answers to the connected data sources (knowledge bases, databases, tools). When off, the agent falls back to general knowledge if the sources do not cover the question
On
Ask the User
Lets the agent ask you back (with buttons or free text) when a critical detail is missing or the request is ambiguous
Off
Document Generation
Lets the agent generate PPT / Word / Excel files with the built-in tool
Off
The default for Grounding depends on the screen — it is on when editing an agent, and off when editing a base model.
Even when Gmail, Calendar, and Drive are enabled here, they appear in chat only after the user connects their own Google account under Settings > Connections. Code execution is not an agent capability — see Code Execution.
The five chat capabilities use three states; the four response settings take individual values
10
Response format (optional)
Constrain the agent’s response to a structured JSON format.
Mode
Description
Chat
Default freeform text response
Structured Output
Structured response per JSON Schema
In Structured mode, define the response schema with the visual field builder or the raw JSON editor.
Define the response structure with JSON Schema in Structured mode
11
Guardrail settings (optional)
Attach security guardrails to validate I/O.
Auto-detect and mask PII
Custom pattern filtering
Block prohibited words
LLM-based content validation
12
Auto-evaluation settings (optional)
Automatically monitor response quality.
Setting
Description
Judge Model
LLM to use for evaluation
Sampling rate
Share of responses to evaluate (1%–100%)
Evaluation type
Choose from retrieval quality, faithfulness, response quality
Evaluation type details
Type
Description
Retrieval Quality
Relevance of documents retrieved from the Knowledge Base
Faithfulness
Whether the response is faithful to retrieved content (no hallucination)
Response Quality
Overall quality, usefulness, and accuracy of the response
Sampling-rate guidance:
Situation
Recommended
Reason
New agent (validation phase)
50–100%
Need initial quality picture
Stabilized agent
5–10%
Save costs while monitoring
Critical-business agent
20–30%
Continuous quality assurance needed
Retrieval Quality and Faithfulness evaluations only run when there are Knowledge Base search results. For agents without a KB, choose Response Quality only.
Enable auto-evaluation to continuously monitor response quality
13
Access permissions
Set who can use the agent.
Option
Description
Public
Available to all users
Private
Available only to you
Group
Available to members of the specified groups
Access Control modal — search and add groups, then set Editable per row
14
Save
Click Save & Create to create the agent.
Using Agents
Select in Chat
In the model selector dropdown at the top of the chat, pick an agent. Agents appear in the list alongside regular models.
Invoke with @
Call a specific agent in chat with @agent-name.
@MarketingAssistant Draft 5 social posts for this month's promotion
Agent Management
Action
Description
Activate / Deactivate
Toggle on the agent card to enable/disable. Inactive agents can’t be selected in chat
Edit
Click the agent card to edit settings
Clone
Quickly create a new agent by copying an existing one
Export / Import
Back up and migrate agent settings between environments via JSON
Delete
Permanently delete the agent (no recovery)
Use export/import to move agents created in a development environment over to production.
Real-World Scenarios
Concrete situations from operations and how to configure for them — use these as a starting point if your case is similar.
HR Assistant — Policy Q&A
Situation: HR fields the same questions about leave, benefits, and employment policy. Answers need to cite the specific policy article to be trusted.Configuration:
Field
Value
Base model
GPT-4o-mini (low cost, sufficient for fact-based answers)
Knowledge Base
HR policy, benefits guide PDFs
System prompt
”HR specialist. Always cite the article number at the end. Never speculate”
None (direct codebase access belongs in a separate MCP server)
Build sequence: Organize guidelines into a KB → create Agent → assign @code-reviewer handle → invoke in chat with @code-reviewer review this functionCommon pitfalls:
Build sequence: Create Agent → write system prompt only → paste notes in chatWhen this is enough: When you only want to bundle “prompt + model” without KB/tools/guardrails. 5 minutes to build. If even simpler, the Prompts feature may be all you need.
Best Practices
Prompt Writing
Define the role clearly — “You are a content specialist on Cloocus’s marketing team”
Provide concrete instructions — response language, length, citation rules, etc.
Set restrictions — no competitor disparagement, no PII exposure, etc.
Knowledge Base Connection
Connect only relevant documents: Too many documents actually degrade retrieval accuracy
Keep documents up-to-date: Refresh stale information regularly
Principle of least privilege: Grant access only to those who need it
Manage by group: More efficient than per-user assignment
Review periodically: Check permission settings on a regular cadence
FAQ
What's the difference between an agent and a base model?
Agents add Knowledge Bases, Tools, system prompts, and Guardrails to a base model, optimizing it for a specific task. Use the base model for general-purpose chat and agents for task-specialized chat.
Can I connect multiple Knowledge Bases to one agent?
Yes — connect multiple Knowledge Bases and databases at once. The agent automatically picks the appropriate resource based on the question. Writing a detailed Tool Description for each Knowledge Base improves selection accuracy.
Web Search / Image Generation / Google Workspace doesn't work
Check the agent’s capability settings:
Disabled: The capability is completely hidden in chat
Default Off: User must turn it on in the chat input
Default On: Auto-enabled. If still not working, check admin settings (web search/image generation connections)
Gmail, Calendar, and Drive additionally require the user’s own Google account connection and the group’s permission before they appear in chat.
Is agent usage tracked?
Yes — view per-agent usage, token consumption, and auto-evaluation results in the monitoring dashboard.
Can I move an agent to another environment?
Yes — use Export to download the JSON, then Import in the other environment. Note: connected Knowledge Bases, tools, and guardrails must be set up separately in the target environment.
Can I hide an agent?
Yes — use the toggle at the top-right of the agent card to change its state to Disabled, and it’s hidden from the chat model selector. The agent isn’t deleted and can be shown again.
Related Pages
Knowledge Base
Document-based knowledge stores you can attach to agents
Guardrails
Validate agent I/O for security
Tools
OpenAPI / MCP external service integration
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cloosphere Guide","colors":{"primary":"#5f22d0","light":"#7c3aed","dark":"#4c1d95"},"logo":{"light":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","dark":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","href":"/ko/index"},"favicon":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/favicon.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=0e41ff0755aa623d52e26f279f285f71","appearance":{"default":"system","strict":false},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"languages":[{"language":"ko","default":true,"href":"ko"},{"language":"en","href":"en"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cloocus","hasAudioNarration":false,"actualSubdomain":"cloocus","customDomains":["docs.cloosphere.ai"],"gitSource":{"type":"github","owner":"ais-cloocus","repo":"cloosphere-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6a954066df6b735599399868","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"en","tag":"Admin","count":30},{"language":"ko","tag":"관리자","count":30},{"language":"en","tag":"Settings","count":24},{"language":"ko","tag":"설정","count":24},{"language":"en","tag":"Monitoring","count":21},{"language":"ko","tag":"모니터링","count":21},{"language":"en","tag":"Workspace","count":16},{"language":"ko","tag":"워크스페이스","count":16},{"language":"en","tag":"Chat","count":11},{"language":"ko","tag":"채팅","count":11},{"language":"en","tag":"Getting Started","count":10},{"language":"ko","tag":"시작하기","count":10},{"language":"en","tag":"Collaboration","count":8},{"language":"ko","tag":"협업","count":8},{"language":"en","tag":"Data \u0026 Operations","count":6},{"language":"ko","tag":"운영 · 지원","count":6},{"language":"ko","tag":"데이터 및 운영 보안","count":6},{"language":"en","tag":"AI Features \u0026 Safety","count":5},{"language":"en","tag":"UI \u0026 Channels","count":5},{"language":"ko","tag":"AI 기능 및 안전","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--brand-primary: #5f22d0;--brand-light: #7c3aed;--brand-dark: #4c1d95;--brand-subtle: #ede9fe;--brand-glow: rgba(95, 34, 208, 0.15);--page-text: #0f172a;--page-muted: #6b7280}body{font-family:\"DM Sans\", sans-serif;color:var(--page-text);font-size:17px}.prose h1,.prose h2,.prose h3,.prose h4{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;letter-spacing:-0.015em}.prose h1{font-size:44px}.prose h2{font-size:28px;margin-top:36px;margin-bottom:10px}.prose h3{font-size:22px;margin-top:28px;margin-bottom:8px}.prose p,.prose li{color:var(--page-text);line-height:1.75;font-size:1rem}.prose hr{border:0;height:1px;background:linear-gradient(90deg, rgba(148, 163, 184, 0.4), rgba(148, 163, 184, 0.05));margin:28px 0}.dark body{color:#e2e8f0}.dark .prose p,.dark .prose li{color:#e2e8f0}.dark .prose hr{background:linear-gradient(90deg, rgba(148, 163, 184, 0.3), rgba(148, 163, 184, 0.05))}[class*=\"Card\"] svg,.card svg,a[href] svg{color:var(--brand-primary)!important}.card [data-component-part=\"card-icon\"]{margin-bottom:8px}.card [data-component-part=\"card-title\"]{margin-top:12px!important}[class*=\"Card\"],.card{border-radius:16px!important;border-color:rgba(148, 163, 184, 0.25)!important;transition:border-color 0.2s ease, box-shadow 0.2s ease, transform 0.2s ease}[class*=\"Card\"]:hover,.card:hover{transform:translateY(-2px);border-color:var(--brand-light)!important;box-shadow:0 4px 20px var(--brand-glow)!important}a:not([class*=\"Card\"]):hover{color:var(--brand-primary)!important}.stable-scrollbar-gutter.overflow-auto{width:220px!important;min-width:220px!important}.stable-scrollbar-gutter.overflow-auto+div,.stable-scrollbar-gutter.overflow-auto~main{flex:1!important}.flex.flex-row-reverse.gap-12{gap:32px!important}.xl\\:flex.self-start.sticky{max-width:15rem!important}.xl\\:flex.box-border.max-h-full.pl-10{width:14rem!important;padding-left:24px!important}.text-sm.leading-6.w-\\[16\\.5rem\\]{width:100%!important;font-size:13px!important;line-height:1.6!important}#table-of-contents-content a{padding:5px 0!important;display:block}#table-of-contents-content,#table-of-contents-content ul{list-style:none!important;padding-left:0!important;margin-left:0!important}#table-of-contents-content li::marker{content:\"\"!important}#table-of-contents-content>li{border-left:2px solid rgba(148, 163, 184, 0.1);padding-left:12px;transition:border-color 0.15s ease}.dark #table-of-contents-content>li{border-left-color:rgba(148, 163, 184, 0.08)}#table-of-contents-content a{color:var(--page-muted)!important;font-weight:400!important;transition:color 0.15s ease}.dark #table-of-contents-content a{color:#94a3b8!important}#table-of-contents-content>li>a{color:var(--page-text)!important;font-weight:500!important}.dark #table-of-contents-content>li>a{color:#e2e8f0!important}#table-of-contents-content>li>ul{padding-left:12px!important}#table-of-contents-content a:hover{color:var(--brand-dark)!important}.dark #table-of-contents-content a:hover{color:#e2e8f0!important}#table-of-contents-content a.text-primary,#table-of-contents-content a.font-semibold,#table-of-contents-content>li.is-active-item>a{color:var(--brand-primary)!important;font-weight:600!important}.dark #table-of-contents-content a.text-primary,.dark #table-of-contents-content a.font-semibold,.dark #table-of-contents-content a[class*=\"dark:text-primary\"],.dark #table-of-contents-content>li.is-active-item>a{color:var(--brand-light)!important;font-weight:600!important}#table-of-contents-content>li.is-active-item{border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li.is-active-item{border-left-color:var(--brand-light)!important}#table-of-contents-content>li:has(>a.border-primary),#table-of-contents-content>li:has(>a.text-primary){border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li:has(>a.border-primary),.dark #table-of-contents-content>li:has(>a.text-primary),.dark #table-of-contents-content>li:has(>a[class*=\"dark:text-primary\"]),.dark #table-of-contents-content>li:has(>a[class*=\"dark:border-primary\"]){border-left-color:var(--brand-light)!important}.landing-hero{text-align:center;padding:72px 32px 24px;max-width:860px;margin:0 auto}.landing-hero h1{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:52px;font-weight:700;letter-spacing:-0.03em;margin:0 0 20px;background:linear-gradient(135deg, var(--brand-dark), var(--brand-primary), var(--brand-light));-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text}.dark .landing-hero h1{background:linear-gradient(135deg, var(--brand-light), #a78bfa, #c4b5fd);-webkit-background-clip:text;background-clip:text}.landing-hero p{font-size:19px;line-height:1.7;color:var(--page-muted);margin:0}.dark .landing-hero p{color:#94a3b8}.landing-section{max-width:1280px;margin:0 auto;padding:0 40px 56px}.landing-section h2{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:26px;font-weight:600;letter-spacing:-0.015em;margin:0 0 6px;color:var(--page-text)}.dark .landing-section h2{color:#e2e8f0}.landing-section>p{color:var(--page-muted);font-size:16px;margin:0 0 24px}.dark .landing-section>p{color:#94a3b8}.landing-cta{max-width:1280px;margin:0 auto;padding:0 40px 48px}.landing-divider{max-width:1280px;margin:0 auto 48px;padding:0 40px}.landing-divider hr{border:0;height:1px;background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.3), transparent);margin:0}.dark .landing-divider hr{background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.15), transparent)}.landing-section [role=\"tablist\"]{margin-bottom:12px}.landing-section [role=\"tabpanel\"]>p:first-child{color:var(--page-muted);font-size:15px;margin-bottom:20px}.dark .landing-section [role=\"tabpanel\"]>p:first-child{color:#94a3b8}.group:has(>.mermaid){background:linear-gradient(135deg, #faf8ff 0%, #f3f0ff 100%);border:1px solid rgba(95, 34, 208, 0.08);border-radius:12px;padding:28px 24px;margin:24px 0}.dark .group:has(>.mermaid){background:linear-gradient(135deg, rgba(95, 34, 208, 0.06) 0%, rgba(95, 34, 208, 0.03) 100%);border-color:rgba(124, 58, 237, 0.12)}.mermaid svg .node rect,.mermaid svg .node circle,.mermaid svg .node ellipse,.mermaid svg .node polygon,.mermaid svg .node path{fill:#ede9fe!important;stroke:#7c3aed!important;stroke-width:1.5px!important;rx:8px}.dark .mermaid svg .node rect,.dark .mermaid svg .node circle,.dark .mermaid svg .node ellipse,.dark .mermaid svg .node polygon,.dark .mermaid svg .node path{fill:rgba(124, 58, 237, 0.15)!important;stroke:#a78bfa!important}.mermaid svg .node.rhombus rect,.mermaid svg .node polygon[points]{fill:#ddd6fe!important;stroke:#6d28d9!important}.dark .mermaid svg .node.rhombus rect,.dark .mermaid svg .node polygon[points]{fill:rgba(109, 40, 217, 0.2)!important;stroke:#a78bfa!important}.mermaid svg .cluster rect{fill:rgba(237, 233, 254, 0.4)!important;stroke:rgba(124, 58, 237, 0.25)!important;stroke-width:1.5px!important;rx:10px!important}.dark .mermaid svg .cluster rect{fill:rgba(124, 58, 237, 0.08)!important;stroke:rgba(167, 139, 250, 0.2)!important}.mermaid svg .cluster-label .nodeLabel,.mermaid svg .cluster span{fill:var(--brand-dark)!important;color:var(--brand-dark)!important;font-weight:600!important}.dark .mermaid svg .cluster-label .nodeLabel,.dark .mermaid svg .cluster span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg .edgePath path.path{stroke:#8b5cf6!important;stroke-width:1.5px!important}.dark .mermaid svg .edgePath path.path{stroke:#a78bfa!important}.mermaid svg .marker{fill:#8b5cf6!important;stroke:#8b5cf6!important}.dark .mermaid svg .marker{fill:#a78bfa!important;stroke:#a78bfa!important}.mermaid svg .label,.mermaid svg .nodeLabel,.mermaid svg .label text,.mermaid svg span{fill:#1e1b4b!important;color:#1e1b4b!important;font-family:\"DM Sans\", sans-serif!important}.dark .mermaid svg .label,.dark .mermaid svg .nodeLabel,.dark .mermaid svg .label text,.dark .mermaid svg span{fill:#e2e8f0!important;color:#e2e8f0!important}.mermaid svg .edgeLabel{background-color:#faf8ff!important}.dark .mermaid svg .edgeLabel{background-color:transparent!important}.mermaid svg .edgeLabel span{fill:#6d28d9!important;color:#6d28d9!important;font-size:13px!important}.dark .mermaid svg .edgeLabel span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg{background:transparent!important}#localization-select-trigger>div:first-child{display:none!important}[data-relocated-lang]{gap:0!important}::selection{background:var(--brand-subtle);color:var(--brand-dark)}.dark ::selection{background:var(--brand-dark);color:#ffffff}*:focus-visible{outline-color:var(--brand-primary)!important}::-webkit-scrollbar-thumb{background:var(--brand-light);border-radius:4px}::-webkit-scrollbar-thumb:hover{background:var(--brand-primary)}.cloo-badge{display:inline-block;font-family:\"DM Sans\", sans-serif;font-size:12px;font-weight:600;line-height:1.5;padding:0 8px;border-radius:6px;letter-spacing:-0.01em;vertical-align:middle;white-space:nowrap;margin-right:2px}.cloo-badge--required{background:#fef2f2;color:#b91c1c}.cloo-badge--multiworker{background:#fff7ed;color:#c2410c}.cloo-badge--recommended{background:#eff6ff;color:#1d4ed8}.cloo-badge--optional{background:#f1f5f9;color:#475569}.dark .cloo-badge--required{background:rgba(185, 28, 28, 0.2);color:#fca5a5}.dark .cloo-badge--multiworker{background:rgba(194, 65, 12, 0.2);color:#fdba74}.dark .cloo-badge--recommended{background:rgba(29, 78, 216, 0.22);color:#93c5fd}.dark .cloo-badge--optional{background:rgba(71, 85, 105, 0.28);color:#cbd5e1}"}]}
{"page":{"pagePath":"en/workspace/agents","slug":"/en/workspace/agents","pageMetadata":{"title":"Agents","description":"Create and manage custom AI assistants combining Knowledge Bases, Tools, and Guardrails","href":"/en/workspace/agents"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create and manage custom AI assistants combining Knowledge Bases, Tools, and Guardrails\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,blockquote:`blockquote`,code:`code`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CodeBlock,Columns,Frame,Heading,Mermaid,Note,OptimizedImage,Step,Steps,Table,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Tired of repeating context to the base AI model, manually pasting internal documents, and re-stating answer formats every time?`}),`\n`,_jsxs(_components.p,{children:[`An Agent bundles a `,_jsx(_components.strong,{children:`Knowledge Base + Tool + Guardrail + System Prompt`}),` together to create a per-department-optimized AI assistant.`]}),`\n`,_jsxs(Note,{children:[_jsxs(_components.p,{children:[`In one line — bundle a `,_jsx(_components.strong,{children:`system prompt + knowledge base + tools + guardrails`}),` into a task-specific AI tailored per team.`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`When does it fit?`}),` When the same context repeats turn after turn, or when answer format and internal-source citations must stay consistent`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`How long to build?`}),` A minimal prompt-only agent takes ~5 min · a full setup with KB, tools, and guardrails is closer to 30 min`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`What about cost?`}),` Each response adds KB retrieval and tool routing on top of the base model, so token usage is higher — for casual questions, the base model is cheaper`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Is this the right tool?`}),` If branching and loops dominate, look at `,_jsx(_components.a,{href:`/en/workspace/flows`,children:`Flows`}),`. If you only need one or two tools, `,_jsx(_components.a,{href:`/en/workspace/tools`,children:`Tools`}),` alone may be enough`]}),`\n`]})]}),`\n`,_jsx(Heading,{level:`3`,id:`example`,children:`Example`}),`\n`,_jsxs(_components.blockquote,{children:[`\n`,_jsx(_components.p,{children:`“Show me this month’s sales status”`}),`\n`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`State`}),_jsx(_components.th,{children:`Behavior`}),_jsx(_components.th,{children:`Result`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Base model`}),_jsx(_components.td,{children:`Guesses from general AI knowledge`}),_jsx(_components.td,{children:`”I cannot access sales data”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Agent (DB + KB connected)`}),_jsx(_components.td,{children:`Queries the sales DB + applies report format`}),_jsx(_components.td,{children:`Accurate sales data + tabular response`})]})]})]}),`\n`,_jsx(Frame,{caption:`View created agents in Workspace > Agents`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/fbBOcvIu_gXv0Pc3/images/en/workspace/agents-list.png?fit=max\u0026auto=format\u0026n=fbBOcvIu_gXv0Pc3\u0026q=85\u0026s=6bdf40f16db0668933ca8350acce5d63`,alt:`Agent list`,\"data-og-width\":`2000`,width:`2000`,\"data-og-height\":`949`,height:`949`,\"data-path\":`images/en/workspace/agents-list.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/fbBOcvIu_gXv0Pc3/images/en/workspace/agents-list.png?w=280\u0026fit=max\u0026auto=format\u0026n=fbBOcvIu_gXv0Pc3\u0026q=85\u0026s=a285e829295a99250d4113562778236e 280w, https://mintcdn.com/cloocus/fbBOcvIu_gXv0Pc3/images/en/workspace/agents-list.png?w=560\u0026fit=max\u0026auto=format\u0026n=fbBOcvIu_gXv0Pc3\u0026q=85\u0026s=92525edd81f36e42adff4d7fdb37a2f0 560w, https://mintcdn.com/cloocus/fbBOcvIu_gXv0Pc3/images/en/workspace/agents-list.png?w=840\u0026fit=max\u0026auto=format\u0026n=fbBOcvIu_gXv0Pc3\u0026q=85\u0026s=d4aa004ebdcd3cea84df5bd83ca5114e 840w, https://mintcdn.com/cloocus/fbBOcvIu_gXv0Pc3/images/en/workspace/agents-list.png?w=1100\u0026fit=max\u0026auto=format\u0026n=fbBOcvIu_gXv0Pc3\u0026q=85\u0026s=401615327a9363e0a26ffb070583a96a 1100w, https://mintcdn.com/cloocus/fbBOcvIu_gXv0Pc3/images/en/workspace/agents-list.png?w=1650\u0026fit=max\u0026auto=format\u0026n=fbBOcvIu_gXv0Pc3\u0026q=85\u0026s=33d34d07164448a8073bb5a661b0b254 1650w, https://mintcdn.com/cloocus/fbBOcvIu_gXv0Pc3/images/en/workspace/agents-list.png?w=2500\u0026fit=max\u0026auto=format\u0026n=fbBOcvIu_gXv0Pc3\u0026q=85\u0026s=212a5c0ea84233d4d22b8dda26e4d71d 2500w`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`agent-processing-pipeline`,children:`Agent Processing Pipeline`}),`\n`,_jsx(_components.p,{children:`The agent receives a user question and generates a response through this pipeline.`}),`\n`,_jsx(Mermaid,{chart:`flowchart LR\n A[User question] --> B[Guardrail validation]\n B --> C{Pass?}\n C -->|No| D[Block / mask]\n C -->|Yes| E[Knowledge Base search]\n E --> F[Tool calls]\n F --> G[LLM response]\n G --> H[Auto evaluation]\n H --> I[Return response]`}),`\n`,_jsx(_components.p,{children:`A guardrail validates the input, the Knowledge Base retrieves related documents, tools (API, DB) are invoked when needed, and the LLM produces the final response.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`which-should-you-use`,children:`Which Should You Use?`}),`\n`,_jsx(_components.p,{children:`Agent, Base Model, and Flow look similar but fit different situations.`}),`\n`,_jsxs(Columns,{cols:3,children:[_jsxs(Card,{title:`Base Model`,icon:`comments`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`When`}),` — One-off questions, free-form answers, general knowledge.`]}),_jsx(_components.p,{children:`Casual prompts like “what does this code mean?” or “what’s today’s FX rate” are fastest and cheapest here. No KB retrieval or tool routing means lower token usage.`})]}),_jsxs(Card,{title:`Agent`,icon:`robot`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`When`}),` — Repeated KB citations, fixed tone or format, guardrails required.`]}),_jsxs(_components.p,{children:[`HR policy Q\u0026A, code reviewers, data analysts — the pattern of `,_jsx(_components.strong,{children:`letting the LLM decide which KB to cite and which tool to call`}),`.`]})]}),_jsxs(Card,{title:`Flow`,icon:`diagram-project`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`When`}),` — Branching, loops, or external API chains dominate.`]}),_jsxs(_components.p,{children:[`Form input → automated processing → notification, multi-step approvals, and similar automation. `,_jsx(_components.strong,{children:`You specify the decision flow as nodes`}),`, so behavior is predictable.`]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`When in doubt, `,_jsx(_components.strong,{children:`start with an Agent`}),`. If it feels like overkill for simple questions, drop down to the base model; if you find yourself wanting if/else branches, move it to a `,_jsx(_components.a,{href:`/en/workspace/flows`,children:`Flow`}),`. You don’t have to pick the right one on the first try.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`creating-an-agent`,children:`Creating an Agent`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Enter basic info`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Workspace > Agents > ”+ New Agent”`}),` and fill in basic info.`]}),_jsx(Frame,{caption:`Set the agent's name, description, and profile image`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-create-basic.png?fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=adae86300961493b0d9ac7fb3ae6fc32`,alt:`Agent basic info`,\"data-og-width\":`1911`,width:`1911`,\"data-og-height\":`906`,height:`906`,\"data-path\":`images/en/workspace/agents-create-basic.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-create-basic.png?w=280\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=b73b0b828e01c140eb9c88e6c10c9c9e 280w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-create-basic.png?w=560\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=6e0753d98314073a9cad7a19f5adc35c 560w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-create-basic.png?w=840\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=6c07169b11fa4c86da4f47c30aaccf97 840w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-create-basic.png?w=1100\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=95353da9428f8453bf86c60a333b0834 1100w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-create-basic.png?w=1650\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=9812a69dd65a5bcf5bce73a6d2a16426 1650w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-create-basic.png?w=2500\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=1e2fc310870ab2f4daa829a0fde051dc 2500w`})}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Example`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Agent Name`})}),_jsx(_components.td,{children:`Agent display name`}),_jsx(_components.td,{children:`”Marketing Assistant”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Description`})}),_jsx(_components.td,{children:`What the agent does`}),_jsx(_components.td,{children:`”Marketing content creation and analysis support”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Agent Image`})}),_jsx(_components.td,{children:`Agent icon`}),_jsx(_components.td,{children:`Marketing-related image`})]})]})]})]}),_jsx(Step,{title:`Pick the base model`,children:_jsx(_components.p,{children:`Choose the AI model the agent will use. Pick from the model list registered by the admin.`})}),_jsxs(Step,{title:`Write the prompts`,children:[_jsx(_components.p,{children:`Define the agent’s role, persona, and response rules.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Task Prompt`})}),_jsx(_components.td,{children:`Defines the agent’s role, persona, restrictions, and concrete task instructions. Plays the role of the general system prompt.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Response Format Prompt`})}),_jsxs(_components.td,{children:[`Specifies the response format and structure (markdown, table, etc.). This is the `,_jsx(_components.strong,{children:`default answer format`}),` — when Response Formats are registered below, it is used when no registered format fits the question.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Response Formats`})}),_jsxs(_components.td,{children:[`Optional. Use `,_jsx(_components.strong,{children:`”+ Add Response Format”`}),` to register multiple answer styles per question type; the agent automatically picks the one that fits each question. Leave empty and the Response Format Prompt above always applies.`]})]})]})]}),_jsxs(_components.p,{children:[`Click the `,_jsx(_components.strong,{children:`Generate with AI`}),` button next to each prompt field — it analyzes the agent’s name, description, and connected resources to draft the prompt automatically.`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`During AI auto-generation, technical instructions (tool usage, SQL writing rules, etc.) are `,_jsx(_components.strong,{children:`automatically excluded`}),`. The platform handles those — the prompt only contains role, persona, and restrictions.`]})}),_jsx(Frame,{caption:`Write the Task Prompt (role definition) and Response Format Prompt (output format) separately`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-task-prompt.png?fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=e9f002da422024d8efdc01fc6b4e49f4`,alt:`Task prompt input`,\"data-og-width\":`882`,width:`882`,\"data-og-height\":`525`,height:`525`,\"data-path\":`images/en/workspace/agents-task-prompt.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-task-prompt.png?w=280\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=c2193503fa9e8c7d3909b6d7828015a7 280w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-task-prompt.png?w=560\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=6e2393da7a3124047230d0df2d24fa81 560w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-task-prompt.png?w=840\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=1cec47749bdc492bfeb3bd7f20e987b2 840w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-task-prompt.png?w=1100\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=4244ff10adb63c2e8ba40d6552e2f113 1100w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-task-prompt.png?w=1650\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=45363e7ca7832c2fe232dfbbc6c4e317 1650w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-task-prompt.png?w=2500\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=8a052b74990d99310e33441fb88c7eb2 2500w`})}),_jsx(Accordion,{title:`Example of a good task prompt`,id:`example-of-a-good-task-prompt`,children:_jsx(CodeBlock,{filename:``,numberOfLines:`16`,language:`markdown`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`markdown`,children:_jsxs(_components.code,{language:`markdown`,numberOfLines:`16`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`You are Cloocus's marketing assistant.`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-light-font-weight\":`bold`,\"--shiki-dark\":`#569CD6`,\"--shiki-dark-font-weight\":`bold`},children:`## Role`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Support marketing content creation`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Draft social media posts`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Analyze marketing data`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-light-font-weight\":`bold`,\"--shiki-dark\":`#569CD6`,\"--shiki-dark-font-weight\":`bold`},children:`## Response Rules`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Always respond in Korean`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Maintain a professional yet friendly tone`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Provide data-driven insights`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Comply with brand guidelines`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-light-font-weight\":`bold`,\"--shiki-dark\":`#569CD6`,\"--shiki-dark-font-weight\":`bold`},children:`## Restrictions`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Do not disparage competitors`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Do not use unverified statistics`})]}),`\n`]})})})}),_jsxs(Accordion,{title:`Why are the Task Prompt and Response Format Prompt separated?`,id:`why-are-the-task-prompt-and-response-format-prompt-separated`,children:[_jsxs(_components.p,{children:[`The two prompts are used at `,_jsx(_components.strong,{children:`different stages`}),` of agent execution.`]}),_jsx(Mermaid,{chart:`flowchart TD\n A[\"① Apply Task Prompt\"] --> B[Agent calls tools to gather data]\n B --> C[KB search, DB lookup, web search, etc.]\n C --> D[\"② Apply Response Format Prompt\"]\n D --> E[Compose the final answer from collected data]`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{}),_jsx(_components.th,{children:`Task Prompt`}),_jsx(_components.th,{children:`Response Format Prompt`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`When applied`})}),_jsx(_components.td,{children:`While the agent is using tools`}),_jsx(_components.td,{children:`When composing the final answer`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Role`})}),_jsx(_components.td,{children:`”What to do” (role, restrictions)`}),_jsx(_components.td,{children:`“How to answer” (markdown, tables, length)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Include`})}),_jsx(_components.td,{children:`Role definition, behavior rules, restrictions`}),_jsx(_components.td,{children:`Output format, tone, structure`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Don’t include`})}),_jsx(_components.td,{children:`Output format specs`}),_jsx(_components.td,{children:`Role definition, behavior rules`})]})]})]}),_jsxs(_components.p,{children:[`Separating them lets you `,_jsx(_components.strong,{children:`change just the output format while keeping the role`}),`, or vice versa.`]})]})]}),_jsxs(Step,{title:`Configure prompt suggestions (optional)`,children:[_jsx(_components.p,{children:`Set conversation-starter suggestions shown when an agent is selected in chat.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Option`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Default`})}),_jsx(_components.td,{children:`Use system default suggestions`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Custom`})}),_jsx(_components.td,{children:`Set agent-specific suggestions`})]})]})]}),_jsx(Tip,{children:_jsx(_components.p,{children:`Providing example questions matched to the agent’s purpose helps users start conversations quickly.\nExamples: “Summarize this month’s sales”, “Draft a social media post”`})})]}),_jsxs(Step,{title:`Connect Knowledge Bases`,children:[_jsx(_components.p,{children:`Attach documents the agent should reference.`}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`“Select Knowledge”`}),` in the “Knowledge Base” section`]}),`\n`,_jsx(_components.li,{children:`Select Knowledge Bases to connect (multiple supported)`}),`\n`]}),_jsx(_components.p,{children:`Connected Knowledge Bases are searched via RAG and used in answers, with citations.`}),_jsx(Frame,{caption:`When you connect multiple Knowledge Bases, the agent automatically picks the right one based on the question`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-knowledge.png?fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=21768cd598ee7736ba99411af59e3316`,alt:`Agent Knowledge Base connections`,\"data-og-width\":`767`,width:`767`,\"data-og-height\":`784`,height:`784`,\"data-path\":`images/en/workspace/agents-knowledge.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-knowledge.png?w=280\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=493d915328ef134fe6151cff8dbc469e 280w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-knowledge.png?w=560\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=47a4eefdd9a883a85b4b0f0405c99c11 560w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-knowledge.png?w=840\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=287ed335dfc38efd4085a0bf81350aeb 840w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-knowledge.png?w=1100\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=87844f6f2729d2fcfcb7fec39f9558d2 1100w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-knowledge.png?w=1650\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=7398df26327f311a06201ba24434baac 1650w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-knowledge.png?w=2500\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=744af3dd431d89c2d00d31d2a1fb9a66 2500w`})})]}),_jsxs(Step,{title:`Connect databases (optional)`,children:[_jsxs(_components.p,{children:[`Connect a `,_jsx(_components.a,{href:`/en/workspace/database`,children:`Database (DbSphere)`}),` for natural-language data queries (NL-to-SQL).`]}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`“Select Database”`}),` in the “Database” section`]}),`\n`,_jsx(_components.li,{children:`Select databases (multiple supported)`}),`\n`]}),_jsx(_components.p,{children:`Ask questions in natural language about the connected DB; the AI generates and runs SQL, returning results.`})]}),_jsxs(Step,{title:`Connect glossaries (optional)`,children:[_jsxs(_components.p,{children:[`Connect a `,_jsx(_components.a,{href:`/en/workspace/glossary`,children:`Glossary`}),` so the agent understands your organization’s business terminology.`]}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`“Select Glossary”`}),` in the “Glossary” section`]}),`\n`,_jsx(_components.li,{children:`Select glossaries (multiple supported)`}),`\n`]}),_jsx(_components.p,{children:`Term definitions, synonyms, and context registered in the glossary are reflected in agent responses.`})]}),_jsxs(Step,{title:`Connect tools (optional)`,children:[_jsx(_components.p,{children:`Connect tools for external system integration. In the “Tool Connections” section, choose MCP servers or OpenAPI servers.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tool Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`OpenAPI server`})}),_jsx(_components.td,{children:`Interact with external services via REST API`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`MCP server`})}),_jsx(_components.td,{children:`Tool integration via Model Context Protocol`})]})]})]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`If a connected tool’s `,_jsx(_components.strong,{children:`description is empty, a warning banner appears at the top of the editor`}),`. The tool description is the LLM’s primary cue for “when to call this tool”, so a missing description leads to incorrect calls or unused tools. When the banner appears, fill in the description from the `,_jsx(_components.a,{href:`/en/workspace/tools`,children:`tool definition`}),`.`]})})]}),_jsxs(Step,{title:`Capability settings (optional)`,children:[_jsxs(_components.p,{children:[`Configure advanced features the agent can use. Each capability has `,_jsx(_components.strong,{children:`3 states`}),`.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`State`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Disabled`})}),_jsx(_components.td,{children:`The capability is completely hidden in chat (default)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Default On`})}),_jsx(_components.td,{children:`Auto-enabled at chat start, user can turn off`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Default Off`})}),_jsx(_components.td,{children:`Visible in chat, but user must turn it on`})]})]})]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Capability`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Web Search`})}),_jsx(_components.td,{children:`Real-time web search for up-to-date info. Configurable result count and domain filter`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Image Generation`})}),_jsx(_components.td,{children:`AI image generation engine integration. Pick which connection to use`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Gmail`})}),_jsx(_components.td,{children:`Read and send mail on the user’s behalf`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Google Calendar`})}),_jsx(_components.td,{children:`Read and create calendar events on the user’s behalf`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Google Drive`})}),_jsx(_components.td,{children:`Search files and create Google documents on the user’s behalf`})]})]})]}),_jsxs(_components.p,{children:[`Separately from those five, four settings on the same screen control `,_jsx(_components.strong,{children:`how the agent answers`}),`. These take individual values rather than the three states above.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Show Reasoning`})}),_jsxs(_components.td,{children:[`Show tool calls (arguments / results) and thinking as collapsible blocks before the answer. Choose `,_jsx(_components.code,{children:`Brief`}),` (tool name only), `,_jsx(_components.code,{children:`Detailed`}),` (live reasoning steps), or `,_jsx(_components.code,{children:`None`})]}),_jsx(_components.td,{style:{textAlign:`center`},children:`Brief`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Grounding`})}),_jsx(_components.td,{children:`Restrict answers to the connected data sources (knowledge bases, databases, tools). When off, the agent falls back to general knowledge if the sources do not cover the question`}),_jsx(_components.td,{style:{textAlign:`center`},children:`On`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Ask the User`})}),_jsx(_components.td,{children:`Lets the agent ask you back (with buttons or free text) when a critical detail is missing or the request is ambiguous`}),_jsx(_components.td,{style:{textAlign:`center`},children:`Off`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Document Generation`})}),_jsx(_components.td,{children:`Lets the agent generate PPT / Word / Excel files with the built-in tool`}),_jsx(_components.td,{style:{textAlign:`center`},children:`Off`})]})]})]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`The default for `,_jsx(_components.strong,{children:`Grounding`}),` depends on the screen — it is on when editing an agent, and off when editing a base model.`]})}),_jsx(Note,{children:_jsxs(_components.p,{children:[`Even when Gmail, Calendar, and Drive are enabled here, they appear in chat only after `,_jsx(_components.strong,{children:`the user connects their own Google account under Settings > Connections`}),`. Code execution is not an agent capability — see `,_jsx(_components.a,{href:`/en/chat/capabilities`,children:`Code Execution`}),`.`]})}),_jsx(Frame,{caption:`The five chat capabilities use three states; the four response settings take individual values`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/E0pzkKQUX30iu2PY/images/en/workspace/agents-capabilities.png?fit=max\u0026auto=format\u0026n=E0pzkKQUX30iu2PY\u0026q=85\u0026s=741d692b3a6dda372ce23920abc1442a`,alt:`Agent capability settings`,\"data-og-width\":`1752`,width:`1752`,\"data-og-height\":`1610`,height:`1610`,\"data-path\":`images/en/workspace/agents-capabilities.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/E0pzkKQUX30iu2PY/images/en/workspace/agents-capabilities.png?w=280\u0026fit=max\u0026auto=format\u0026n=E0pzkKQUX30iu2PY\u0026q=85\u0026s=ee01b894bb56a216b34f92058411b400 280w, https://mintcdn.com/cloocus/E0pzkKQUX30iu2PY/images/en/workspace/agents-capabilities.png?w=560\u0026fit=max\u0026auto=format\u0026n=E0pzkKQUX30iu2PY\u0026q=85\u0026s=5c20dde49fa885027ca77841b0eeb7ea 560w, https://mintcdn.com/cloocus/E0pzkKQUX30iu2PY/images/en/workspace/agents-capabilities.png?w=840\u0026fit=max\u0026auto=format\u0026n=E0pzkKQUX30iu2PY\u0026q=85\u0026s=55031175ef40f7e66003425dbb1f8262 840w, https://mintcdn.com/cloocus/E0pzkKQUX30iu2PY/images/en/workspace/agents-capabilities.png?w=1100\u0026fit=max\u0026auto=format\u0026n=E0pzkKQUX30iu2PY\u0026q=85\u0026s=9ce143936ed1eabdc1e40d26a00101de 1100w, https://mintcdn.com/cloocus/E0pzkKQUX30iu2PY/images/en/workspace/agents-capabilities.png?w=1650\u0026fit=max\u0026auto=format\u0026n=E0pzkKQUX30iu2PY\u0026q=85\u0026s=15b3b7222e5f4fd1e38cbe2d53104c52 1650w, https://mintcdn.com/cloocus/E0pzkKQUX30iu2PY/images/en/workspace/agents-capabilities.png?w=2500\u0026fit=max\u0026auto=format\u0026n=E0pzkKQUX30iu2PY\u0026q=85\u0026s=21ed1fc4d6101edadf075344837a0810 2500w`})})]}),_jsxs(Step,{title:`Response format (optional)`,children:[_jsxs(_components.p,{children:[`Constrain the agent’s response to a `,_jsx(_components.strong,{children:`structured JSON format`}),`.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Mode`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Chat`})}),_jsx(_components.td,{children:`Default freeform text response`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Structured Output`})}),_jsx(_components.td,{children:`Structured response per JSON Schema`})]})]})]}),_jsx(_components.p,{children:`In Structured mode, define the response schema with the visual field builder or the raw JSON editor.`}),_jsx(Frame,{caption:`Define the response structure with JSON Schema in Structured mode`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-response-format.png?fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=1f83252329738df375db99b0f8e6a6a9`,alt:`Response format settings`,\"data-og-width\":`884`,width:`884`,\"data-og-height\":`408`,height:`408`,\"data-path\":`images/en/workspace/agents-response-format.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-response-format.png?w=280\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=bdc81798dd136f341d1ecafa64920dd0 280w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-response-format.png?w=560\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=32bab0fba2f32d12c4c9fe33292dc393 560w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-response-format.png?w=840\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=07ba979b2ec17981f5915727a62d3690 840w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-response-format.png?w=1100\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=40f4aacf9658acaa916afe448d33fa93 1100w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-response-format.png?w=1650\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=1d98ffc37405e03b3ebd19f9d7d8ee05 1650w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-response-format.png?w=2500\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=2f11a75314509d0e32a12e8ced6601dd 2500w`})})]}),_jsxs(Step,{title:`Guardrail settings (optional)`,children:[_jsx(_components.p,{children:`Attach security guardrails to validate I/O.`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Auto-detect and mask PII`}),`\n`,_jsx(_components.li,{children:`Custom pattern filtering`}),`\n`,_jsx(_components.li,{children:`Block prohibited words`}),`\n`,_jsx(_components.li,{children:`LLM-based content validation`}),`\n`]})]}),_jsxs(Step,{title:`Auto-evaluation settings (optional)`,children:[_jsx(_components.p,{children:`Automatically monitor response quality.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Judge Model`})}),_jsx(_components.td,{children:`LLM to use for evaluation`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Sampling rate`})}),_jsx(_components.td,{children:`Share of responses to evaluate (1%–100%)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Evaluation type`})}),_jsx(_components.td,{children:`Choose from retrieval quality, faithfulness, response quality`})]})]})]}),_jsx(Accordion,{title:`Evaluation type details`,id:`evaluation-type-details`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Retrieval Quality`})}),_jsx(_components.td,{children:`Relevance of documents retrieved from the Knowledge Base`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Faithfulness`})}),_jsx(_components.td,{children:`Whether the response is faithful to retrieved content (no hallucination)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Response Quality`})}),_jsx(_components.td,{children:`Overall quality, usefulness, and accuracy of the response`})]})]})]})}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Sampling-rate guidance:`})}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Situation`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Recommended`}),_jsx(_components.th,{children:`Reason`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`New agent (validation phase)`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`50–100%`}),_jsx(_components.td,{children:`Need initial quality picture`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Stabilized agent`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`5–10%`}),_jsx(_components.td,{children:`Save costs while monitoring`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Critical-business agent`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`20–30%`}),_jsx(_components.td,{children:`Continuous quality assurance needed`})]})]})]}),_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Retrieval Quality`}),` and `,_jsx(_components.strong,{children:`Faithfulness`}),` evaluations only run when there are Knowledge Base search results. For agents without a KB, choose `,_jsx(_components.strong,{children:`Response Quality`}),` only.`]})}),_jsx(Frame,{caption:`Enable auto-evaluation to continuously monitor response quality`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-auto-eval.png?fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=43bf969af90b75ce7c1fd70bfdf03d26`,alt:`Auto-evaluation settings`,\"data-og-width\":`879`,width:`879`,\"data-og-height\":`615`,height:`615`,\"data-path\":`images/en/workspace/agents-auto-eval.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-auto-eval.png?w=280\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=378fe5998db8116dc12da7bc3eddab9a 280w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-auto-eval.png?w=560\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=6a407bf63e4311027468169ca340b0fa 560w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-auto-eval.png?w=840\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=c5d3ccfef7dc1c83e6bee76680e90337 840w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-auto-eval.png?w=1100\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=82f20bcecea40b0e45676190f0d77224 1100w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-auto-eval.png?w=1650\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=f8872b1b13e808bc3d071f1aedaac2a3 1650w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/en/workspace/agents-auto-eval.png?w=2500\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=9b26cb2c4ec5a1de272f91c41af26a5f 2500w`})})]}),_jsxs(Step,{title:`Access permissions`,children:[_jsx(_components.p,{children:`Set who can use the agent.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Option`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Public`})}),_jsx(_components.td,{children:`Available to all users`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Private`})}),_jsx(_components.td,{children:`Available only to you`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Group`})}),_jsx(_components.td,{children:`Available to members of the specified groups`})]})]})]}),_jsx(Frame,{caption:`Access Control modal — search and add groups, then set Editable per row`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/en/workspace/agents-access-control.png?fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=a3baf67d4638155565e38a4fb8e20d69`,alt:`Access control settings`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/en/workspace/agents-access-control.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/en/workspace/agents-access-control.png?w=280\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=375d6226b86a26d640a93529ec00a078 280w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/en/workspace/agents-access-control.png?w=560\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=76bc394aca3633f4d31922c0a23c92f0 560w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/en/workspace/agents-access-control.png?w=840\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=f87454399d6a8ab317078d64767de2f3 840w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/en/workspace/agents-access-control.png?w=1100\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=f5ee8099d58904db3e81fbf77f342f7a 1100w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/en/workspace/agents-access-control.png?w=1650\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=c7fc41d731e41739b5ada5bd2b82a024 1650w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/en/workspace/agents-access-control.png?w=2500\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=3bf01dbb47758b06c43620e2b28b6313 2500w`})})]}),_jsx(Step,{title:`Save`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Save \u0026 Create`}),` to create the agent.`]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`using-agents`,children:`Using Agents`}),`\n`,_jsx(Heading,{level:`3`,id:`select-in-chat`,children:`Select in Chat`}),`\n`,_jsx(_components.p,{children:`In the model selector dropdown at the top of the chat, pick an agent. Agents appear in the list alongside regular models.`}),`\n`,_jsx(Heading,{level:`3`,id:`invoke-with-@`,children:`Invoke with @`}),`\n`,_jsxs(_components.p,{children:[`Call a specific agent in chat with `,_jsx(_components.code,{children:`@agent-name`}),`.`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`@MarketingAssistant Draft 5 social posts for this month's promotion`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`agent-management`,children:`Agent Management`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Action`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Activate / Deactivate`})}),_jsx(_components.td,{children:`Toggle on the agent card to enable/disable. Inactive agents can’t be selected in chat`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Edit`})}),_jsx(_components.td,{children:`Click the agent card to edit settings`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Clone`})}),_jsx(_components.td,{children:`Quickly create a new agent by copying an existing one`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Export / Import`})}),_jsx(_components.td,{children:`Back up and migrate agent settings between environments via JSON`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Delete`})}),_jsx(_components.td,{children:`Permanently delete the agent (no recovery)`})]})]})]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Use export/import to move agents created in a development environment over to production.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`real-world-scenarios`,children:`Real-World Scenarios`}),`\n`,_jsx(_components.p,{children:`Concrete situations from operations and how to configure for them — use these as a starting point if your case is similar.`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`HR Assistant — Policy Q\u0026A`,icon:`user-tie`,id:`hr-assistant-policy-q-and-a`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Situation`}),`: HR fields the same questions about leave, benefits, and employment policy. Answers need to cite the specific policy article to be trusted.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Configuration`}),`:`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Value`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Base model`}),_jsx(_components.td,{children:`GPT-4o-mini (low cost, sufficient for fact-based answers)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Knowledge Base`}),_jsx(_components.td,{children:`HR policy, benefits guide PDFs`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`System prompt`}),_jsx(_components.td,{children:`”HR specialist. Always cite the article number at the end. Never speculate”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Guardrail`}),_jsx(_components.td,{children:`Output PII masking (block employee identifiers)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Permissions`}),_jsx(_components.td,{children:`Private / Read access for company-wide group`})]})]})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Build sequence`}),`: Create KB → upload PDFs → create Agent → connect KB → write system prompt → attach guardrail → publish to org`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Common pitfalls`}),`:`]}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Stuffing too many docs in one KB hurts retrieval accuracy → keep HR domain separate`}),`\n`,_jsx(_components.li,{children:`Without explicit “cite source” instruction, the LLM hallucinates → bake into system prompt`}),`\n`]})]}),_jsxs(Accordion,{title:`Code Reviewer — Internal Conventions`,icon:`code`,id:`code-reviewer-internal-conventions`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Situation`}),`: Each team has different coding rules (naming, error handling, lint), and new hires keep asking on Slack.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Configuration`}),`:`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Value`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Base model`}),_jsx(_components.td,{children:`Claude Sonnet 4.x (strong code-context understanding)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Knowledge Base`}),_jsx(_components.td,{children:`Coding guidelines wiki, API reference`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`System prompt`}),_jsx(_components.td,{children:`”Tag review items as [Improvement] / [OK] / [Question]. Cite guideline section”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Tools`}),_jsx(_components.td,{children:`None (direct codebase access belongs in a separate MCP server)`})]})]})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Build sequence`}),`: Organize guidelines into a KB → create Agent → assign `,_jsx(_components.code,{children:`@code-reviewer`}),` handle → invoke in chat with `,_jsx(_components.code,{children:`@code-reviewer review this function`})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Common pitfalls`}),`:`]}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Outdated guidelines → set a KB sync cadence`}),`\n`,_jsx(_components.li,{children:`Pasting whole files explodes token cost → guide users toward function-level review`}),`\n`]})]}),_jsxs(Accordion,{title:`Data Analyst — DB Connection + Data Dictionary`,icon:`chart-line`,id:`data-analyst-db-connection-data-dictionary`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Situation`}),`: Non-technical users want answers like “TOP 5 sellers this month” without bothering BI for SQL.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Configuration`}),`:`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Value`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Base model`}),_jsx(_components.td,{children:`GPT-4o (stable for SQL generation and tabular rendering)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Database`}),_jsx(_components.td,{children:`Sales DB attached via DbSphere`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Knowledge Base`}),_jsx(_components.td,{children:`Data dictionary (table/column meanings)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`System prompt`}),_jsx(_components.td,{children:`”Render query results as a table. Cite the source table name”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Guardrail`}),_jsx(_components.td,{children:`Block SQL injection input patterns`})]})]})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Build sequence`}),`: Register DB in DbSphere + extract schema → write data dictionary KB → create Agent → connect DB and KB`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Common pitfalls`}),`:`]}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Skipping schema extraction makes the LLM guess column names → bad SQL`}),`\n`,_jsx(_components.li,{children:`Full-table SELECTs blow up costs → enforce LIMIT in the system prompt`}),`\n`,_jsx(_components.li,{children:`For sensitive columns (e.g., salary), use column-level blocking on the DB connection`}),`\n`]})]}),_jsxs(Accordion,{title:`Embedded Customer Support — External Site`,icon:`headset`,id:`embedded-customer-support-external-site`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Situation`}),`: Embed a chatbot on the product site so anonymous visitors can ask FAQs — but `,_jsx(_components.strong,{children:`no internal information`}),` must leak.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Configuration`}),`:`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Value`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Base model`}),_jsx(_components.td,{children:`GPT-4o-mini (low-cost, handles external traffic)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Knowledge Base`}),_jsx(_components.td,{children:`Public FAQ and product manual only (no internal docs)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`System prompt`}),_jsx(_components.td,{children:`”Never speculate about internal info or pricing. If unsure, ask the visitor to contact a human”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Guardrail`}),_jsx(_components.td,{children:`Block PII / internal codenames / unreleased pricing in output`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Embed widget`}),_jsx(_components.td,{children:`Guest mode ON, side-bottom placement`})]})]})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Build sequence`}),`: Split a public-only KB → write guardrail policies → create Agent (public visibility) → select this agent in `,_jsx(_components.a,{href:`/en/admin/settings/embed-widgets`,children:`Embed Widget settings`}),` → enable guest mode`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Common pitfalls`}),`:`]}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Mixing internal and public KBs leaks internal info → separate at the KB level`}),`\n`,_jsx(_components.li,{children:`Guardrails validate output, KB separation isolates information — you need both`}),`\n`]})]}),_jsxs(Accordion,{title:`Meeting Notes Summarizer — Minimal Build`,icon:`file-lines`,id:`meeting-notes-summarizer-minimal-build`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Situation`}),`: Summarize weekly meeting notes for Slack. No KB or tools needed — just text shaping.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Configuration`}),`:`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Value`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Base model`}),_jsx(_components.td,{children:`Claude Sonnet 4.x`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Knowledge Base`}),_jsx(_components.td,{children:`None`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`System prompt`}),_jsx(_components.td,{children:`”Given meeting notes, output: 1) Decisions 2) Action items (owner / due) 3) Next agenda”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Tools`}),_jsx(_components.td,{children:`None`})]})]})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Build sequence`}),`: Create Agent → write system prompt only → paste notes in chat`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`When this is enough`}),`: When you only want to bundle “prompt + model” without KB/tools/guardrails. 5 minutes to build. If even simpler, the `,_jsx(_components.a,{href:`/en/workspace/prompts`,children:`Prompts`}),` feature may be all you need.`]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`best-practices`,children:`Best Practices`}),`\n`,_jsx(Heading,{level:`3`,id:`prompt-writing`,children:`Prompt Writing`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Define the role clearly`}),` — “You are a content specialist on Cloocus’s marketing team”`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Provide concrete instructions`}),` — response language, length, citation rules, etc.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Set restrictions`}),` — no competitor disparagement, no PII exposure, etc.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`knowledge-base-connection`,children:`Knowledge Base Connection`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Connect only relevant documents`}),`: Too many documents actually degrade retrieval accuracy`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Keep documents up-to-date`}),`: Refresh stale information regularly`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Write tool descriptions`}),`: Detailed tool descriptions for Knowledge Bases improve agent KB selection accuracy`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`access-permissions`,children:`Access Permissions`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Principle of least privilege`}),`: Grant access only to those who need it`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Manage by group`}),`: More efficient than per-user assignment`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Review periodically`}),`: Check permission settings on a regular cadence`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`What's the difference between an agent and a base model?`,icon:`circle-question`,id:`whats-the-difference-between-an-agent-and-a-base-model`,children:_jsx(_components.p,{children:`Agents add Knowledge Bases, Tools, system prompts, and Guardrails to a base model, optimizing it for a specific task. Use the base model for general-purpose chat and agents for task-specialized chat.`})}),_jsx(Accordion,{title:`Can I connect multiple Knowledge Bases to one agent?`,icon:`circle-question`,id:`can-i-connect-multiple-knowledge-bases-to-one-agent`,children:_jsxs(_components.p,{children:[`Yes — connect multiple Knowledge Bases and databases at once. The agent automatically picks the appropriate resource based on the question. Writing a detailed `,_jsx(_components.strong,{children:`Tool Description`}),` for each Knowledge Base improves selection accuracy.`]})}),_jsxs(Accordion,{title:`Web Search / Image Generation / Google Workspace doesn't work`,icon:`triangle-exclamation`,id:`web-search-image-generation-google-workspace-doesnt-work`,children:[_jsx(_components.p,{children:`Check the agent’s capability settings:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Disabled`}),`: The capability is completely hidden in chat`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Default Off`}),`: User must turn it on in the chat input`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Default On`}),`: Auto-enabled. If still not working, check admin settings (web search/image generation connections)`]}),`\n`]}),_jsxs(_components.p,{children:[`Gmail, Calendar, and Drive additionally require `,_jsx(_components.strong,{children:`the user’s own Google account connection`}),` and the group’s permission before they appear in chat.`]})]}),_jsx(Accordion,{title:`Is agent usage tracked?`,icon:`circle-question`,id:`is-agent-usage-tracked`,children:_jsx(_components.p,{children:`Yes — view per-agent usage, token consumption, and auto-evaluation results in the monitoring dashboard.`})}),_jsx(Accordion,{title:`Can I move an agent to another environment?`,icon:`circle-question`,id:`can-i-move-an-agent-to-another-environment`,children:_jsxs(_components.p,{children:[`Yes — use `,_jsx(_components.strong,{children:`Export`}),` to download the JSON, then `,_jsx(_components.strong,{children:`Import`}),` in the other environment. Note: connected Knowledge Bases, tools, and guardrails must be set up separately in the target environment.`]})}),_jsx(Accordion,{title:`Can I hide an agent?`,icon:`circle-question`,id:`can-i-hide-an-agent`,children:_jsxs(_components.p,{children:[`Yes — use the toggle at the top-right of the agent card to change its state to `,_jsx(_components.strong,{children:`Disabled`}),`, and it’s hidden from the chat model selector. The agent isn’t deleted and can be shown again.`]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`related-pages`,children:`Related Pages`}),`\n`,_jsxs(Columns,{cols:3,children:[_jsx(Card,{title:`Knowledge Base`,icon:`database`,href:`/en/workspace/knowledge`,children:_jsx(_components.p,{children:`Document-based knowledge stores you can attach to agents`})}),_jsx(Card,{title:`Guardrails`,icon:`shield-check`,href:`/en/workspace/guardrails`,children:_jsx(_components.p,{children:`Validate agent I/O for security`})}),_jsx(Card,{title:`Tools`,icon:`wrench`,href:`/en/workspace/tools`,children:_jsx(_components.p,{children:`OpenAPI / MCP external service integration`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Agents","description":"Create and manage custom AI assistants combining Knowledge Bases, Tools, and Guardrails","href":"/en/workspace/agents"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Example","slug":"example","depth":3,"children":[]},{"title":"Agent Processing Pipeline","slug":"agent-processing-pipeline","depth":2,"children":[]},{"title":"Which Should You Use?","slug":"which-should-you-use","depth":2,"children":[]},{"title":"Creating an Agent","slug":"creating-an-agent","depth":2,"children":[]},{"title":"Using Agents","slug":"using-agents","depth":2,"children":[{"title":"Select in Chat","slug":"select-in-chat","depth":3,"children":[]},{"title":"Invoke with @","slug":"invoke-with-@","depth":3,"children":[]}]},{"title":"Agent Management","slug":"agent-management","depth":2,"children":[]},{"title":"Real-World Scenarios","slug":"real-world-scenarios","depth":2,"children":[]},{"title":"Best Practices","slug":"best-practices","depth":2,"children":[{"title":"Prompt Writing","slug":"prompt-writing","depth":3,"children":[]},{"title":"Knowledge Base Connection","slug":"knowledge-base-connection","depth":3,"children":[]},{"title":"Access Permissions","slug":"access-permissions","depth":3,"children":[]}]},{"title":"FAQ","slug":"faq","depth":2,"children":[]},{"title":"Related Pages","slug":"related-pages","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/cloocus/45db6ee3c57396cb/toc.js","/_mintlify/custom/cloocus/9670a2c81dc38d5e/tools/playwright-video-mcp/index.js","/_mintlify/custom/cloocus/4540e1c308555295/lang-toggle.js"],"subdomain":"cloocus","siteName":"Cloosphere Guide","title":"Agents - Cloosphere Guide","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"ko":{"href":"/ko/workspace/agents","matchLevel":1},"en":{"href":"/en/workspace/agents","matchLevel":0}}},"lastModified":"2026-08-24T04:54:39.173Z","originalFileLocation":"en/workspace/agents.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create and manage custom AI assistants combining Knowledge Bases, Tools, and Guardrails\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Agents - Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create and manage custom AI assistants combining Knowledge Bases, Tools, and Guardrails\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cloosphere.ai/en/workspace/agents\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=AI+Agents\u0026amp;title=Agents\u0026amp;description=Create+and+manage+custom+AI+assistants+combining+Knowledge+Bases%2C+Tools%2C+and+Guardrails\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=5b891593ec95c71b29ed82ecff4ee66dd7ea4a04c93ab9765566d867000c808e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Agents - Cloosphere Guide\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create and manage custom AI assistants combining Knowledge Bases, Tools, and Guardrails\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=AI+Agents\u0026amp;title=Agents\u0026amp;description=Create+and+manage+custom+AI+assistants+combining+Knowledge+Bases%2C+Tools%2C+and+Guardrails\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=5b891593ec95c71b29ed82ecff4ee66dd7ea4a04c93ab9765566d867000c808e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5f22d0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cloosphere.ai/en/workspace/agents\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/workspace/agents.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.cloosphere.ai/en/workspace/agents\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.cloosphere.ai/ko/workspace/agents\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.cloosphere.ai/ko/workspace/agents\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cloosphere.ai/#organization\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cloosphere.ai#website\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cloosphere.ai/en/workspace/agents#webpage\",\"url\":\"https://docs.cloosphere.ai/en/workspace/agents\",\"name\":\"Agents\",\"description\":\"Create and manage custom AI assistants combining Knowledge Bases, Tools, and Guardrails\",\"dateModified\":\"2026-08-24T04:54:39.173Z\",\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cloosphere.ai/en/workspace/agents#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cloosphere.ai/en/workspace/agents#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cloosphere Guide\",\"item\":\"https://docs.cloosphere.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agents\",\"item\":\"https://docs.cloosphere.ai/en/workspace/agents\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cloosphere.ai/en/workspace/agents#article\",\"headline\":\"Agents\",\"name\":\"Agents\",\"description\":\"Create and manage custom AI assistants combining Knowledge Bases, Tools, and Guardrails\",\"url\":\"https://docs.cloosphere.ai/en/workspace/agents\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cloosphere.ai/en/workspace/agents#webpage\"},\"dateModified\":\"2026-08-24T04:54:39.173Z\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cloosphere Guide\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cloosphere Guide\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/en/workspace/agents.md","siteName":"Cloosphere Guide","nav":{"global":null,"languages":[{"language":"ko","default":true,"pages":[{"title":"ko","href":"/ko/workspace/agents"}]},{"language":"en","tabs":[{"tab":"Getting Started","icon":"rocket","pages":[{"title":"Getting Started","href":"/en"}]},{"tab":"Chat","icon":"comments","pages":[{"title":"Chat","href":"/en/chat/overview"}]},{"tab":"Workspace","icon":"briefcase","groups":[{"group":"Workspace","pages":[{"title":"Workspace","description":"Configure your AI work environment — agents, knowledge bases, databases, and more","href":"/en/workspace/overview"}]},{"group":"AI Agents","pages":[{"title":"Agents","href":"/en/workspace/agents"},{"title":"Agent Flow","description":"A flow builder for visually composing and running multi-agent workflows","href":"/en/workspace/flows"},{"title":"Flow Node Reference","href":"/en/workspace/flows-nodes"}]},{"group":"Knowledge \u0026 Data","pages":[{"title":"Knowledge Base","href":"/en/workspace/knowledge"},{"title":"Dynamic Filters Deep-Dive","href":"/en/workspace/knowledge-filters"},{"title":"Knowledge Graph","href":"/en/workspace/knowledge-graph"},{"title":"Database","href":"/en/workspace/database"},{"title":"Glossary","href":"/en/workspace/glossary"}]},{"group":"Safety","pages":[{"title":"Guardrails","href":"/en/workspace/guardrails"}]},{"group":"Customization","pages":[{"title":"Prompts","href":"/en/workspace/prompts"},{"title":"Skills","href":"/en/workspace/skills"},{"title":"Tools","href":"/en/workspace/tools"},{"title":"Marketplace","href":"/en/workspace/marketplace"},{"title":"Tags","href":"/en/workspace/tags"}]}]},{"tab":"Collaboration","icon":"users","pages":[{"title":"Collaboration","href":"/en/collaboration/overview"}]},{"tab":"Automation","icon":"clock","pages":[{"title":"Automation","href":"/en/automation/overview"}]},{"tab":"Admin","icon":"gear","pages":[{"title":"Admin","href":"/en/admin/overview"}]},{"tab":"Monitoring","icon":"chart-line","pages":[{"title":"Monitoring","href":"/en/monitoring/overview"}]},{"tab":"Resources","icon":"screwdriver-wrench","pages":[{"title":"Resources","href":"/en/admin/deployment-checklist"}]}]}]},"basePath":"","title":"Agents - Cloosphere Guide","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["07c022d89b","a74be98ba7","a9bb46feb3"],"chunks":["Frame-D0FT0qQs.js","DynamicMarkdown-CQM9Bhbv.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}