UiPath Documentation
delegate
latest
false
Delegate 用户指南
  • 概述
    • 简介
    • 关键概念
  • 快速入门
  • 信任与合规
  • 监管
  • 功能
    • 连接工具
    • 使用例程重复工作
    • 指导并运行
    • Share work with the Delegate Store
    • 为 Delegate 安装插件
  • 制图工具
  • Delegate for Testing
  • 参考
  • 故障排除

连接工具

将 Delegate 连接到业务应用程序,使用 Integration Service 连接器实现托管 SaaS 集成,或使用 MCP 服务器实现自定义和本地工具连接。

本指南介绍如何将 Delegate 连接到您的业务应用程序和服务。Delegate 支持两种连接方法:用于托管 SaaS 集成的 Integration Service 连接器,以及用于自定义或本地工具连接的 MCP(模型上下文协议)服务器。

Integration Service 连接

Integration Service 为热门业务应用程序提供经过身份验证的安全连接。当您连接 Integration Service 连接器时,Delegate 可以:

  • 在已连接的应用程序中读取和写入数据
  • 使用您的权限代表您执行操作
  • 在无需您共享密码的情况下访问数据
  • 在后台运行,无需浏览器自动化

可用的集成

Delegate 支持 Integration Service 目录中的所有连接器,而不仅仅是固定子集。一些常见示例:

服务Delegate 可以执行的操作
Microsoft Outlook阅读电子邮件,发送消息,管理日历,创建任务
Gmail阅读电子邮件,发送消息,搜索对话
Google 日历读取活动、创建会议、查看空闲时间
Google 云端硬盘列出、读取和管理文件
Google 文档创建和编辑文档
Slack读取频道、发布消息、管理会话
Microsoft Teams读取频道、发布消息、查看提及情况
Jira阅读问题,创建工单,更新状态,添加注释
Confluence读取页面、搜索内容、创建文档
GitHub读取存储库、问题、拉取请求;创建问题
Salesforce读取和更新记录,创建任务,查看商机

先决条件

  • Integration Service 必须在您的 UiPath 租户中可用。

创建连接

要创建 Integration Service 连接,请执行以下步骤:

  1. 打开“设置”“连接” (或Integration Service )。
  2. 选择“添加连接”“连接”
  3. 选择要连接的服务。
  4. 系统会将您重定向到该服务的 OAuth 授权页面。
  5. 使用该服务的现有帐户登录。
  6. 授予请求的权限。
  7. 您系统将返回到 Delegate,且连接已确认。

结果:连接显示在列表中,状态指示器为绿色。现在,您可以在 Delegate 中按名称引用此服务。

连接筛选器模式

控制 Delegate 可以访问的连接:

Mode描述用于以下情况
个人仅您创建的连接单独工作,测试
全部租户/组织中的所有连接团队环境、共享资源

要更改:设置 → 连接 → 筛选器下拉列表

注意:在“全部”模式下,您可以使用团队成员创建的连接,但只能在已连接的应用程序中查看您有权访问的数据。

测试连接

创建连接后:

  1. 该连接将显示在带有状态指示器的列表中。
  2. 绿色 = 已连接并正在运行。
  3. 黄色 = 已连接,但权限可能有限。
  4. 红色 = 连接失败或已过期。

要测试:让 Delegate 执行一个简单的操作:“列出我在 Outlook 中的未读电子邮件”或“显示我今天的日历”。

撤销连接

要撤销连接并删除Delegate对服务的访问权限,请执行以下步骤:

  1. 打开设置连接
  2. 找到要删除的连接。
  3. 选择断开连接或回收站图标。
  4. 确认断开连接。

结果:该连接将从列表中删除。在您重新连接之前,Delegate 将无法再访问该服务。

注意:这将删除 Delegate 的访问权限,但不会删除您的服务帐户。要完全撤销,请同时在服务自身设置中删除授权(例如,Google 帐户 → 安全 → 第三方应用程序)。

刷新过时的连接

在以下情况下,连接可能过期或失效:

  • 您的密码已更改
  • 该服务已撤销第三方访问权限
  • 您组织已更改的安全策略

症状:Delegate 报告“连接失败”或“身份验证错误”

待修复
  1. 前往“设置”→“连接”。
  2. 查找失败的连接。
  3. 选择“重新连接”“刷新”
  4. 再次完成 OAuth 流程。

MCP(模型上下文协议)服务器

MCP 是一种开放式协议,用于将 AI 助手连接到外部数据源和工具。与 Integration Service 连接器(由 UiPath 管理)不同,MCP 服务器可以:

  • 远程: 您通过 URL 连接的托管服务
  • 本地: 在您的计算机上运行的程序

何时使用 MCP 以及 Integration Service

下表介绍了每种连接方法的使用场景。

用例推荐方法
热门 SaaS(Outlook、Slack、Salesforce)Integration Service
自定义内部 APIMCP 远程服务器
本地数据库或文件MCP 本地服务器
不带 Integration Service 连接器的专有工具MCP(任一类型)
实验性或测试版集成MCP

添加远程 MCP 服务器

远程 MCP 服务器在其他位置托管,可通过 HTTP 访问:

  1. 打开设置MCP 服务器
  2. 选择“添加服务器”
  3. 选择“远程”
  4. 输入服务器详细信息:
    • URL :端点地址(例如https://api.example.com/mcp
    • 标题: 友好名称(例如“公司 API”)
    • 标头(可选):身份验证标头(如果需要)
  5. 选择“保存”
  6. 切换至“已启用”即可激活。
示例配置
{
  "type": "remote",
  "url": "https://internal-api.company.com/mcp",
  "enabled": true,
  "title": "Company Data API",
  "headers": {
    "Authorization": "Bearer YOUR_TOKEN"
  }
}
{
  "type": "remote",
  "url": "https://internal-api.company.com/mcp",
  "enabled": true,
  "title": "Company Data API",
  "headers": {
    "Authorization": "Bearer YOUR_TOKEN"
  }
}

添加本地 MCP 服务器

本地 MCP 服务器在您的计算机上作为进程运行:

  1. 打开设置MCP 服务器
  2. 选择“添加服务器”
  3. 选择“本地”
  4. 输入服务器详细信息:
    • 标题: 友好名称。
    • 命令: 要运行的可执行文件(例如nodepython/path/to/server
    • 参数: 命令行参数
    • 工作目录:运行命令的位置
    • 环境变量:流程的键值对
  5. 选择“保存”
  6. 切换至“已启用”即可激活。
配置示例
示例:文件系统 MCP 服务器
{
  "type": "local",
  "enabled": true,
  "serverId": "filesystem-mcp",
  "title": "Local Filesystem Access",
  "config": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"],
    "env": {},
    "cwd": "/Users/username"
  }
}
{
  "type": "local",
  "enabled": true,
  "serverId": "filesystem-mcp",
  "title": "Local Filesystem Access",
  "config": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"],
    "env": {},
    "cwd": "/Users/username"
  }
}
示例:GitHub MCP 服务器
{
  "type": "local",
  "enabled": true,
  "serverId": "github-mcp",
  "title": "GitHub Integration",
  "config": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
      "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
    },
    "cwd": "/Users/username"
  }
}
{
  "type": "local",
  "enabled": true,
  "serverId": "github-mcp",
  "title": "GitHub Integration",
  "config": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
      "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
    },
    "cwd": "/Users/username"
  }
}

管理 MCP 服务器

在设置 → MCP 服务器中,您可以:

  • 启用/禁用:打开/关闭单个服务器
  • 编辑:修改配置(URL、命令、参数)
  • 删除:删除服务器配置
  • 测试: 验证服务器是否正确响应

注意:更改会立即生效。禁用服务器会阻止 Delegate 使用其工具,但不会停止正在运行的本地进程——您可能需要手动终止该进程。

Delegate 如何发现 MCP 工具

当启用 MCP 服务器时:

  1. Delegate 连接到服务器(远程为 HTTP,本地为 STdio)。
  2. 服务器报告其可用工具和功能。
  3. 工具将显示在“Delegate 的可用功能”中。
  4. 您可以用自然语言引用它们:“使用文件系统工具列出我的 Documents 文件夹”。

无需手动注册—MCP 工具会自动发现。

管理员可以在策略级别监管 MCP 服务器 — 请参阅“使用 Automation Ops 进行监管”中的MCP 服务器

高级:通过“设置”管理连接

超级用户可以直接在 settings.json 中管理 MCP 连接:

{
  "mcpServers": [
    {
      "type": "remote",
      "url": "https://api.example.com/mcp",
      "enabled": true,
      "title": "Example API",
      "headers": {
        "Authorization": "Bearer token123"
      }
    },
    {
      "type": "local",
      "enabled": true,
      "serverId": "my-local-server",
      "title": "Local Tools",
      "config": {
        "command": "python",
        "args": ["/path/to/server.py"],
        "env": {"API_KEY": "secret"},
        "cwd": "/path/to/working/dir"
      }
    }
  ]
}
{
  "mcpServers": [
    {
      "type": "remote",
      "url": "https://api.example.com/mcp",
      "enabled": true,
      "title": "Example API",
      "headers": {
        "Authorization": "Bearer token123"
      }
    },
    {
      "type": "local",
      "enabled": true,
      "serverId": "my-local-server",
      "title": "Local Tools",
      "config": {
        "command": "python",
        "args": ["/path/to/server.py"],
        "env": {"API_KEY": "secret"},
        "cwd": "/path/to/working/dir"
      }
    }
  ]
}

注意:仅在您熟悉 JSON 时才编辑settings.json 。无效语法会阻止加载 Delegate。务必在编辑前进行备份。

有关连接的安全注意事项和数据流信息,请参阅本地安全配置

后续步骤

了解如何:

此页面有帮助吗?

连接

需要帮助? 支持

想要了解详细内容? UiPath Academy

有问题? UiPath 论坛

保持更新