5分钟跑通 Unreal Agentunreal-agent-runner 智能体 CLI 快速上手教程【免费下载链接】unreal-agentAsync-first agent harness项目地址: https://gitcode.com/gh_mirrors/un/unreal-agentUnreal Agent 是 Unreal Labs 推出的异步优先async-first智能体框架其中的命令行工具unreal-agent-runner让你只需一条命令就能让 AI 智能体读取你本地的项目代码、执行 Bash 命令并输出结果。本教程带你 5 分钟内完成安装、配置与首次运行零门槛跑通自己的第一个 AI 智能体任务。它能为新手做什么unreal-agent-runner是一个开箱即用的智能体 CLI一句话驱动输入一段提示词prompt智能体即可自动阅读项目文件、调用工具、完成任务内置工具自带 Bash 执行、图片查看ViewImage和 skill 调用能力由 工具注册表 统一挂载JSONL 事件流运行过程中所有事件以 JSONL 格式写入标准输出方便脚本化集成与回溯多模型提供商通过环境变量即可切换 OpenAI、Ollama 等无需改代码见 providers.go。环境准备与一键安装方式一Go 一行命令安装推荐要求 Go 1.27一条命令完成go install github.com/unreallabsai/unreal-agent/cmd/unreal-agent-runnerlatest方式二从源码直接运行克隆仓库后在项目根目录执行无需安装git clone https://gitcode.com/gh_mirrors/un/unreal-agent cd unreal-agent go run ./cmd/unreal-agent-runner -p Inspect this project and explain how to run its tests.最快配置方法设置 API Key 并跑通首条提示词以默认的 OpenAI 提供商为例只需两步export OPENAI_API_KEY你的密钥 unreal-agent-runner -p 检查这个项目并说明如何运行它的测试。运行结束后智能体在标准输出打印的 JSONL 事件流就是完整的任务记录。切换其他模型提供商设置两个环境变量即可无需任何代码改动环境变量可选值说明UNREAL_HARNESS_LLM_PROVIDERopenai默认、openai-codex、openrouter、fireworks、ollama选择模型提供商UNREAL_HARNESS_LLM_MODEL任意模型 ID指定模型缺省使用提供商默认模型本地体验可配合 OllamaUNREAL_HARNESS_LLM_PROVIDERollama即可接入本地模型零 API 费用。指定工作区并保存运行结果-workspace参数决定智能体读取哪个目录、Bash 命令在哪个目录下执行定义见 run.go。将输出重定向到文件就得到一份可复查的运行日志unreal-agent-runner -workspace ./my-project -p Summarize this project. run.jsonl进阶用 JSON 请求精细控制除了-p提示词还支持传入完整 JSON 请求参数位置需放在选项之后来源可以是命令行参数或 stdinunreal-agent-runner {prompt:Summarize this project.} unreal-agent-runner request.json常用字段一览完整定义见 usage.goprompt/messages任务描述messages优先级更高session_id创建或恢复一个持久化会话跨次运行保留上下文system_prompt替换默认系统提示词thinking_levellow/medium/high/xhigh/max控制思考深度disallowed_tools禁用指定工具如禁止智能体执行 Bash。Docker 方式免安装开箱即用项目提供了官方镜像构建逻辑见 Dockerfile支持 Linux AMD64/ARM64把当前目录挂载为/workspace即可docker run --rm -i --user $(id -u):$(id -g) \ -e OPENAI_API_KEY -v $PWD:/workspace \ unrea1labs/unreal-agent:latest -p Summarize this project.常见问题速查问题解决方法提示找不到命令检查 Go 1.27 并确认go env GOPATH/bin在 PATH 中认证失败核对OPENAI_API_KEY或对应提供商的密钥环境变量想查看全部参数运行unreal-agent-runner -h会列出所有选项与 JSON 字段说明日志在哪默认写入workspace/logs下的时间戳 JSONL 文件更多细节可参考 runner 使用说明 与 框架整体设计文档。小结1 条命令安装go install .../cmd/unreal-agent-runnerlatest1 个环境变量设置OPENAI_API_KEY1 条提示词-p参数即可驱动智能体分析你的项目。Unreal Agent 的核心价值在于异步优先的会话与操作模型——智能体的每一步工具调用都是可持久化、可恢复的操作设计见 operation 组件。对于想快速落地 AI 智能体能力的新手来说unreal-agent-runner是最短路径的入门之选。【免费下载链接】unreal-agentAsync-first agent harness项目地址: https://gitcode.com/gh_mirrors/un/unreal-agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考