TrueAGT允许你把自己的 HTTP 接口 或 Python 脚本 变成 Agent 可以直接调用的工具,无需改代码、重启服务,在「设置 → 自定义工具」里点几下即可完成。
适用于:想让 Agent 接入你私有的内部系统、第三方 API、或一段固定计算逻辑,而不想等官方内置支持的场景。
| 类型 | 适合做什么 | 怎么跑 | 参数怎么传 |
|---|---|---|---|
| HTTP / API | 调用任意外部 REST 接口(汇率、天气、内部工单系统…) | 服务端用 urllib 发请求 | 拼进 URL / 请求体模板的 {参数名} 占位符 |
| Python 脚本 | 一段固定计算、数据转换、调用本地库 | 服务端起子进程跑 python -c(与内置「代码解释器」同一模型) | 从标准输入读 JSON:args = json.loads(sys.stdin.read() or '{}') |
身份判定基于登录账号。未开启鉴权(纯本地/演示)时,所有工具都是「个人」、且只有一位使用者。
假设有一个公开的汇率接口 https://api.exchangerate.host/convert?from=USD&to=CNY&amount=1。
{
"type": "object",
"properties": {
"amount": {"type": "number", "description": "美元金额"}
},
"required": ["amount"]
}
https://api.exchangerate.host/convert?from=USD&to=CNY&amount={amount}{amount} 会被调用时传入的 amount 参数替换。{"result": 7.2},填 result 即可只把 7.2 回给模型;留空则返回整段响应。保存后在对话里说「帮我查 100 美元是多少人民币」,模型就会调用这个工具。
{"type":"object","properties":{"text":{"type":"string","description":"原始文本"}},"required":["text"]}
import sys, json, re
args = json.loads(sys.stdin.read() or "{}")
text = args.get("text", "")
out = "\n".join(line for line in text.splitlines() if line.strip())
print(out)
模型调用时,会把 {"text": "..."} 以 JSON 形式写到脚本的标准输入,脚本 print 的内容就是工具返回给模型的结果。
config.json 的 server.custom_tools_allow_private: true 放开(仅在可信内网环境)。工具定义保存在 <data_dir>/custom_tools.json(默认 data/custom_tools.json),与对话数据同目录、随该目录迁移/备份。