内容
# Node.js GPT Agent (OpenAI Assistant), MCP Platform Template
一个用于GPT代理的TypeScript模板，可以快速入门。通过这个模板，您可以在几次点击内为您的应用程序或项目创建一个代理或副驾驶！
这是一个独立的代理，旨在快速集成到任何JS应用程序或服务器中，优化了最小的令牌成本。
#### 部署
它可以部署在Node.js服务器、浏览器、Electron或任何终端等环境中。要创建您的代理，只需按照仓库示例填写描述和工具，并指定您的OpenAI令牌。
#### 启动
1. 设置OpenAI apiKey；
2. 在项目目录中运行命令 `npm run start`；
3. 直接在终端中输入文本并分配任务给代理！
#### NPM包：
https://www.npmjs.com/package/@apgolubev/gpt-agent
- npm i @apgolubev/gpt-agent
- const agent = new GPTAgent.Assistant(OpenAI, …);
- agent.send();
- agent.init('gpt-4.1-mini');
- agent.sendToGPT('User prompt');
### OpenAI Assistant
最新且最有效的OpenAI API，使用Assistant和gpt-4.1-mini，并在模型中进行令牌缓存。
#### 令牌折扣
该代理提供缓存令牌的折扣定价（比手动历史管理便宜4倍且更快），适用于大量对话或解析大量数据。
> 注意：OpenAI目前将其列为Beta API。
在本项目中使用的OpenAI Assistant的优势：
1. 兼容多种模型；我使用gpt-4.1-mini，每百万个令牌$0.4。
2. OpenAI端缓存，每百万个令牌$0.1，比重复提交便宜4倍。
3. 由于缓存和仅解析用户最新输入，响应加速。
4. 允许编写自定义TS函数，包括对Node.js的支持。
### MCP
您可以使用此模板构建自己的内部MCP平台。
### 代理模板
配置工具（function_call）的代理示例：
- [rest-agent](examples/agents/rest-agent.ts) - 用于与REST API交互；
- [wttr-agent.ts](examples/agents/wttr-agent.ts) - 用于从各个城市获取天气数据的开放API；
- [fs-agent.ts](examples/agents/fs-agent.ts) - 用于本地文件管理和文件系统交互；
- [mermaid-agent](examples/agents/mermaid-agent.ts) - 用于生成和共享图表和图形；
- [telegram-manager](examples/agents/telegram-manager.ts) - 用于从Telegram机器人向聊天和群组发送消息。
### 组合代理
[combine-assistants.ts](src/combine-assistants.ts) 允许组合代理并顺序执行复杂的操作链。
### 支持作者
[](https://patreon.com/user?u=77885474)
- Patreon: https://www.patreon.com/apgolubev
- GitHub: https://github.com/apgolubev
- LinkedIn: https://www.linkedin.com/in/aleksandr-golubev-9928aa25b
- Reddit: https://www.reddit.com/user/apgolubev
- Telegram: @apgolubev
### 示例
#### rest-agent
```
U: Send post with body {name: 'john doe'}
A: The POST request with the body {name: 'john doe'} was sent successfully.
U: Get content
A: HTTP Response
```
#### wttr-agent
```
U: What is the weather like in the capitals of Europe?
A: Here is the current weather in the capitals of Europe:
- London: 6°C
- Paris: 12°C
- Berlin: 4°C
- Rome: 10°C
- Madrid: 6°C
- Vienna: 15°C
- Amsterdam: 5°C
- Brussels: 6°C
- Lisbon: 12°C
- Athens: 22°C
U: Write weather data to files
```
#### telegram-manager
```
U: Send 'Hi!' to chat_id 112414***
A: The message "Hi!" has been sent to chat_id 112414*** using the bot Terminal GPTAgent (@TerminalGPTAgent_bot).
```
#### mermaid-agent
```
U: Create a CJM scheme of interaction user with the bank
A: https://mermaid.live/edit#pako:eNp1kk1T4kAQhv/K1Jxx9eIlB6sgAUVxZQ1q1U48tElDpkxmUvOxisB/tzMEKKg1h1Sm36ff6e70iue6QB7xhYGmZLMkU4yevniyaF7Z2dkVG4h+nqO1bADqnb3gm5UOz/tN87plB4GKxUQvpDrve1eicjIHJ7XqkLhF1qkPPmuWiARs+abBFEfACGS1ZkMxNEYbdk8sLLAjknDLSDxL/GBUkPbKUUUVqPwYuRYzA8rOkRy0wuWReCOmsGQDWVX2KD4WsVYOcsdS3zTauE4dBfW27U37XfA6BO/EUDm6ZH9bgo7q3/neBWjS+s6lqfdYJ0+CfH+otRvOSddb7PcBa0fkDZ5gNwF7EClWSD20/XXKQ1Cm+zKo/Zp+T6dOg/pHdNEfithSj3vq/zWMA5WKuATHPqQrT0aZBn0mHtHq6h+ysbV+l3sbtCeaaMFScm03h/doJ2XBI2c89niNpob2yFdtTsZpzWrMeESfBZj3jGdqQzkNqL9a17s0o/2i5NEcKksn3xTgMJFA235AUBVo4naheHQZHHi04p88uujxJb03Pf4VLC9+XW6+AWjFAA8=
U: Create a super detailed mindmap chart of interaction user with the bank
A: https://mermaid.live/edit#pako:eNp1VE1v2zAM/SuCTi2Qbr304pvrLFiBpMuWbAOGXAiZsYXYkqGPpVnQ/z7Kjmw16y6JSJFPj+Sjz1zoEnnGW6nKFrqdYsxo7W5uvls0d4+gDuxJOTQgnNTq9jYEMLbUlVTDkbEQqaDFaK/B2qM2ZbS3R323oHxtWO5djcpJAQEtBjC2WW0mIwkKKV03XOVCaK8cW4GCCluKiCk/JB7H6zk6kI2d4B6hASVwcmwNKDvUwz5LS4+cxlK6EhyytdF72SQpazRWK2ioF3s9uQutHAG98Q70WAGmTEjk9Nxvgv44R7gck+rRsfXT8+BI2I35c+y0lS55GGydWDWKw1V9ezTR81O6ujRwhCbhs10lHaIEkeB9UY1UI78IxxZepSX1sgg9uX6PsU8v/70K8yBNOd3/p/4LXih8YrqGUzppypZNOtzCYCld3+3JudQQe1d4mm9L5De+67QZgYoa3D8+aJpr3yL/aieZGeepqNxaUg1EVhsU3kg3auhZO7m/KNy+r7q8QeNsSpjW6cq7MODLoESH4u2yrLSSYTM23nZSSO3tIK+EA2PfMJQxoERvXJGljnIh5TmpKvsed3obaXRIuzPeL0FVnuQ9jseQlMUpweEzXhlZ8swZjzNOrW8hmPwccnacVpu+FDyjYwnmsOM79Uo5HahfWrcxzWhf1TzbQ2PJ8v1WziVUBqYQVCWaIhTEs4cegWdn/sKz+xk/0e/rjP/pIe8/PLz+BZh2gIQ=
U: Make a diagram of all the plot arcs and characters of Camus' book "The Plague" for mermaid and publish to mermaid.
A: https://mermaid.live/edit#pako:eNptVEuL2zAQ/iuDTi1kl73sxYXCkrTd9tBs04VCnT1M7LEtIktGD9g0yX/vWLLzNkYaeeb75mltRWFKEpmoLXYNvM4+LTXws5AU3vOZvU/SG9zdfd59lXXj3Q5eFNaBPqTtYwK8orUm5GlL5s+kOgdVDxoxyfabRV3mcU2WU0V2PQGzcuT4BaPPAQtsV2R9PuwJ9Ae1d0CuwI5gFTw4jxsH3kDDjs8JXlCTMpzRKCSKBSlZSxM4SpS+gaJBpUjXVMJqc84w943ReVwT9kcoa5qAC1VF1oEyjlmsaS8cRzkC5sGvLOEaJGc35+TzqfQbMFU8vF3ZTzH0tSgJOTIu1eBK6vrAcNKrCPnJ1UdP3KLf3thNHtfRA5QhgrvoYvCXLHrsd12oUPbYaYMWC89Z5UcxRuAbkhbQFm6An+iZI0VyU5Pm4qYqzsFtutTum7qxkTeVsU1jQY1/skXe7/DURz5kK71EBWZoCtdzkM5g0fZXYHLtpabUBm9DXSvawVFxDXo2XTLnknYo7Q76L7N0uDb/wpbcp9SbiLNUKSq87P+FBTmjQi9fdG3kGGZ0nLBYg8N8nMR/rjiJ6EJzdHhQiAnfEbIUGadPE9GSbbE/im0PWQqejZaWImOxRLteiqXeM6ZD/deYdoTxENSNyCpUjk+hK3lcZxL59jmakC7JTk3QXmSPkUFkW/EusoeJ2PC6n4h/kfLh/nH/HxjYmkI=
```
#### fs-agent.ts
```
U: Create catalogs of the most popular games on Steam from the data you know about the top 10 genres and write them into .md files by genre.
A: Catalogs of the most popular games on Steam by genre have been created and saved into the following .md files:
- Action.md
- Adventure.md
- RPG.md
- Strategy.md
- Simulation.md
- Sports.md
- Indie.md
- Casual.md
- Horror.md
- Multiplayer.md
U: Sparse and summarize data from available files
A: Here's a summarized and sparse overview of the top 10 Steam game genres with examples of their most popular games:
1. Action: Includes intense gameplay titles such as Counter-Strike: Global Offensive, DOOM Eternal, and Hades.
2. Adventure: Story-driven games like The Witcher 3: Wild Hunt, Life is Strange, and Firewatch.
3. RPG (Role-Playing Game): Character progression games including Cyberpunk 2077, Divinity: Original Sin 2, and Dark Souls III.
4. Strategy: Tactics and planning games such as Sid Meier's Civilization VI, Stellaris, and XCOM 2.
5. Simulation: Realistic or creative simulations like The Sims 4, Microsoft Flight Simulator, and Euro Truck Simulator 2.
6. Sports: Sports-themed games including FIFA 21, NBA 2K21, and Rocket League.
7. Indie: Innovative independent games such as Hollow Knight, Celeste, and Stardew Valley.
8. Casual: Easy-to-play fun games like Among Us, Fall Guys, and Candy Crush Saga.
9. Horror: Scary and suspenseful games including Dead by Daylight, Resident Evil 2, and Phasmophobia.
10. Multiplayer: Social competitive games such as Apex Legends, Team Fortress 2, and Dota 2.
```
#### fs-agent.ts + mermaid-agent
```
U: Parse and summarize the data from the available files and create a mindmap chart based on it. Show link and save original scheme in .md file.
A: ...
```
MCP 市场
