Create and Orchestrate an Agent
Configure the model, prompt, variables, Knowledge Base, and tools, then publish the Agent
The Agent editor separates core orchestration from final presentation: the main area configures the prompt, variables, Knowledge Base, and capabilities; Agent Settings configures the name, model, conversation presentation, and iteration cap.
The current team must have an enabled chat model authorized. Creating requires agent:create; publishing requires agent:publish.
Create an Agent
- Navigate to Apps, select Create App > Agent.
- Fill in the name. The name can be
1-100characters; the description up to500characters. - On the orchestration page, select Agent Settings in the top-right corner, choose the model, and configure the name, icon, opening message, suggested questions, and visibility.
- Set visibility to Private or Team.

Write the Prompt and Variables
- In the Prompt, specify the role, task, constraints, tool usage conditions, and failure handling.
- Type
{to open the variable selector.{query}is the current user message. - In Variables, add user input fields. Variable names can be up to
50characters; you can configure the display name, required, hidden, default value, options, numeric range, or maximum length. - Fill in the variables in the preview on the right and confirm the substitution result.
Link a Knowledge Base
- In the Knowledge Base area, select Add.
- Select a Knowledge Base and a
vector,fulltext, orhybridretrieval mode. - Set Top K (
1-100, default5) and the threshold (0-1, default0.3). - Set the overall RAG mode: Agentic RAG, Naive RAG, or Off.
Add Tools and Capabilities
In the Tools area, select a built-in tool, custom tool, MCP, or Skill. When a tool shows "Configuration needed", go to Capabilities first to complete the credentials. When enabling attachments, user input requests, memory, image generation, or video generation, check the corresponding limits and default model in each case.
Save, Debug, and Publish
- Select Save. Validation errors list the specific fields.
- In Debug & Preview, send questions that cover both normal and failure paths.
- When tools are present, verify tool parameters, failure prompts, and max-iteration termination behavior.
- Select Publish. After publishing, you can open the Public Page, Embed, and Access API.

FAQ
- Empty model list: The team has no authorized chat model, or the model is disabled.
- Tools are not called: Check the model's function-calling capability, whether the tool is enabled, and whether the prompt defines the calling conditions.
- Publish fails: Confirm you have the publish permission, and that the model, variable references, and capability configuration are valid.
- Public page inaccessible: Confirm the Agent is published; private/team visibility is still affected by sign-in and team access control.
How is this guide?