> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 新 Agent

> 构建一次 Agent，既可作为独立应用使用，也可嵌入工作流

> 本文档由 AI 自动翻译。如有任何不准确之处，请参考 [英文原版](/en/self-host/use-dify/build/new-agent/overview)。

<Warning>
  **数据安全须知**

  Community Edition 适用于单租户自部署场景。其 Agent 运行环境依赖软隔离机制，不设计为提供按终端用户、会话或运行任务划分的强文件系统隔离。

  若将同一个 CE Agent 暴露给多个需要彼此隔离的独立终端用户，恶意提示词、工具调用或类似攻击仍可能访问预期工作目录之外的数据。对严格安全或合规场景，请使用 Dify Cloud、Enterprise，或采用单独的硬隔离部署架构。
</Warning>

<Tip>
  新 Agent 目前处于 Beta 阶段，部署 Dify [1.16.0-rc1](https://github.com/langgenius/dify/releases) 版本即可试用。它在 Docker Compose 部署中默认启用，运行时也已随部署打包。

  生产环境使用前，将 [`DIFY_AGENT_SERVER_SECRET_KEY`](/zh/self-host/deploy/configuration/environments#dify_agent_server_secret_key) 替换为你自己的随机值。
</Tip>

Agent 是一名 AI 员工：设置一次，之后随时给它派活。它与 [经典 Agent 应用](/zh/self-host/use-dify/build/agent) 是不同类型的 Agent：

* 它在 **自己的沙箱** 中工作：可运行命令、安装程序、读写文件，因此能承担开放式的工作，而不只是调用你配置好的工具。

* 你只需 [构建](/zh/self-host/use-dify/build/new-agent/build) **一次**，就能以 **两种方式** 使用：单独作为聊天应用，或作为工作流中的 [一步](/zh/self-host/use-dify/nodes/agent#新-agent)。

Agent 的创建、配置和管理都在 **Agents** 页面进行。可随时打开任一 Agent 继续打磨，或回看早期版本。

## 能力与任务

Agent 把「它是什么」和「你要它做什么」分开：

* **能力（可视为 Agent 的灵魂）决定了 Agent 是谁。**

  包括你编写的角色和提示词、它运行的模型，以及你提供的知识、Skill、Dify 工具和文件。塑造一次后，可随着你逐渐摸清 Agent 需要什么而不断打磨。

* **任务是你在一次运行中要它做的事。**

  Agent 独立工作时，任务是你发给它的消息；在工作流中时，任务是你给节点的指令。

这和招聘是一回事：先按能力选人，再交给对方具体任务。好结果两者缺一不可：人要选对，任务也要交代清楚。

## Agent 的两种用法

### 独立使用

Agent 作为独立的聊天应用运行。你通过聊天给它派任务，还可将它发布为 Web 应用，或通过服务 API 调用。

当一名能干的员工足以独立达成目标时，选这种方式：比如查资料后作答的客服助手，或收集来源并总结要点的调研 Agent。

### 在工作流中使用

将 Agent 请进 [Agent 节点](/zh/self-host/use-dify/nodes/agent#新-agent)，负责整个流程中的一步。在节点上只需设置要完成的任务。这就像请同事帮忙办一件事：你说明任务，对方带着自己的本事来完成。

当工作需要流程结构时，选这种方式：多个步骤按固定顺序执行、按条件分支、用到其他类型的节点，或几个专精不同方向的 Agent 相互接力。