BAIZE AI RESOURCE

AI 智能体运行工具

Docker-agent

Docker-agent 是用于配置和运行 AI 智能体的本地工具。用户可以通过配置文件指定模型、指令和工具,让智能体协助处理代码、文档或信息整理任务,减少为不同任务分别搭建运行流程的工作。

Docker-agent

资源介绍

Docker-agent 是一个通过配置文件创建和运行 AI 智能体的工具,适合希望按任务定制 AI 助手的用户,尤其是需要处理开发、文档和信息整理工作的用户。配置文件可以指定智能体使用的模型、指令和工具;运行后,用户可在终端与智能体交互,也可选择跳过交互界面执行。项目提供基础智能体、文件与命令行工具、网页获取及多智能体等配置示例,方便从简单对话逐步扩展到具体任务。多数使用在线模型的示例需要提供对应服务的 API Key;不同示例所需的额外环境并不相同。

核心能力

按任务配置智能体

在配置文件中指定模型和指令,创建面向特定任务的智能体;项目提供可直接运行的基础配置示例。

调用任务工具

可在配置中接入文件系统、命令行、网页获取等内置工具,让智能体执行与文件、命令或网页内容相关的任务。

运行多智能体配置

对于包含多个智能体的配置文件,可在运行时指定其中一个智能体,便于按不同职责选择执行对象。

评估智能体表现

可对保存的评估会话运行评估命令,查看工具调用轨迹和文本匹配等评分,用于比较智能体的任务表现。

交互式补充工具输入

使用支持征询输入的 MCP 工具时,工具可在执行过程中请求用户确认或填写缺失参数,随后继续执行。

使用方法

  1. 下载与操作系统及处理器架构对应的发布文件,准备要使用的智能体配置。

  2. 若配置使用在线模型,设置该模型服务所需的 API Key;部分示例还需要额外工具。

  3. 运行 `docker agent run examples/basic_agent.yaml` 启动基础示例,再根据任务修改配置中的模型、指令和工具。

  4. 需要运行多智能体配置中的指定智能体时,使用 `-a <agent>`;需要跳过终端交互界面时,使用 `--exec`。

使用案例

创建代码任务助手

使用场景开发者希望让 AI 协助处理代码文件。

以智能体配置指定模型、任务指令和文件系统工具,运行后让智能体围绕工作目录中的文件执行任务。

整理网页信息

使用场景用户需要概括某个网页的内容。

运行接入网页获取工具的示例配置,向智能体提供目标网页,让它获取并总结页面内容。

比较智能体的回答

使用场景维护智能体的用户想检查配置调整后的表现。

保存评估会话后运行 `docker agent eval`,查看各会话的工具调用轨迹和文本匹配评分。

包含内容

docker-agent-source.zip
README-中文安装说明.md
LICENSE-Apache-2.0.txt
THIRD-PARTY-NOTICES.md
SHA256.txt

常见问题

运行示例配置是否需要 API Key?
多数使用在线模型的示例需要相应服务的 API Key,例如 OpenAI 示例可通过 `OPENAI_API_KEY` 提供;所需密钥取决于配置选用的模型服务。
如何只运行多智能体配置中的一个智能体?
运行配置文件时添加 `-a <agent>`,即可指定其中的智能体;添加 `--exec` 可跳过终端交互界面。
MCP 工具执行途中可以向用户补充提问吗?
可以。支持征询输入的 MCP 工具可请求确认、缺失参数或其他信息;docker-agent 会显示交互式表单,并将用户提交的内容返回给工具。
终端中能显示哪些 Mermaid 图?
目前可部分渲染流程图、时序图和状态图;不支持或无法解析的 Mermaid 内容会保留为代码块,不会渲染成图。