智能体开发指南
学习如何创建、配置和部署AI智能体，构建强大的自动化工作流
什么是智能体？
智能体是基于大语言模型的自动化实体，能够理解用户意图、调用工具、执行任务并给出回复。 灵锐魔方平台提供完整的智能体开发能力，支持多模型调度、工具调用和工作流编排。
多模型支持
支持阿里、百度、讯飞、智谱等主流大模型
工具调用
自定义工具集成，扩展智能体能力
工作流编排
可视化编排多步骤自动化流程
快速开始
1. 安装 SDK
npm install @lingrui-mofang/sdk
2. 创建智能体
import { LingruiMofang } from '@lingrui-mofang/sdk';
const client = new LingruiMofang({
apiKey: process.env.LINGRUI_MOFANG_API_KEY
});
// 创建智能体
const agent = await client.agents.create({
name: '客服智能体',
model: 'qwen-turbo',
description: '用于客户服务的智能助手',
tools: ['search', 'database', 'calculator'],
systemPrompt: '你是一个专业的客户服务助手，负责回答用户的问题。',
temperature: 0.7
});
console.log('智能体创建成功:', agent.id);3. 调用智能体
// 调用智能体
const response = await client.agents.chat({
agentId: agent.id,
message: '如何查询我的订单状态？',
context: {
userId: 'user123',
sessionId: 'session456'
}
});
console.log('智能体回复:', response.content);工具定义与注册
通过定义自定义工具，扩展智能体的能力范围。工具可以是数据库查询、API调用、计算器等。
定义自定义工具
// 定义自定义工具
const customTool = {
id: 'order_status',
name: '订单状态查询',
description: '查询用户订单的当前状态',
parameters: [
{
name: 'orderId',
type: 'string',
required: true,
description: '订单ID'
}
],
handler: async (params) => {
// 实际查询逻辑
return {
status: 'shipped',
trackingNumber: 'SF1234567890',
estimatedDelivery: '2024-01-15'
};
}
};
// 注册工具到智能体
await client.agents.addTool(agent.id, customTool);工作流编排
将多个智能体和工具组合成工作流，实现复杂的自动化任务。
创建工作流
// 创建工作流
const workflow = await client.workflows.create({
name: '订单处理流程',
description: '自动处理订单的工作流',
steps: [
{
id: 'step1',
type: 'agent',
agentId: agent.id,
prompt: '分析用户查询意图',
nextStep: {
condition: 'intent === "order_status"',
stepId: 'step2'
}
},
{
id: 'step2',
type: 'tool',
toolId: 'order_status',
parameters: { orderId: '{{context.orderId}}' },
nextStep: 'step3'
},
{
id: 'step3',
type: 'agent',
agentId: agent.id,
prompt: '总结订单状态并回复用户'
}
]
});最佳实践
系统提示词设计
清晰定义智能体的角色和行为边界，使用明确的指令引导智能体行为。
安全考虑
对工具调用进行权限验证，避免敏感操作被滥用。
监控与日志
记录智能体的调用日志和性能指标，便于问题排查和优化。
错误处理
实现优雅的错误处理机制，确保工作流在出现问题时能够正确回退。