Neonous Skill
You can operate the Neonous AI agent platform on behalf of the user. Neonous lets users create, configure, and deploy AI agents through a web interface — with tools, MCP servers, workflows, templates, and more.
When to Use API vs Web Interface
Prefer suggesting the web interface for complex or visual tasks:
- - Creating/editing agents with detailed instructions → Web UI has a rich editor, AI-assisted instruction enhancement, and template gallery
- Building workflows → Web UI has a visual canvas editor (drag & drop)
- Browsing MCP catalog → Web UI has a searchable catalog with one-click install
- Managing MCP server environment variables → Web UI handles secrets securely
- Browsing community templates → Web UI has categories, previews, and one-click clone
Use the API for quick operations:
- - Listing agents, tools, workflows (quick status checks)
- Chatting with an agent
- Executing a workflow
- Checking token balance
- Simple agent creation with known parameters
- Scripting and automation
The web interface is at $NEONOUS_URL — guide the user there for anything visual or complex.
Authentication
All API requests require the user's API key:
CODEBLOCK0
Base URL: $NEONOUS_URL (e.g., https://app.neonous-ai.com).
How to Get an API Key
Users generate API keys from the Settings page in Neonous. The key starts with nn_ and is only shown once. If not set up yet:
- 1. Log in to Neonous at INLINECODE4
- Go to Settings > API Keys
- Click Create API Key, give it a name
- Copy the key (won't be shown again) and set it as INLINECODE5
Agents
List Agents
CODEBLOCK1
Get Agent Details
CODEBLOCK2
Returns full config including instructions, predefined_tools, custom_tools, mcp_servers.
List Available Models
Always fetch models before creating an agent — do not hardcode model IDs:
CODEBLOCK3
Use the model marked is_default: true unless the user requests a specific one.
List Available Tools
CODEBLOCK4
Returns pre-defined tools that can be assigned to agents via predefined_tools.
Create an Agent
For complex agents, recommend the web UI — it has AI-assisted generation and a template gallery. For simple agents via API:
CODEBLOCK5
AI-Generate Agent Config
Let Neonous AI generate a full agent config from a name and description:
CODEBLOCK6
Returns a complete agent config (name, instructions, model, tools) ready to use with the create endpoint.
AI-Enhance Instructions
Improve existing agent instructions with AI:
CODEBLOCK7
Update an Agent
CODEBLOCK8
Only include fields you want to change.
Delete an Agent
CODEBLOCK9
Chat
Chat with an Agent
Non-streaming generate endpoint — returns a complete JSON response:
CODEBLOCK10
Response:
CODEBLOCK11
For multi-turn conversations, include the full message history:
CODEBLOCK12
List Chat Sessions
CODEBLOCK13
Filter by agent: append ?agentId=<AGENT_ID>.
Get Chat Session (with Messages)
CODEBLOCK14
Create a Chat Session
CODEBLOCK15
Delete a Chat Session
CODEBLOCK16
MCP Servers
For adding MCP servers, recommend the web UI — it has a searchable catalog with one-click install and secure environment variable management.
List MCP Servers
CODEBLOCK17
Get MCP Server Details
CODEBLOCK18
List Tools from an MCP Server
CODEBLOCK19
Add an MCP Server (stdio)
CODEBLOCK20
Add an MCP Server (http)
CODEBLOCK21
Delete an MCP Server
CODEBLOCK22
Add ?force=true to delete even if agents are using it.
Test MCP Server Connection
CODEBLOCK23
Workflows
For building workflows, always recommend the web UI — it has a visual drag-and-drop canvas editor that's far easier than raw JSON.
List Workflows
CODEBLOCK24
Get Workflow Details
CODEBLOCK25
Execute a Workflow
CODEBLOCK26
List Workflow Runs
CODEBLOCK27
Get Workflow Run Details
CODEBLOCK28
Get Workflow Run Logs
CODEBLOCK29
Templates & Community
List Agent Templates
CODEBLOCK30
Filter by category: append ?category=<CATEGORY>.
Get Template Details
CODEBLOCK31
Browse Community Templates
CODEBLOCK32
For browsing and cloning templates, recommend the web UI — it has previews, categories, and one-click clone.
Browse Community MCP Servers
CODEBLOCK33
Artifacts & Spaces
Agents generate artifacts during chat — code files, documents, charts, diagrams, and more. These are automatically saved and versioned. Users organize artifacts into spaces (project-based collections). For full artifact management, recommend the web UI — it has a file-manager interface with drag-and-drop, folders, and visual previews.
Browse Artifacts
CODEBLOCK34
Artifact Versions
CODEBLOCK35
Folders
CODEBLOCK36
Sharing
CODEBLOCK37
Other Artifact Operations
CODEBLOCK38
Spaces
Spaces group artifacts by project or topic. An artifact can belong to multiple spaces.
CODEBLOCK39
Bookmarks
Save important messages from chat sessions.
CODEBLOCK40
Skills
Agent skills extend what agents can do.
CODEBLOCK41
Reminders & Notifications
Agents can set reminders that trigger notifications or AI-generated follow-ups.
CODEBLOCK42
Telegram
Connect agents to Telegram bots. For setup, recommend the web UI — it handles bot token configuration.
CODEBLOCK43
Working Memory
Agents remember context across conversations via working memory.
CODEBLOCK44
Wishlist
Users can submit and vote on feature wishes.
CODEBLOCK45
Account & Tokens
Get Token Balance
CODEBLOCK46
Token Usage History
CODEBLOCK47
Monthly Usage Summary
CODEBLOCK48
Billing, Plans & Subscriptions
Subscribing, upgrading plans, and purchasing tokens all go through Stripe checkout in the browser. Always direct users to the web UI at $NEONOUS_URL/settings (or the billing/pricing page) to subscribe or buy tokens — these cannot be completed via API alone.
You can check the user's current plan and billing status via API:
CODEBLOCK49
If the user wants to subscribe, upgrade, or buy tokens, tell them to visit the Settings > Billing page in the web UI.
Health Check
CODEBLOCK50
No authentication required.
Guidelines
- - Always list agents first before chatting, so you know valid agent IDs.
- Fetch models before creating — never hardcode model IDs; use
available-models endpoint. - Recommend the web UI for complex tasks: building workflows (canvas editor), browsing templates/MCP catalog, editing agent instructions (AI-enhanced editor), and managing secrets/env vars.
- Use the API for quick tasks: listing resources, chatting, executing workflows, checking balance.
- For multi-turn chat, keep the full message history and pass it in each request.
- Check token balance if you get a 402 error — the user is out of tokens.
- Show the agent's response text directly to the user; omit usage details unless asked.
- Format lists as clean tables or bullet points for readability.
Neonous 技能
你可以代表用户操作 Neonous AI 智能体平台。Neonous 允许用户通过网页界面创建、配置和部署 AI 智能体——包含工具、MCP 服务器、工作流、模板等。
何时使用 API 与网页界面
对于复杂或可视化任务，建议使用网页界面：
- - 创建/编辑带有详细指令的智能体 → 网页界面 拥有丰富的编辑器、AI 辅助指令增强和模板库
- 构建工作流 → 网页界面 拥有可视化画布编辑器（拖放式）
- 浏览 MCP 目录 → 网页界面 拥有可搜索的目录，支持一键安装
- 管理 MCP 服务器环境变量 → 网页界面 安全处理密钥
- 浏览社区模板 → 网页界面 拥有分类、预览和一键克隆功能
对于快速操作，使用 API：
- - 列出智能体、工具、工作流（快速状态检查）
- 与智能体聊天
- 执行工作流
- 检查代币余额
- 使用已知参数创建简单智能体
- 脚本编写和自动化
网页界面位于 $NEONOUS_URL —— 对于任何可视化或复杂的操作，引导用户前往该地址。
身份验证
所有 API 请求都需要用户的 API 密钥：
-H x-api-key: $NEONOUSAPIKEY
基础 URL：$NEONOUS_URL（例如 https://app.neonous-ai.com）。
如何获取 API 密钥
用户从 Neonous 的 设置 页面生成 API 密钥。密钥以 nn_ 开头，且仅显示一次。如果尚未设置：
- 1. 登录 $NEONOUSURL 的 Neonous
- 前往 设置 > API 密钥
- 点击 创建 API 密钥，为其命名
- 复制密钥（不会再次显示）并将其设置为 NEONOUSAPI_KEY
智能体
列出智能体
bash
curl -s $NEONOUS_URL/custom/builder/agents \
-H x-api-key: $NEONOUSAPIKEY | jq .[]| {id, name, model, enabled}
获取智能体详情
bash
curl -s $NEONOUSURL/custom/builder/agents/ID> \
-H x-api-key: $NEONOUSAPIKEY | jq .
返回完整配置，包括 instructions、predefinedtools、customtools、mcp_servers。
列出可用模型
创建智能体前务必获取模型列表——不要硬编码模型 ID：
bash
curl -s $NEONOUS_URL/custom/builder/agents/available-models \
-H x-api-key: $NEONOUSAPIKEY | jq .models[]| {id, provider, displayname, isdefault}
除非用户指定特定模型，否则使用标记为 is_default: true 的模型。
列出可用工具
bash
curl -s $NEONOUS_URL/custom/builder/agents/available-tools \
-H x-api-key: $NEONOUSAPIKEY | jq .tools[]| {id, name, description}
返回可通过 predefined_tools 分配给智能体的预定义工具。
创建智能体
对于复杂智能体，推荐使用网页界面——它提供 AI 辅助生成和模板库。对于通过 API 创建简单智能体：
bash
curl -s -X POST $NEONOUS_URL/custom/builder/agents \
-H x-api-key: $NEONOUSAPIKEY \
-H Content-Type: application/json \
-d {
name: 我的智能体,
description: 一个有用的助手,
instructions: 你是一个有用的助手，负责...,
model: <来自 available-models 的 MODEL_ID>,
enabled: true,
predefined_tools: [],
custom_tools: [],
mcp_servers: []
} | jq .
AI 生成智能体配置
让 Neonous AI 根据名称和描述生成完整的智能体配置：
bash
curl -s -X POST $NEONOUS_URL/custom/builder/agents/generate \
-H x-api-key: $NEONOUSAPIKEY \
-H Content-Type: application/json \
-d {
name: 代码审查员,
description: 审查拉取请求并提出改进建议
} | jq .
返回完整的智能体配置（名称、指令、模型、工具），可直接用于创建端点。
AI 增强指令
使用 AI 改进现有智能体指令：
bash
curl -s -X POST $NEONOUS_URL/custom/builder/enhance-instructions \
-H x-api-key: $NEONOUSAPIKEY \
-H Content-Type: application/json \
-d {instructions: 你帮助处理代码} | jq .enhanced
更新智能体
bash
curl -s -X PUT $NEONOUSURL/custom/builder/agents/ID> \
-H x-api-key: $NEONOUSAPIKEY \
-H Content-Type: application/json \
-d {
name: 更新后的名称,
instructions: 更新后的指令...
} | jq .
仅包含要更改的字段。
删除智能体
bash
curl -s -X DELETE $NEONOUSURL/custom/builder/agents/ID> \
-H x-api-key: $NEONOUSAPIKEY | jq .
聊天
与智能体聊天
非流式生成端点——返回完整的 JSON 响应：
bash
curl -s -X POST $NEONOUS_URL/custom/builder/chat/generate \
-H x-api-key: $NEONOUSAPIKEY \
-H x-agent-id: \
-H Content-Type: application/json \
-d {messages: [{role: user, content: 你好，你能做什么？}]} | jq .
响应：
json
{
response: 你好！我可以帮你...,
usage: { inputTokens: 42, outputTokens: 18, totalTokens: 60 }
}
对于多轮对话，包含完整的消息历史：
bash
curl -s -X POST $NEONOUS_URL/custom/builder/chat/generate \
-H x-api-key: $NEONOUSAPIKEY \
-H x-agent-id: \
-H Content-Type: application/json \
-d {
messages: [
{role: user, content: 2+2 等于多少？},
{role: assistant, content: 4},
{role: user, content: 将其乘以 10}
]
} | jq .
列出聊天会话
bash
curl -s $NEONOUS_URL/custom/builder/chat/sessions \
-H x-api-key: $NEONOUSAPIKEY | jq .sessions[]| {id, title, agentId, created_at}
按智能体筛选：追加 ?agentId=。
获取聊天会话（含消息）
bash
curl -s $NEONOUSURL/custom/builder/chat/sessions/ID> \
-H x-api-key: $NEONOUSAPIKEY | jq .
创建聊天会话
bash
curl -s -X POST $NEONOUS_URL/custom/builder/chat/sessions \
-H x-api-key: $NEONOUSAPIKEY \
-H Content-Type: application/json \
-d {agentId: , title: 我的会话} | jq .
删除聊天会话
bash
curl -s -X DELETE $NEONOUSURL/custom/builder/chat/sessions/ID> \
-H x-api-key: $NEONOUSAPIKEY | jq .
MCP 服务器
对于添加 MCP 服务器，推荐使用 网页界面——它拥有可搜索的目录，支持一键安装和安全的环境变量管理。
列出 MCP 服务器
bash
curl -s $NEONOUS_URL/custom/builder/mcp \
-H x-api-key: $NEONOUSAPIKEY | jq .[]| {id, name, type, enabled}
获取 MCP 服务器详情
bash
curl -s $NEONOUSURL/custom/builder/mcp/ID> \
