Argentic

Argentic 插件

Argentic 可让你的 Agent 连续运行数小时。此仓库将你的编码 Agent 连接到 Argentic：唤醒能在多次调用之间保留记忆的 Agent、读取它们记住的内容、为它们提供工具，并管理你的 API 密钥、用量和预算。

此仓库仅包含清单、技能、MCP 设置和小型客户端适配器，不包含引擎。

这里只有一个 MCP：https://getargentic.com/mcp。使用你的 Argentic 账号登录（OAuth），然后选择一个组织。使用 MCP 无需 API 密钥。要唤醒 Agent，你还需要自己的模型提供商密钥；每次请求都会通过 X-Model-Key 标头传递该密钥，Argentic 绝不会存储它。

运行演示（2 分钟）

你需要从 https://getargentic.com/platform 获取 Argentic API 密钥，以及一个模型密钥。默认模型是免费的 NVIDIA 模型；可在 https://build.nvidia.com 获取其密钥。需要 Node 22 或更高版本。

export ARGENTIC_API_KEY=aek_...
export MODEL_KEY=nvapi-...
npx @argentic-ai/client demo

fish：

set -x ARGENTIC_API_KEY aek_...
set -x MODEL_KEY nvapi-...
npx @argentic-ai/client demo

一个小型客服 Agent 会退款、给客户发邮件并关闭工单，每隔几秒执行一个操作；引擎会在每一步重新构建提示词。若要查看重启后的效果，请在运行过程中按 Ctrl-C，然后在同一文件夹中再次运行相同的命令。再次运行时，会跳过已完成的操作并执行剩余操作。中途被中断的操作会再次运行；这是安全的，因为每个操作都有一个稳定密钥。演示结束时，会统计写入发件箱的内容（每个操作一行），核对每次唤醒与日志记录，并告知你可在仪表板的何处查看运行记录。打开你中断的运行记录，然后点击“Proof of what ran”下的“Check”。

--fresh 会启动新运行。若不想手忙脚乱，可以使用 --kill-after 1 自动终止运行。源代码位于 adapters/typescript/cli.ts。

Claude Code

claude plugin marketplace add Argentic-AI/argentic-plugins
claude plugin install argentic@argentic

Claude Code 会询问你的模型密钥（可选，仅在唤醒 Agent 时需要），并将其安全存储。然后运行 /mcp 并登录 argentic。

仅使用 MCP，不安装插件：

claude mcp add --transport http --header "X-Model-Key: $MODEL_KEY" argentic https://getargentic.com/mcp

然后运行 /mcp 登录。

claude.ai 和 Claude Projects

依次选择 Customize、Connectors、Add custom connector，URL 填写 https://getargentic.com/mcp。在 Request headers 下添加 x-api-key，并填入你的模型密钥（仅在唤醒 Agent 时需要）。Claude 只会发送 Anthropic 批准过的标头名称，而 X-Model-Key 不在其中，因此请使用 x-api-key：Argentic 会将其识别为模型密钥。Request headers 目前处于 beta 阶段，并非所有账号都已开通；如果看不到此选项，连接器仍可登录并读取内容，你可以从 Claude Code 或 Codex 唤醒 Agent。登录并选择你的组织。你可以随时在 Argentic 设置中断开连接。

添加技能：依次选择 Customize、Plugins，点击 Personal plugins 旁的 +，选择 Add marketplace、From a repository，然后输入 Argentic-AI/argentic-plugins。

Cursor

列表上线后，可在 Cursor marketplace 中搜索 Argentic。在此之前，请手动将 MCP 添加到 ~/.cursor/mcp.json：

{"mcpServers": {"argentic": {"url": "https://getargentic.com/mcp"}}}

启用该服务时，Cursor 会打开登录页面。

Codex

codex plugin marketplace add Argentic-AI/argentic-plugins

这会添加技能。将 MCP 添加到 ~/.codex/config.toml：

[mcp_servers.argentic]
url = "https://getargentic.com/mcp"
env_http_headers = { "X-Model-Key" = "MODEL_KEY" }

在 Codex 启动时导出 MODEL_KEY，然后运行 codex mcp login argentic 登录。

另外：对任意 Agent 进行崩溃测试（5 分钟）

crash-test/ 是一个小型开源工具，会在每次工具调用时终止 Agent、重启它，并报告哪些操作运行了两次。它适用于基于任意框架构建的 Agent，无论是否使用 Argentic，且无需任何密钥。请从快速入门开始。

不使用 MCP

HTTP API 仍可独立使用：POST /v1/agents/{agent}/wake 和其他路由需要在 Authorization: Bearer 中提供 API 密钥（aek_...，通过 create_api_key 工具创建或在仪表板中创建），唤醒 Agent 时还需要提供 X-Model-Key。请参阅文档。

使用你自己的框架

已经为 Vercel AI SDK、Mastra、LangChain / LangGraph、Pydantic AI 或 OpenAI Agents SDK 编写了工具？把循环交给 Argentic，继续使用现有工具。adapters/ 为每种框架提供了一个小型适配器（TypeScript：npm i @argentic-ai/client；Python：argentic-ai 即将发布到 PyPI，在此之前，请按照 adapters/python 中的说明，从此仓库通过 pip install 安装），而 examples/ 则为每种框架提供了一个可运行的退款 Agent 示例，此外还有一个完全不使用框架的示例。在运行中途终止它，之后它会恢复运行，且不会重复已完成的操作。两个客户端还都附带了同一个演示，无需编写任何代码即可试用：npx @argentic-ai/client demo 或 python -m argentic_ai demo。

让你的 Agent 来完成

Set up Argentic for me. Read https://getargentic.com/docs/agents and follow it for the tool I'm using right now. Don't ask me to paste keys into this chat: tell me where each key goes and let me put it there. When it's connected, call get_account and tell me what it returned.

插件内容

• argentic 技能：介绍如何基于 API 构建，避免浪费资金或声称并不存在的功能。
• argentic-setup 技能：完成连接，并以最多几美分的成本发起首次调用。
• argentic-quickstart 技能：将 Argentic 添加到你自己的项目，在 .env 中配置密钥，并运行一次小型测试调用。
• argentic-status 技能：列出你的 Agent 以及哪些运行被中断。只读。
• argentic-fix 技能：找出运行停止的原因，然后恢复运行或请你批准。
• argentic MCP 服务，使用你的 Argentic 账户登录。
  • 账户工具：get_account、list_api_keys、create_api_key、revoke_api_key、get_usage、set_budget。
  • Agent 工具：argentic_wake、argentic_fire_due、argentic_resume、argentic_wakes、argentic_wake_get、argentic_replay、argentic_due、argentic_agents、argentic_approvals、argentic_answer_approval。
  • argentic_answer_approval 需要所有者或管理员权限。其他工具的可用范围取决于你的角色。

采用 MIT 许可证。