GeniSpace 智能体概述

GeniSpace 智能体是平台的核心，由先进的大型语言模型(LLM)驱动，具有长期记忆能力、思维链推理和多模态处理特性，能够以前所未有的方式协助和自动化您的工作。

创建流程概览

在控制台创建智能体时，基本流程如下：

控制台 → 智能体 → 创建智能体
输入提示词：系统提示词定义智能体角色与行为；提示词模板可定义输入输出格式
输入模式与输出模式：任务型智能体需配置 JSON Schema 格式的输入输出
启用记忆：配置记忆参数，支持多轮对话上下文
测试与调试：在配置页面的测试区域或聊天应用中验证智能体行为

对话型智能体可在聊天应用中打开进行多轮对话测试。

智能体类型

GeniSpace 提供两种不同类型的智能体，满足不同的使用场景：

对话型智能体 (CHAT)

持续对话：支持多轮对话，维持上下文并提供个性化回复
记忆能力：自动记住对话历史，理解长期上下文
个性化体验：可配置欢迎消息和对话风格
适用场景：客户服务、咨询问答、创意协作

任务型智能体 (TASK)

结构化输入输出：支持JSON Schema验证，确保数据一致性
严格模式：提供输入输出验证和严格的响应格式
高效执行：专注于特定任务的执行和结果输出
适用场景：数据处理、API集成、自动化流程

核心特性

高级思维链推理

GeniSpace 智能体配备了先进的思维链能力，让您清晰了解AI的推理过程：

可视化推理：实时展示智能体的思考步骤和决策过程
多轮迭代：支持复杂任务的分步骤执行；迭代上限默认为 15 次，可在 5 到 50 次之间配置
智能任务规划：自动分解复杂任务为多个可执行步骤
透明决策：每个决策节点都有详细的推理解释

备注

网络搜索、知识库和 MCP 工具均需启用思维链。思维链关闭时，这些能力标签页会被隐藏，智能体也不会运行工具。

多模态处理能力

智能体支持多种内容类型的输入和处理：

文本处理：自然语言理解和生成
图像识别：支持图片上传和视觉内容分析
音频处理：音频文件的理解和处理
混合内容：同时处理文本、图像、音频的复合任务

智能记忆系统

启用记忆后，智能体采用始终生效的三层架构——各层协同工作，而非需要二选一的模式：

会话记忆：当前会话的对话上下文和任务状态
用户记忆：个人信息和偏好，在同一用户的所有会话间共享
通用记忆：在同一智能体的所有用户间共享的专业知识（限于当前空间）

存储层级由重要性和类型自动决定；检索时按 相似度 × 层级权重 × (1 + 重要性) 对结果排序。您可以配置每层的检索数量与权重，以及每层的存储阈值。

完整配置详情请参见智能体记忆系统。

MCP工具生态系统

智能体集成了强大的工具调用能力：

内置工具

HTML内容渲染：直接在对话中展示富文本内容
图表生成工具：创建各种数据可视化图表
表格展示工具：格式化展示结构化数据
更多内置工具：持续扩展的工具库

平台工具

算子工具：访问平台提供的各种算子和用户自定义算子
- 支持全部算子或指定特定算子
- 可查看算子详情、方法和描述
- 自动识别自定义算子和系统算子
任务工具：将平台中的任务作为工具调用
- 支持全部任务或指定特定任务
- 可访问SCHEDULED、EVENT、MANUAL等不同类型的任务
- 智能体可以创建和执行任务
数据源工具：将平台数据源作为工具使用
- 支持全部数据源或指定特定数据源
- 可访问READ、CREATE、UPDATE、DELETE等不同操作类型的数据源
- 智能体可以直接查询和操作数据源
灵活配置：每种工具类型都支持"不使用"、"全部"、"指定"三种选择策略

外部MCP服务器

第三方集成：连接外部MCP协议兼容的服务
自定义工具：集成您自己开发的工具和服务
API密钥管理：安全的第三方服务认证

网络搜索能力

当思维链功能启用时，智能体可以进行实时网络搜索：

实时信息获取：搜索最新的网络信息和数据
搜索控制：可配置最大搜索次数（1-10次）和每次搜索结果数（1-20条）
智能搜索：根据对话上下文自动构建搜索查询

知识库集成

智能体可以连接您的私有知识库：

文档检索：从上传的文档中查找相关信息
智能匹配：基于语义相似度匹配最相关的内容
多知识库支持：可同时连接多个知识库

在智能体配置中关联知识库即可启用 RAG 检索增强。详见知识库概述。

访问控制

每个智能体都有一个访问范围，用于控制空间内哪些成员可以在启动器和聊天中使用它：

所有空间成员（SPACE）：当前空间内的所有人都可以使用该智能体。
指定成员（RESTRICTED）：只有被加入到允许成员列表中的成员才能使用该智能体。

无论允许成员列表如何设置，智能体所有者始终保留访问权限。没有智能体管理权限的成员只能看到对其可用的智能体（自己的智能体、空间范围的智能体，以及被明确授权的智能体）。

平台助手

每个空间都内置了一个平台助手，成员开箱即可使用。空间管理员可以对其进行自定义，包括：

模型和系统提示词
记忆（与下文相同的三层记忆配置）
网络搜索、知识库和 MCP 工具

平台助手拥有自己的访问范围（所有空间成员或指定成员）和允许成员列表，配置方式与普通智能体相同。

智能体的应用场景

智能对话助手

客户服务：24/7自动回复客户询问，理解复杂需求
咨询顾问：基于专业知识提供咨询和建议
学习伙伴：协助学习和研究，回答专业问题
创意协作：参与头脑风暴，提供创意想法

任务自动化

数据处理：结构化数据的提取、转换和分析
文档生成：根据模板和数据自动生成报告
API集成：作为中间层处理复杂的API调用
工作流协调：串联多个工具和服务完成复杂任务

内容创作

多媒体内容分析：处理文本、图片、音频的混合内容
智能编辑：内容改写、格式化和优化
翻译服务：多语言内容的理解和转换
创意生成：基于输入素材生成创意内容

智能体的工作原理

思维链执行流程

输入理解：智能体首先分析用户输入的多模态内容
任务规划：将复杂任务分解为可执行的步骤
工具选择：根据任务需求智能选择合适的工具
迭代执行：逐步执行任务，实时调整策略
结果整合：汇总各步骤结果，生成最终回复

记忆管理机制

自动存储：根据重要性和类型，将新信息存入会话层、用户层或通用层
分层检索：在每一轮对话开始时并行搜索全部三层并合并结果
加权排序：按 相似度 × 层级权重 × (1 + 重要性) 对结果排序，并受每层数量限制约束

流式响应处理

实时输出：边思考边输出，用户可实时看到进展
思维可视化：显示智能体的推理步骤和工具调用
中断与恢复：支持用户中断和重试机制
错误处理：智能重试和错误恢复

如何配置智能体

GeniSpace 平台提供了灵活的智能体配置选项：

基础设置

智能体类型选择：选择对话型或任务型智能体
基本信息配置：设置名称、描述和标签
模型选择：从多种AI模型中选择最适合的模型
模型参数调优：配置温度、最大令牌数等参数

高级功能配置

思维链设置

启用思维链：开启高级推理和工具调用能力。网络搜索、知识库和 MCP 工具均依赖此项。
最大迭代次数：设置复杂推理的迭代上限。默认为 15 次，可在 5 到 50 次之间配置。

记忆配置

配置三层记忆系统：每层的检索数量与权重，以及每层的存储阈值。完整详情请参见智能体记忆系统。

工具配置（需启用思维链）

内置工具：启用渲染与实用工具，如 HTML 渲染、图表生成、表格展示
平台工具：配置算子、任务和数据源的访问策略
- 算子选择：不使用/全部算子/指定算子
- 任务选择：不使用/全部任务/指定任务
- 数据源选择：不使用/全部数据源/指定数据源
外部MCP服务器：集成第三方工具和服务

完整的工具配置参考请参见 MCP 工具调用系统。

网络搜索（需启用思维链）

搜索控制：设置最大搜索次数（1-10次）
结果数量：配置每次搜索返回的结果数（1-20条）

知识库集成

知识库选择：连接相关的知识库
文档筛选：选择特定的文档集合

任务型智能体专属配置

输入模式：定义JSON Schema格式的输入结构
输出模式：指定期望的输出格式和结构
验证设置：启用输入输出验证和严格模式

智能体安全与隐私

GeniSpace 高度重视数据安全和隐私保护：

数据加密：所有智能体处理的数据都经过端到端加密
访问控制：基于角色的权限管理，确保数据访问安全
记忆范围：分层的记忆范围（会话、用户和通用）使数据得到适当区分
工具安全：MCP工具调用的安全验证和监控
审计日志：完整记录智能体的操作和决策过程
合规性：符合GDPR、CCPA等主要隐私法规要求

API 集成

GeniSpace 提供了灵活的智能体 API，支持多种集成方式：

多模态聊天 API

支持文本、图片、音频等多种内容类型的聊天接口：

const response = await fetch(`/developer/api-agents/${agentId}/chat`, {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    contents: [
      {
        type: "text",
        text: "请分析这张图片"
      },
      {
        type: "image_url",
        image_url: {
          url: "data:image/jpeg;base64,/9j/4AAQSkZ...",
          detail: "auto"
        }
      }
    ],
    session_id: "session_12345",
    stream: true,
    settings: {
      temperature: 0.7,
      max_tokens: 2000
    }
  })
});

任务执行 API

适用于任务型智能体的结构化输入输出：

const response = await fetch(`/developer/api-agents/${agentId}/execute`, {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    // 根据智能体的输入模式提供结构化数据
    user_input: "处理这些销售数据",
    data_source: "sales_report_q3.csv",
    output_format: "summary_report",
    
    // 可选的会话和配置
    session_id: "task_session_789",
    enable_memory: true,
    enable_thinking_chain: true
  })
});

流式响应处理

GeniSpace 智能体支持实时流式响应，您可以实时接收思维过程和结果：

// 使用 Server-Sent Events 处理流式响应
const eventSource = new EventSource(`/developer/api-agents/${agentId}/chat/stream`);

eventSource.onmessage = function(event) {
  const data = JSON.parse(event.data);
  const meta = data.metadata || {};
  
  switch(data.type) {
    case 'session.started':
      // 会话开始
      break;
      
    case 'content.started':
      // 内容生成开始
      break;
      
    case 'content.delta':
      // 增量内容更新
      appendToMessage(data.content);
      break;
      
    case 'thinking.started':
    case 'thinking.update':
      // 思维链步骤
      displayThinkingStep(data.content || meta.step);
      break;
      
    case 'tool.call':
      // 平台工具调用（服务端执行）
      updateToolStatus(meta.tool_name || meta.toolName, meta);
      break;
      
    case 'local.tool.call':
      // 本地工具调用（客户端执行，结果 POST 到 /tool-result）
      executeLocalTool(meta.call_id, meta.tool, meta.params, meta.session_id);
      break;
      
    case 'stream.ended':
      // 流结束
      eventSource.close();
      break;
      
    case 'error':
    case 'error.occurred':
      handleError(data.content || meta.error);
      break;
  }
};

会话管理 API

管理智能体的对话会话：

// 创建新会话
const session = await fetch(`/developer/api-agents/${agentId}/sessions`, {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    title: "数据分析会话",
    sessionType: "chat"
  })
});

// 获取会话历史
const history = await fetch(`/developer/api-agents/sessions/${sessionId}/messages`, {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
});

// 清除会话记忆
await fetch(`/developer/api-agents/${agentId}/memory/session/${sessionId}`, {
  method: "DELETE",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    isolation_level: "session" // session、user 或 agent
  })
});

API 特性说明

多模态支持：同时处理文本、图片、音频等多种内容
流式响应：实时接收AI的思维过程和输出
会话持久化：自动保存对话历史和上下文
记忆管理：支持多级记忆隔离和清除
思维链可视化：提供详细的推理步骤信息
工具调用跟踪：监控智能体使用的工具和状态

详细的 API 文档请参考智能体 API。

开始使用智能体

开始使用GeniSpace智能体非常简单：

第一步：创建智能体

访问智能体管理页面：在控制台中导航到"智能体"部分
选择智能体类型：根据需求选择对话型或任务型智能体
基础配置：
- 设置智能体名称和描述
- 选择合适的AI模型
- 添加功能标签

第二步：高级配置

启用思维链：开启高级推理和工具调用能力（工具、网络搜索和知识库均需此项）
配置记忆系统：调整三层检索数量、权重和存储阈值
集成工具：
- 启用内置工具（图表、表格、HTML渲染）
- 配置平台工具：
  - 选择算子（全部或指定）
  - 选择任务（全部或指定）
  - 选择数据源（全部或指定）
- 配置外部MCP服务器
知识库连接：上传文档或连接现有知识库
网络搜索设置：配置搜索参数（可选）

第三步：测试和部署

功能测试：在配置页面直接测试智能体功能
对话测试：通过聊天界面验证智能体响应
API集成：获取API密钥并集成到您的应用中
监控和优化：观察使用情况并调整配置

快速开始模板

我们提供了多种预配置的智能体模板：

客服助手：配置了客户服务相关的知识库和工具
数据分析师：集成了数据处理和可视化工具
内容创作者：优化了文本生成和编辑能力
技术顾问：连接了技术文档和问题解决工具

获得帮助

文档中心：查看详细的配置指南和最佳实践
API文档：参考完整的智能体 API文档
社区支持：在用户论坛中获得帮助和经验分享
技术支持：联系我们的技术团队获得专业支持

准备好探索更多？查看我们的工作流引擎、工具系统和API接口，了解如何充分利用GeniSpace的完整功能。

下一步

探索更多智能体功能：

了解MCP工具调用系统的详细配置和使用方法
学习智能体记忆系统的记忆管理机制
掌握开发资源如何自定义工具输出渲染
探索API集成将智能体集成到您的应用中

创建流程概览​

智能体类型​

对话型智能体 (CHAT)​

任务型智能体 (TASK)​

核心特性​

高级思维链推理​

多模态处理能力​

智能记忆系统​

MCP工具生态系统​

内置工具​

平台工具​

外部MCP服务器​

网络搜索能力​

知识库集成​

访问控制​

平台助手​

智能体的应用场景​

智能对话助手​

任务自动化​

内容创作​

智能体的工作原理​

思维链执行流程​

记忆管理机制​

流式响应处理​

如何配置智能体​

基础设置​

高级功能配置​

思维链设置​

记忆配置​

工具配置（需启用思维链）​

网络搜索（需启用思维链）​

知识库集成​

任务型智能体专属配置​

智能体安全与隐私​

API 集成​

多模态聊天 API​

任务执行 API​

流式响应处理​

会话管理 API​

API 特性说明​

开始使用智能体​

第一步：创建智能体​

第二步：高级配置​

第三步：测试和部署​

快速开始模板​

获得帮助​

下一步​

创建流程概览

智能体类型

对话型智能体 (CHAT)

任务型智能体 (TASK)

核心特性

高级思维链推理

多模态处理能力

智能记忆系统

MCP工具生态系统

内置工具

平台工具

外部MCP服务器

网络搜索能力

知识库集成

访问控制

平台助手

智能体的应用场景

智能对话助手

任务自动化

内容创作

智能体的工作原理

思维链执行流程

记忆管理机制

流式响应处理

如何配置智能体

基础设置

高级功能配置

思维链设置

记忆配置

工具配置（需启用思维链）

网络搜索（需启用思维链）

知识库集成

任务型智能体专属配置

智能体安全与隐私

API 集成

多模态聊天 API

任务执行 API

流式响应处理

会话管理 API

API 特性说明

开始使用智能体

第一步：创建智能体

第二步：高级配置

第三步：测试和部署

快速开始模板

获得帮助

下一步