工程开发
nexau-agent avatar

nexau-agent

从零开始构建、配置与部署 NexAU Agent 的完整指南与开发框架,包含工具、提示词与技能实现。

简介

nexau-agent 技能是开发者在 NexAU 框架内构建智能代理的基础资源。它提供了从概念到具备工具调用能力的代理所需的核心流程知识与结构化模板。此技能涵盖了代理开发的完整生命周期,包括基于 YAML 的配置、提示词工程、自定义工具定义以及入口脚本编写。它专为需要集成 LLM、沙盒环境与现有工具生态的软件工程师与 AI 开发者设计。

  • 完整的实现工作流:指导需求分析、目录结构设置以及代理验证协议。

  • 详尽的文档参考:整合了 NexAU 核心概念的指南,包括 Agent、Tool、LLM、Transport、Session 与高级 Hooks。

  • 工具定义模板:为内置与自定义工具提供标准化架构,确保与 NexAU 架构兼容(涵盖文件操作、网页抓取、Shell 执行等)。

  • 配置最佳实践:针对环境变量替换、系统提示词类型(Jinja2/string)与工具调用模式(structured/xml)的专门说明。

  • 验证与测试:提供内置验证脚本、Python 语法检查与代理运行时故障排查技巧。

  • 集成能力:关于如何导入技能、追踪系统(如 Langfuse)以及中间件以提升可观测性与性能的说明。

  • 当您需要启动一个新的独立代理项目或为现有配置添加自定义工具集时,请使用此技能。

  • 请严格遵循定义的仓库结构:确保 agent_name.yamlsystemprompt.mdstart.py 的结构符合 NexAU 加载器要求。

  • 在实现工具时,请先检查是否有现成的内置工具(如 read_file、google_web_search 或 shell_tools)以满足需求,避免重复开发 Python 绑定。

  • 在开发周期早期利用内置的 validate_agent.py 进行检查,以便在部署前发现配置错误。

  • 参考 examples/ 目录中复杂代理架构的实现参考,包括子代理委派与多代理协作团队。

仓库统计

Star 数
70
Fork 数
16
Open Issue 数
2
主要语言
Python
默认分支
main
同步状态
空闲
最近同步时间
2026年5月3日 21:17
在 GitHub 查看