Tools for Agents

面向 Agent 的工具

AI Agent 的决策层 — 规划工作流、执行 100 多种工具，并委派多步骤任务。
这不是一个简单的 API 目录，而是一个专为自主 Agent 打造的编排平台。

简介 · 适用对象 · 工作原理 · 快速开始 · 示例 · 集成 · 文档

---

这是什么？

Tools for Agents 是一个托管 API 平台，为 AI Agent 提供现实世界的能力：读取网站、搜索网络、提取 PDF 内容、执行 OCR、构建 RAG 管道、核实事实，以及执行预构建的工具链——所有操作都通过机器可读的 REST、MCP 和 A2A 接口完成。

Agent 不必再猜测该调用 100 个端点中的哪一个，而是可以先使用 Agent Advisor：描述目标，获取工作流计划、费用估算和置信度评分，然后使用可复制粘贴的示例调用工具，避免验证错误。

你可以获得	无需再
POST /v1/advisor → 计划 + 替代方案	手动从 100 个端点中挑选
GET /v1/tools/{tool}/examples → 精确的 JSON 请求体	反复试错，遇到 422 错误
POST /v1/chains/run → 多步骤管道	自己串联 5 个工具
POST /a2a/v1/skills/.../invoke → 委派给远程 Agent	每一步都调用底层 REST 接口
pip install agenttools-client → 可自我修复的 SDK	使用原始 httpx + 自定义重试逻辑

在线服务：toolsforagents.tools · API：api.toolsforagents.tools

---

适用对象？

用户群体	使用场景
自主 AI Agent	自行注册、使用 Advisor 制定计划、调用工具——无需人工介入
Agent 构建者（LangChain、CrewAI、自定义编排器）	REST + Python SDK + 工具链
IDE Agent（Cursor、Claude Desktop、Windsurf）	通过 /mcp 使用远程 MCP — 配置
多 Agent 系统	A2A Agent Card + 13 种技能 — 委派研究、摄取和任务
用于原型开发的开发者	免费套餐：每天 5,000 次请求，即时获取 API 密钥，Swagger UI

**Agent 必须遵守的规则：**绝不要向人类索要 API 密钥。
以编程方式注册：请求体为 {} 的 POST /v1/register。

---

工作原理

  ┌──────────────┐     1. Plan          ┌─────────────────────┐
  │ Your agent   │ ──────────────────► │  Agent Advisor      │
  │ (any stack)  │     POST /advisor   │  workflow · cost    │
  └──────┬───────┘                     └──────────┬──────────┘
         │                                        │
         │  2. Register (once)                    │ 3. Execute
         │  POST /register {}                     ▼
         │                             ┌─────────────────────┐
         └────────────────────────────►│  Tools for Agents   │
              REST · MCP · A2A · SDK   │  extract · pdf · rag │
                                       │  chains · missions   │
                                       └──────────┬──────────┘
                                                  │
                    ┌─────────────────────────────┼─────────────────────────────┐
                    ▼                             ▼                             ▼
              Web & documents              Trust & cognitive              Orchestration
              extract, ingest, pdf        verify, confidence, bias       chains, workflows

典型的 Agent 循环：

1. GET /v1/onboarding — 阅读操作手册
2. POST /v1/advisor — 行动前先规划（0 单位）
3. POST /v1/dry-run — 探测 URL 成本/JS（约 450 毫秒，0 单位）
4. POST /v1/register {} — 获取 API 密钥（无需邮箱）
5. GET /v1/tools/{tool}/examples — 复制精确的请求体
6. 调用工具，或使用 POST /v1/chains/run，或调用 A2A 技能

---

快速开始

选项 A — Python SDK（推荐）

pip install agenttools-client

import asyncio
from agenttools_client import AsyncAgentToolsClient

async def main():
    async with AsyncAgentToolsClient() as client:
        # Auto-registers if no API key
        plan = await client.advisor("Extract markdown from a blog post URL")
        page = await client.extract("https://example.com", format="markdown")
        chain = await client.a2a.run_chain("article_read", {"url": "https://example.com"})

asyncio.run(main())

PyPI：pypi.org/project/agenttools-client · 演示：examples/sdk_demo.py

选项 B — curl（任何语言）

# Plan (no auth)
curl -X POST https://api.toolsforagents.tools/v1/advisor \
  -H "Content-Type: application/json" \
  -d '{"goal":"Extract markdown from example.com"}'

# Register (no email)
curl -X POST https://api.toolsforagents.tools/v1/register \
  -H "Content-Type: application/json" -d '{}'
# → save api_key from response

# Extract
curl -X POST https://api.toolsforagents.tools/v1/extract \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","format":"markdown"}'

选项 C — MCP（Cursor / Claude Desktop）

{
  "mcpServers": {
    "tools-for-agents": {
      "type": "streamable-http",
      "url": "https://api.toolsforagents.tools/mcp",
      "headers": { "Authorization": "Bearer sk_live_YOUR_KEY" }
    }
  }
}

可直接复制粘贴的配置：mcp-configs/ · 指南：docs/MCP_QUICKSTART.md

选项 C — 克隆此仓库

git clone https://github.com/max124vip-dev/tools-for-agents.git
cd tools-for-agents
pip install -e ./agenttools_client
python examples/sdk_demo.py
python examples/advisor_flow.py "Research AI agent API best practices"

---

示例

研究一个主题（一次调用）

curl -X POST https://api.toolsforagents.tools/v1/agent/research \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"query":"solid-state battery news 2025","max_results":5}'

运行工具链（PDF → 摘要）

curl -X POST https://api.toolsforagents.tools/v1/chains/run \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"chain_id":"pdf_summary","inputs":{"url":"https://example.com/report.pdf"}}'

A2A — 委派给远程 Agent 技能

curl -X POST https://api.toolsforagents.tools/a2a/v1/skills/youtube-summary/invoke \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.youtube.com/watch?v=..."}}'

在 422 错误时自动修复（SDK）

# Wrong body → SDK fetches /v1/tools/{tool}/examples and retries once
await client.json("POST", "/v1/confidence/estimate", json={})

更多内容：examples/ · 400 多个 API 示例：GET /v1/tools/examples/index

---

你将获得

层级	描述
Agent Advisor	目标 → 工作流、置信度、成本、备选方案（0 单位）
100+ REST 工具	Web、PDF、OCR、搜索、RAG、信任、加密、验证……
28 个工具链	pdf_summary、youtube_summary、article_read、research_with_confidence……
13 项 A2A 技能	将摄取、研究、任务、工具链委派给远程 Agent
98 个 MCP 工具	Cursor、Claude Desktop、Smithery — 目录
Python SDK	自动身份验证 · 422 修复 · 5xx 重试 · PyPI
Commons memory	Agent 共享经验 — POST /v1/commons/recall（公开读取）
CRP Discovery	质量能力发现 — POST /v1/crp/resolve（免费）→ 执行 → 反馈
x402 payments	使用 USDC 按次付费 — 无需账户（文档）

免费套餐： 每天 5,000 次请求 · 每分钟 120 次 · 每月 500 个 GPU 单位 · 即时注册

实时延迟（p50）： dry-run 约 450 ms · 注册约 700 ms · advisor 约 600 ms

---

集成

协议	入口点	适用场景
REST + OpenAPI	api.toolsforagents.tools/docs	任何 HTTP 客户端
Python SDK	pip install agenttools-client	Python Agent 和脚本
MCP	api.toolsforagents.tools/mcp	IDE Agent
A2A	/.well-known/agent-card.json	多 Agent 编排器
llms.txt	toolsforagents.tools/llms.txt	大模型爬虫

---

文档

文档	描述
完整 API 指南	Agent 必读 — 避免 422 错误，涵盖工具链和 SDK
CRP 规范 v0	质量能力发现 — 解析、反馈、来源信息
CRP 路线图	实施阶段 0–7
能力分类法	31 个稳定的能力 ID
Agent Passport 规范	外部 Agent 身份
MCP 快速入门	Cursor、Claude、Windsurf 配置
A2A 远程 Agent	13 项技能 + 调用示例
快速入门	面向用户的概览
x402 钱包付款	无需注册，按次付费
架构	系统高级设计
注册表（Smithery）	发布 MCP 目录

机器可读的发现信息：

资源	URL
Agent 操作手册	GET https://api.toolsforagents.tools/v1/onboarding
工具索引	GET https://api.toolsforagents.tools/.well-known/tool-index.json
示例索引	GET https://api.toolsforagents.tools/v1/tools/examples/index
Agent Card（A2A）	GET https://api.toolsforagents.tools/.well-known/agent-card.json
CRP 解析	POST https://api.toolsforagents.tools/v1/crp/resolve
CRP 能力	GET https://api.toolsforagents.tools/v1/crp/capabilities

---

仓库内容

这是一个公开集成仓库，包含文档、SDK、示例和 Agent 清单。

包含内容	托管在我们的服务器上（不在仓库中）
agenttools_client/ — Python SDK	完整的 API 服务端源代码
examples/ — 可运行的脚本	管理与计费内部实现
agent/ — llms.txt 和 agent.txt	生产基础设施
docs/ · mcp-configs/	专有工具实现

你需要与在线 API 集成——此仓库不是可自托管的克隆版本。

---

支持

• 网站： toolsforagents.tools
• Telegram： @MaxVip124 — 支持与合作
• 定价： toolsforagents.tools/pricing

---

许可证

文档和示例：请参阅 LICENSE。
托管的 API（位于 api.toolsforagents.tools）是一项商业服务。

---

为能采取行动的 Agent 而构建——而非向人类索取 API 密钥的 Agent。

网站 · 入门指南 · PyPI · llms.txt · Smithery