You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This FAQ addresses common questions and issues you might encounter while installing and using Nexent. For the basic installation steps, please refer to the [Installation & Development](./installation). For basic using instructions, please refer to the [User Guide](../user-guide/).
3
+
This FAQ addresses common questions and issues you might encounter while installing and using Nexent. For the basic installation steps, please refer to the [Installation & Development](./installation). For basic using instructions, please refer to the [User Guide](../user-guide/home-page).
4
4
5
5
## 🚫 Common Errors & Operations
6
6
7
7
### 🌐 Network Connection Issues
8
+
8
9
-**Q: How can a Docker container access models deployed on the host machine (e.g., Ollama)?**
9
10
- A: Since `localhost` inside the container refers to the container itself, use one of these methods to connect to host services:
10
11
11
-
**Option 1: Use Docker's special DNS name `host.docker.internal`**
12
-
Supported environments: Mac/Windows and newer Docker Desktop versions (Linux version also supported)
12
+
**Option 1: Use Docker's special DNS name `host.docker.internal`**
13
+
14
+
Supported environments: Mac/Windows and newer Docker Desktop versions (Linux version also supported)
15
+
13
16
```bash
14
17
http://host.docker.internal:11434/v1
15
18
```
16
19
17
20
**Option 2: Use host machine's actual IP (ensure firewall allows access)**
21
+
18
22
```bash
19
23
http://[HOST_IP]:11434/v1
20
24
```
21
25
22
-
**Option 3: Modify Docker Compose configuration**
26
+
**Option 3: Modify Docker Compose configuration**
27
+
23
28
Add to your docker-compose.yaml file:
29
+
24
30
```yaml
25
31
extra_hosts:
26
32
- "host.docker.internal:host-gateway"
27
33
```
28
34
29
35
### 🔌 Port Conflicts
36
+
30
37
- **Q: Port 3000 is already in use. How can I change it?**
31
38
- A: You can modify the port in the Docker Compose configuration file.
32
39
33
40
### 📦 Container Issues
41
+
34
42
- **Q: How do I check container logs?**
35
43
- A: Use `docker logs <container_name>` to view logs for specific containers.
36
44
@@ -44,11 +52,23 @@ This FAQ addresses common questions and issues you might encounter while install
44
52
2. **Valid API key**: Verify your API key has proper permissions
45
53
3. **Model name**: Confirm the model identifier is correct
46
54
4. **Network access**: Ensure your deployment can reach the provider's servers
47
-
48
-
For model setup instruction, see [Model Configuration](../user-guide/model-configuration) in User Guide.
55
+
56
+
For model setup instruction, see [Model Management](../user-guide/model-management) in User Guide.
57
+
58
+
- **Q: Multi-turn chats fail when using the official DeepSeek API. How can I resolve this?**
59
+
- A: The official DeepSeek API only accepts text payloads, but Nexent sends multimodal payloads, so multi-turn calls are rejected. Use a provider such as SiliconFlow that exposes DeepSeek models with multimodal compatibility. Our requests look like:
Copy file name to clipboardExpand all lines: doc/docs/en/user-guide/agent-development.md
+20-15Lines changed: 20 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
-
# Agent Configuration
1
+
# Agent Development
2
2
3
-
In the Agent Configuration module, you can create, configure, and manage agents. Agents are the core feature of Nexent—they can understand your needs and perform corresponding tasks.
3
+
In the Agent Development page, you can create, configure, and manage agents. Agents are the core feature of Nexent—they can understand your needs and perform corresponding tasks.
4
4
5
5
## 🛠️ Agent Management
6
6
@@ -9,6 +9,7 @@ In the Agent Configuration module, you can create, configure, and manage agents.
9
9
On the Agent Management tab, click "Create Agent" to create a new blank agent. Click "Exit Create" to leave creation mode.
10
10
11
11
If you have an existing agent configuration, you can also import it:
12
+
12
13
1. Click "Import Agent"
13
14
2. In the popup, select the agent configuration file (JSON format)
14
15
3. Click "Open"; the system will validate the file format and content, and display the imported agent information
@@ -49,6 +50,8 @@ Agents can use various tools to complete tasks, such as knowledge base search, e
Many third-party services such as ModelScope provide MCP services, which you can quickly integrate and use.
67
+
Many third-party services such as [ModelScope](https://www.modelscope.cn/mcp) provide MCP services, which you can quickly integrate and use.
65
68
66
69
### Custom Tools
67
70
@@ -70,15 +73,15 @@ You can refer to the following guides to develop your own tools and integrate th
70
73
-[MCP Tool Development](../backend/tools/mcp)
71
74
-[SDK Tool Documentation](../sdk/core/tools)
72
75
73
-
## 📝 Describe Business Logic
76
+
## 📝 Describe the Agent’s Logic
74
77
75
-
### Describe How should this Agent Work
78
+
### Describe How the Agent Should Work
76
79
77
-
Based on the selected collaborative agents and tools, you can now use concise language to describe how you want this agent to work. Nexent will automatically generate the agent’s name, description, and prompt suggestions based on your configuration and description.
80
+
Once the collaborators and tools are ready, describe—in plain language—how you expect the agent to behave. Nexent uses this description plus your configuration to auto-generate the agent name, description, and prompts.
78
81
79
-
1.In the "Describe should this agent work" editor, enter a brief description
80
-
2. Click "Generate"; Nexent will generate detailed agent content for you
81
-
3.You can further edit the generated content for fine-tuning
82
+
1.Enter the description under **Describe how this agent should work**
83
+
2. Click **Generate Agent** and wait for the detailed content
84
+
3.Review the generated role prompt, constraints, examples, and tweak anything you want
@@ -94,14 +97,16 @@ After completing the initial agent configuration, you can debug the agent and op
94
97
95
98
### Manage Agents
96
99
97
-
-**Save:** After successful debugging, click the "Save" button in the lowerright corner to save the agent. The agent will then be available for selection in the chat page.
98
-
-**Export:**Export the successfully debugged agent configuration as a JSON file. When creating an agent, you can use this JSON file to create a copy via import.
99
-
-**Delete:**Delete the agent (use with caution)
100
+
-**Save:** After you finish debugging, click **Save**in the lower-right corner so the agent becomes available in Start Chat.
101
+
-**Export:**Download a JSON file of any agent you like, then re-import it later to create copies.
102
+
-**Delete:**Remove an agent you no longer need (this cannot be undone).
100
103
101
104
## 🚀 Next Steps
102
105
103
-
After completing agent configuration, you can click "Complete Setup" to proceed to:
106
+
After shipping an agent you can:
104
107
105
-
1.**[Chat Interface](./chat-interface)** – Interact with your agent
108
+
1. Manage every build inside **[Agent Space](./agent-space)**.
109
+
2. Start working with your agent on the **[Start Chat](./start-chat)** page.
110
+
3. Configure **[Memory Management](./memory-management)** to give agents persistent memory.
106
111
107
-
If you encounter any issues during agent configuration, please refer to our **[FAQ](../getting-started/faq)** or join our [Discord community](https://discord.gg/tb5H3S3wyv) for support.
112
+
Need help? Check the **[FAQ](../getting-started/faq)** or open a thread in [GitHub Discussions](https://github.com/ModelEngine-Group/nexent/discussions).
Agent Market is an upcoming Nexent module that will provide a curated catalog of ready-to-use agents.
4
+
5
+
## 🎯 Coming Features
6
+
7
+
Agent Market will let you:
8
+
9
+
-**Browse agents** – Explore featured and community-built agents.
10
+
-**Install instantly** – Add high-quality agents to your workspace with one click.
11
+
-**Share your work** – Publish the agents you build.
12
+
-**Rate & give feedback** – Help the community discover great agents.
13
+
14
+
## ⏳ Stay Tuned
15
+
16
+
Agent Market is currently under development. We’re building an ecosystem where you can:
17
+
18
+
- Quickly access verified agents.
19
+
- Share your creations with the community.
20
+
- Discover new use cases and inspiration.
21
+
22
+
## 📢 Follow Updates
23
+
24
+
Want to know when Agent Market launches?
25
+
26
+
- Join the [Discord community](https://discord.gg/tb5H3S3wyv) for announcements.
27
+
- Track project updates in the repository.
28
+
29
+
## 🚀 Related Features
30
+
31
+
While Agent Market is being built, you can:
32
+
33
+
1. Manage your agents in **[Agent Space](./agent-space)**.
34
+
2. Create new agents in **[Agent Development](./agent-development)**.
35
+
3. Test agents in **[Start Chat](./start-chat)**.
36
+
37
+
Need help? Check the **[FAQ](../getting-started/faq)** or open a thread in [GitHub Discussions](https://github.com/ModelEngine-Group/nexent/discussions).
Agent Space is the central dashboard for every agent you have built. View agents in card form, inspect their configurations, delete or export them, and jump straight into chats.
4
+
5
+
## 📦 Agent Cards
6
+
7
+
Each agent appears as a card showing:
8
+
9
+
-**Icon** – The agent’s avatar.
10
+
-**Name** – The display name.
11
+
-**Description** – A quick summary of what it does.
12
+
-**Status** – Whether the agent is available.
13
+
-**Actions** – Shortcuts for editing, exporting, deleting, and more.
14
+
15
+
## 🔧 Manage Agents
16
+
17
+
### View Agent Details
18
+
19
+
Click a card to open its details:
20
+
21
+
-**Basic info:** ID, name, description, and status.
22
+
-**Model configuration:** Model name, max tokens, business logic model, etc.
23
+
-**Prompts:** Role, constraints, examples, and the original description.
24
+
-**Tools:** Every tool the agent can use.
25
+
-**Sub-agents:** Any collaborative agents that are configured.
26
+
27
+
### Edit an Agent
28
+
29
+
1. Click **Edit** on the card.
30
+
2. You’ll be taken to the Agent Development page.
31
+
3. Adjust the settings and save—updates sync back to Agent Space automatically.
32
+
33
+
### Delete an Agent
34
+
35
+
1. Click **Delete** on the card.
36
+
2. Confirm the deletion (this cannot be undone).
37
+
38
+
> ⚠️ **Note:** Deleting an agent permanently removes it. Export a backup first if you might need it later.
39
+
40
+
### Export an Agent
41
+
42
+
1. Click **Export** on the card.
43
+
2. Nexent downloads a JSON configuration file you can import later.
44
+
45
+
### View Relationships
46
+
47
+
1. Click **View Relationships** to see how the agent interacts with tools and other agents.
48
+
49
+
### Jump to Chat
50
+
51
+
1. Click **Chat** to open Start Chat with the agent already selected.
52
+
53
+
## 🚀 Next Steps
54
+
55
+
Once you finish reviewing agents you can:
56
+
57
+
1. Talk to them in **[Start Chat](./start-chat)**.
58
+
2. Continue iterating in **[Agent Development](./agent-development)**.
59
+
3. Enhance retention with **[Memory Management](./memory-management)**.
60
+
61
+
Need help? Check the **[FAQ](../getting-started/faq)** or open a thread in [GitHub Discussions](https://github.com/ModelEngine-Group/nexent/discussions).
0 commit comments