# gfast **Repository Path**: FlyKOO/gfast ## Basic Information - **Project Name**: gfast - **Description**: gfast是基于GF(Go Frame)的后台管理系统 ,完善的权限用户管理,致力于快速高效开发cms系统、督办系统、后续将加入流程审批、工作流引擎、项目管理、数据大屏等功能。 - **Primary Language**: Go - **License**: Apache-2.0 - **Default Branch**: os-v3.2 - **Homepage**: http://www.g-fast.cn/ - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 1007 - **Created**: 2025-03-01 - **Last Updated**: 2026-11-17 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README package main import ( "bytes" "context" "crypto/sha256" "encoding/hex" "fmt" "io" "net/http" "time" "github.com/aws/aws-sdk-go-v2/config" "github.com/aws/aws-sdk-go-v2/aws/signer/v4" ) func main() { ctx := context.Background() region := "us-east-1" cfg, err := config.LoadDefaultConfig( ctx, config.WithRegion(region), ) if err != nil { panic(err) } credentials, err := cfg.Credentials.Retrieve(ctx) if err != nil { panic(err) } model := "us.anthropic.claude-sonnet-4-5-20250929-v1:0" endpoint := fmt.Sprintf( "https://bedrock-runtime.%s.amazonaws.com/model/%s/invoke", region, model, ) body := []byte(`{ "anthropic_version": "bedrock-2023-05-31", "max_tokens": 1024, "messages": [ {"role": "user", "content": "你好"} ] }`) req, err := http.NewRequestWithContext( ctx, http.MethodPost, endpoint, bytes.NewReader(body), ) if err != nil { panic(err) } req.Header.Set("Content-Type", "application/json") hash := sha256.Sum256(body) payloadHash := hex.EncodeToString(hash[:]) signer := v4.NewSigner() err = signer.SignHTTP( ctx, credentials, req, payloadHash, "bedrock", region, time.Now(), ) if err != nil { panic(err) } client := &http.Client{ Timeout: 60 * time.Second, } resp, err := client.Do(req) if err != nil { panic(err) } defer resp.Body.Close() result, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println("HTTP:", resp.StatusCode) fmt.Println(string(result)) } AWS Bedrock Claude API 错误码与异常报文汇总 依据 AWS 官方 API 文档、Amazon Bedrock 故障排查指南、AWS re:Post 和开发者社区案例整理,主要适用于: * InvokeModel / InvokeModelWithResponseStream * Converse / ConverseStream * AWS Bedrock 上的 Anthropic Claude 系列模型 * Go SDK、Python Boto3,以及自行实现 AWS SigV4 请求的客户端 特别注意:AWS Bedrock 的账号封控、模型权限拒绝、请求频繁和模型过载是不同的问题。不能仅凭 HTTP 403 或 429 判定账号被封。 一、错误码总览 以下 HTTP 状态码以 AWS 官方 API Reference 为准。具体错误消息会因模型、Region、接口及账号状态而变化。Amazon Bedrock +3 HTTP AWS 错误类型 常见原因 建议重试 400 ValidationException 请求参数错误、模型限制、账号模型准入异常 否,先排查 400 ServiceQuotaExceededException 超出服务配额 条件性 401/403 认证类错误 凭据错误、签名无效、Token 失效 否 403 AccessDeniedException IAM 权限不足、模型访问受限、Marketplace 拒绝 否 404 ResourceNotFoundException 模型 ID 或资源不存在 否 408 ModelTimeoutException 模型执行超时 是,有限重试 424 ModelErrorException 底层模型处理失败 视原因 424 ModelStreamErrorException 流式生成过程出现异常 条件性 429 ThrottlingException RPM、TPM 或账户服务限额触发 是,退避 429 ModelNotReadyException 模型暂未准备好 是 500 InternalServerException Bedrock 内部错误 是 503 ServiceUnavailableException 服务暂不可用、容量不足 是 529 overloaded_error 模型服务过载 是,退避 其中 529 overloaded_error 已在 AWS 最新故障排查文档中明确列出,它代表模型容量暂时不足,和账户配额导致的 429 ThrottlingException 不同。Amazon Bedrock +1 二、账号封控、风控与模型访问被拒绝 这是判断 Bedrock 上游渠道是否可用时最值得重点识别的一类错误。 1. Error 002:账号被禁止访问 Bedrock 模型 高度疑似账号级限制 社区实际报错: ValidationException: Error 002: Access to Bedrock models is not allowed for this account * HTTP:通常为 400 * 错误类型:ValidationException * 含义:AWS 账号没有获得调用 Bedrock 模型的许可,或者模型访问受到账号级限制。 * 处理:停止自动重试,检查账号状态、账单、Bedrock 权限和模型授权,再联系 AWS Support。 AWS re:Post 有账号原本可以调用 Claude Sonnet、Opus,后来突然在 API 和 Playground 中对所有模型收到 Error 002 的报告。另有新账号在创建模型协议时收到相同错误的案例。AWS re:Post +1 注意:该报错足以表明模型调用被限制,但并不能单独证明整个 AWS 账号处于 SUSPENDED 状态。 2. Operation not allowed:调用操作被限制 社区实际报错: ValidationException: Operation not allowed 或: An error occurred (ValidationException) when calling the InvokeModel operation: Operation not allowed * HTTP:400 * 可能原因:账号安全限制、账号新建未完成相关审核,或操作级授权限制。 * 特征:更换 API Key 后依然失败;在 AWS Playground 直接调用也失败。 2026 年的 AWS re:Post 案例中,账号被标记为 Confirmed Compromised(确认存在安全入侵),随后调用 Claude 持续返回这一错误,而同账号的 Amazon Nova 仍然可用。AWS re:Post 因此,建议把 Operation not allowed 归类为 ACCOUNT_RESTRICTED_SUSPECTED,并且结合其他信号确认,而不是直接标记永久封号。 3. AccessDeniedException:模型权限或账号访问被拒绝 AWS 官方与 re:Post 中的真实报错文本: AccessDeniedException: You don't have access to the model with the specified model ID. HTTP:403 这种错误可能来自: * IAM 没有 bedrock:InvokeModel 权限。 * AWS Organizations SCP 显式拒绝。 * 第三方模型的 Marketplace 订阅失败。 * 当前账号不满足特定模型的额外准入条件。 * Claude 模型的首次使用信息尚未完成提交。 依据:AWS 模型访问指南与 AWS re:Post 跨账号调用故障案例。AWS re:Post +1 特别注意:AWS 现在采用首次调用自动激活大部分商业区域模型的方式,但不代表所有账号都一定被允许调用。某些模型仍然存在额外账号级访问限制。Amazon Bedrock 4. INVALID_PAYMENT_INSTRUMENT:支付方式或 Marketplace 订阅异常 实际出现的报错: AccessDeniedException: Model access is denied due to INVALID_PAYMENT_INSTRUMENT: A valid payment instrument must be provided. HTTP:通常为 403 这并不是 Claude API 余额不足的标准错误,而是 AWS Marketplace 支付方式、订阅协议或结算资格问题。 AWS 官方故障排查文档明确列出了 Marketplace Agreement Failure,包括支付方式无效及地区限制。开发者在 AWS Builder Center 也记录了上述真实报错。AWS Builder Center +1 5. 模型订阅协议尚未生效 AWS 官方列出的情况: 错误标识 HTTP 原因 MPAgreementBeingCreated 403 正在创建 Marketplace 订阅 Marketplace Agreement Pending 403 订阅协议尚未完成 Marketplace Agreement Failed 403 订阅失败 FTUFormNotFilled 404 尚未提交要求的模型首次使用信息 官方建议对仍在创建的订阅先间隔约 15 分钟重试,而明确失败的订阅需要修复其具体原因。Amazon Bedrock 截至当前官方文档,Claude Opus 4.7 及后续适用模型不再需要 Anthropic FTU 表单;更早的 Claude 模型仍可能需要。通过 bedrock-mantle 端点访问 Anthropic 模型也不适用这项 FTU 要求。Amazon Bedrock 6. AWS 整个账号被暂停(SUSPENDED) AWS 官方定义中,SUSPENDED 账号不能调用 AWS 服务 API,只保留账单和账号管理、联系支持等有限入口。AWS Organizations 这里需要和 Bedrock 单独受限区分: 状态 是否可能调用其他 AWS 服务 AWS 账号 SUSPENDED 通常不可以 Bedrock 模型调用受限 可以 Claude 单独被限制 其他 Bedrock 模型可能可以 IAM 权限拒绝 未被拒绝的操作可能正常 AWS 没有在 Bedrock Runtime API 中公开一个可以唯一识别整个 AWS 账号被封停的专用错误码。 必须结合 AWS 账号状态、控制台、支持邮件等信息确认。 三、请求频繁、配额不足与限流 7. ThrottlingException:请求次数过多 AWS 官方知识库记录的真实错误文本: ThrottlingException: Too many requests, please wait before trying again. You have sent too many requests. Wait before trying again. HTTP:429 典型触发条件: * RPM(每分钟请求次数)达到限制。 * TPM(每分钟 Token 使用量)达到限制。 * 高并发突发请求。 * 按需推理共享容量导致限流。 AWS re:Post 曾记录,即使 Claude 用户的实际用量远低于配置配额,仍可能因为共享推理容量而收到 429。AWS re:Post +1 8. Too many tokens:Token 配额限流 真实错误: ThrottlingException: Too many tokens, please wait before trying again. HTTP:429 需要区分 Token 速率限制与上下文窗口超限。该错误属于配额或速率限制,不应直接理解为输入内容长度不合法。AWS re:Post 9. Too many tokens per day:每日 Token 限制 社区实际报错: ThrottlingException: Too many tokens per day, please wait before trying again. HTTP:429 这是一个尤其值得关注的错误。 AWS re:Post 中有新账号即使从未成功调用模型,也持续收到此错误。调查发现一些账号的每日 Token 配额应用值为 0,甚至全部模型都无法调用。AWS re:Post +1 因此: 如果首次调用就是 Too many tokens per day,等待 24 小时未必有效,可能是账号配额初始化或访问资格异常。 建议按以下方式识别: * 429、偶发、有成功请求:优先按普通限流处理。 * 429、连续失败、每日配额为 0:标记 QUOTA_ZERO_SUSPECTED。 * 429、连续多天失败、多个模型一致:升级为 ACCOUNT_QUOTA_RESTRICTED_SUSPECTED,等待 AWS Support 确认。 四、模型异常、超时、过载与服务端错误 10. ServiceUnavailableException:服务暂不可用 AWS 官方记录的报错: ServiceUnavailableException: Bedrock is unable to process your request. HTTP:503 一般表示当前 Region 的服务容量或可用性问题,不代表账号限流或封禁。建议指数退避重试,并在可行时切换区域或跨区域推理配置。AWS re:Post 11. overloaded_error:模型过载 overloaded_error HTTP:529 这是 AWS 官方故障指南确认的模型服务容量错误。若带有 Retry-After 响应头,应至少等待指定时间再重试。Amazon Bedrock 12. ModelTimeoutException:模型超时 ModelTimeoutException: The request took too long to process. Processing time exceeded the model timeout length. HTTP:408 13. ModelErrorException:上游模型执行错误 ModelErrorException: The request failed due to an error while processing the model. HTTP:424 可附带 originalStatusCode、resourceName 等字段。不能简单地将原始模型状态码直接当作 Bedrock HTTP 状态码。Amazon Bedrock 14. ModelNotReadyException:模型尚未准备好 ModelNotReadyException: The model specified in the request is not ready to serve inference requests. HTTP:429 虽然和普通限流一样返回 429,但应单独分类。AWS 文档指出,SDK 可以针对该错误自动重试最多 5 次。Amazon Bedrock 15. 流式响应中途异常 ConverseStream 和 InvokeModelWithResponseStream 可能已经建立成功的流式连接,之后才返回异常事件。 例如,以下是简化后的事件结构示意: { "throttlingException": { "message": "Too many requests" } } 其他异常事件类型包括: modelStreamErrorException modelTimeoutException internalServerException serviceUnavailableException validationException 这些是流式事件,不一定代表最初的 HTTP 响应就是非 200。做 Go 流式客户端时,需要在读取事件过程中持续检测异常。Amazon Bedrock +1 五、请求格式、模型配置及认证错误 以下是 AWS 官方知识库列出的报错类型及真实消息示例。AWS re:Post +2 错误 HTTP 典型报错文本 模型 ID 错误 400 The provided model identifier is invalid. 模型找不到 404 Could not resolve the foundation model from the provided model identifier. 需要推理配置 400 Invocation of model ID … with on-demand throughput isn’t supported. IAM 权限缺失 403 because no identity-based policy allows the bedrock:InvokeModel action IAM 显式拒绝 403 with an explicit deny in an identity-based policy SCP 拒绝 403 with an explicit deny in a service control policy AWS Marketplace 权限缺失 403 not authorized to perform the required AWS Marketplace actions Access Key 无效 403 InvalidClientTokenId SigV4 签名错误 400 IncompleteSignature 签名时间过期 400 RequestExpired 未识别的操作 400 The requested operation is not recognized by the service. Claude 的 max_tokens、thinking、tool_use 等配置如果不符合对应模型的约束,也可能触发 ValidationException。例如,某些较新的 Claude 模型不支持旧版 thinking.type: enabled,需要遵循对应模型的思考模式配置。Amazon Bedrock 另外,内容过滤不一定通过 HTTP 错误返回。Converse 成功响应中的 stopReason 还可能是 guardrail_intervened、content_filtered、malformed_tool_use 或 model_context_window_exceeded,需要和真正的 API 失败分开处理。Amazon Bedrock 六、实际 HTTP JSON 报错格式 Bedrock 的错误一般包含 HTTP 状态码、x-amzn-ErrorType、请求 ID 以及 JSON 错误消息。 下面是基于 AWS 文档错误类型和已记录真实错误文本整理的示意响应,不是未经修改的抓包。 HTTP/1.1 429 Too Many Requests x-amzn-ErrorType: ThrottlingException Content-Type: application/json { "message": "Too many tokens per day, please wait before trying again." } HTTP/1.1 400 Bad Request x-amzn-ErrorType: ValidationException Content-Type: application/json { "message": "Error 002: Access to Bedrock models is not allowed for this account" } HTTP/1.1 403 Forbidden x-amzn-ErrorType: AccessDeniedException Content-Type: application/json { "message": "You don't have access to the model with the specified model ID." } 不同 AWS SDK 会将这些响应包装成不同的异常格式。若需要做统一 API 网关,建议保留原始 HTTP 状态、AWS 错误类型、message 和 Request ID。 七、Go API 聚合平台建议的错误分类 以下是建议的内部分类,不是 AWS 官方定义的新错误码。 内部类型 识别条件 路由策略 ACCOUNT_RESTRICTED Error 002、明确账号不允许访问 停用 Bedrock 渠道并人工复核 ACCOUNT_SECURITY_RESTRICTED Operation not allowed 暂停渠道并检查账号 MODEL_ACCESS_DENIED 模型访问权限拒绝 禁用对应账号的该模型 MARKETPLACE_ERROR Marketplace 协议或支付错误 暂停相关模型 AUTH_ERROR 签名、Key、Token 错误 检查凭据,不自动重试 RATE_LIMITED 429 请求/Token 限流 延迟重试、临时切换渠道 DAILY_QUOTA_EXCEEDED Too many tokens per day 检查每日配额,避免无效重试 MODEL_OVERLOADED 529 退避重试或切换区域 SERVICE_UNAVAILABLE 503 重试并临时切换渠道 MODEL_TIMEOUT 408 有限重试,注意重复调用风险 MODEL_ERROR 424 记录原始异常并判断是否重试 INVALID_REQUEST 普通参数校验失败 返回客户端,不切换渠道 对于 Go AWS SDK v2,可以使用 errors.As 提取 smithy.APIError,而不是直接通过 strings.Contains(err.Error()) 解析整个 SDK 错误字符串。 package bedrockerrors import ( "errors" "strings" awshttp "github.com/aws/aws-sdk-go-v2/aws/transport/http" "github.com/aws/smithy-go" ) type ErrorInfo struct { Code string Message string RequestID string Status int Category string Retryable bool } func Classify(err error) ErrorInfo { r := ErrorInfo{Category: "UNKNOWN"} if err == nil { return r } var apiErr smithy.APIError if errors.As(err, &apiErr) { r.Code = apiErr.ErrorCode() r.Message = apiErr.ErrorMessage() } var respErr *awshttp.ResponseError if errors.As(err, &respErr) { r.Status = respErr.HTTPStatusCode() r.RequestID = respErr.ServiceRequestID() } msg := strings.ToLower(r.Message) switch { case strings.Contains(msg, "error 002"): r.Category = "ACCOUNT_RESTRICTED" case strings.Contains(msg, "operation not allowed"): r.Category = "ACCOUNT_SECURITY_RESTRICTED" case strings.Contains(msg, "invalid_payment_instrument"), strings.Contains(msg, "marketplace agreement"): r.Category = "MARKETPLACE_ERROR" case strings.Contains(msg, "too many tokens per day"): r.Category = "DAILY_QUOTA_EXCEEDED" case r.Code == "ThrottlingException": r.Category = "RATE_LIMITED" r.Retryable = true case r.Code == "ModelNotReadyException": r.Category = "MODEL_NOT_READY" r.Retryable = true case r.Code == "AccessDeniedException": r.Category = "MODEL_ACCESS_DENIED" case r.Code == "ValidationException": r.Category = "INVALID_REQUEST" case r.Code == "ServiceUnavailableException", r.Code == "InternalServerException", r.Code == "ModelTimeoutException", r.Status == 529: r.Category = "TRANSIENT_ERROR" r.Retryable = true case r.Code == "ModelErrorException", r.Code == "ModelStreamErrorException": r.Category = "MODEL_ERROR" case r.Code == "ServiceQuotaExceededException": r.Category = "QUOTA_EXCEEDED" case r.Code == "InvalidClientTokenId", r.Code == "IncompleteSignature": r.Category = "AUTH_ERROR" } return r } Go SDK 官方错误处理接口参考:AWS SDK for Go v2 – Handling Errors⁠。上述函数是基础分类示例,生产环境还应补充 HTTP 529 原始响应、网络超时、Streaming 错误事件、配额状态与持续失败次数的判定。 对于已经输出部分 Token 的流式请求,不能简单地自动切换到另一个渠道继续输出,否则可能造成重复内容或工具调用重复执行。 八、官方文档及社区案例 以下资料可以直接作为实现和测试的依据。 来源 内容 InvokeModel API Reference 官方异常类型和 HTTP 状态码 Bedrock API 故障排查 403、429、503、529 等问题 AWS 官方知识库:InvokeModel 错误 账号安全限制、权限、请求异常的真实报错 Bedrock 模型访问指南 Marketplace、模型授权、账号额外准入 社区:Error 002 导致全部模型不可用 账号级模型访问受限案例 社区:新账号每日 Token 429 每日配额异常、初次请求失败 AWS 官方知识库:429 限流 RPM/TPM、监控与退避策略 用于 AI API 聚合渠道时,最重要的区分是: Error 002、Operation not allowed、明确的账号级 AccessDeniedException 应作为账号/渠道限制重点调查;普通 429 优先按限流处理;503/529 优先按临时容量问题处理;400 参数错误应反馈到客户端。不要把所有非 200 错误统一标记为账号封禁,也不要对所有错误无差别地重试。查到 Anthropic 官方文档中关于 Claude 预定义工具(Built-in Tools)的 Token 消耗 的说明。 最直接的官方文档是: Anthropic 官方文档:Specific tool pricing⁠ 文档路径:Models & pricing → Pricing → Specific tool pricing 1. 预定义工具 Token 数 以下是官方公开的工具定义 Token 开销,不包含实际执行时返回的内容。 预定义工具 Claude 4.6 及更早 Claude 4.7 及更新 Bash 244 325 Text Editor (20250728) 745 974 Computer Use(旧版) 约 735 约 735(旧版测量值) Computer Use Toolset(新版) — 约 4,500(整体) Browser Use Toolset(新版) — 约 6,600(整体) 注意: * Bash、Text Editor 的数字是工具定义额外消耗的输入 Token。Claude Platform Docs +1 * 旧版 Computer Use 的约 735 Token 是基于 computer_20250124 测量的参考值,不能视为所有模型的精确值。 * 新版 Computer Use 和 Browser Use 的数字包含工具定义及工具调用系统提示,不可以再直接叠加一次系统提示开销。Claude Platform Docs 2. 不同 Claude 模型的工具调用系统 Token 只要请求中提供了 tools,Anthropic 通常会额外加入工具调用系统提示。 模型 auto / none any / tool Claude Opus 5.5 286 406 Claude Sonnet 5.5 286 406 Claude Opus 4.7 675 804 Claude Opus 4.6 497 589 Claude Opus 4.5 496 588 Claude Sonnet 4.6 497 589 Claude Sonnet 4.5 496 588 Claude Haiku 4.5 496 588 这些是系统提示的额外 Token,不是工具自身定义的 Token。表格以至少提供一个工具为前提。Claude Platform Docs 官方文档: Tool use with Claude — Pricing⁠ 3. 其他预定义工具 对于下面这些工具,官方没有在定价总览中统一公布每个版本固定的工具定义 Token 数。 工具 官方固定 Token 数 web_search 未单独列出 web_fetch 未单独列出 code_execution 未单独列出 tool_search 未单独列出 memory 未单独列出 这些工具仍可能消耗输入、输出或执行结果 Token。例如 Web Search 还会按搜索次数收费。Claude Platform Docs +1 完整预定义工具目录: Anthropic Tool reference⁠ 4. 使用官方 API 获取准确 Token 数 Anthropic 提供专门的接口: POST https://api.anthropic.com/v1/messages/count_tokens 以下是 Bash 预定义工具的测试请求: curl https://api.anthropic.com/v1/messages/count_tokens \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "claude-sonnet-4-6", "tools": [ { "type": "bash_20250124", "name": "bash" } ], "messages": [ { "role": "user", "content": "Hello" } ] }' 接口返回类似: { "input_tokens": 800 } 这里的 800 仅为响应格式示例,不是实测值。实际返回的是包含工具定义、系统开销及消息内容的输入 Token 总数。 对同一模型和消息分别发送带工具、不带工具的计数请求,即可计算工具带来的额外 Token 开销。更换工具版本也可以采用同样的方法。 官方文档: Token counting — Count tokens in messages with tools⁠ 对于你要检测上游是否为 Anthropic 官方 API 的场景: 建议使用官方 Token Counting API 建立不同模型、工具版本和 tool_choice 的参考数据。不过,Token 数只能作为辅助指纹,不能单独证明上游就是官方 Anthropic;兼容代理也可能转发计数请求或模拟返回值。 Claude API 的 mcp_servers 是 Anthropic 官方提供的 MCP Connector(MCP 连接器) 功能,可以让 Claude 通过 Messages API 直接连接远程 MCP 服务器、发现工具并执行工具调用,无需自己实现 MCP Client。 有公开、免费、无需 Token 的 MCP 服务器可以直接用于测试。 我推荐先用 DeepWiki,适合测试你的 Claude API 上游是否正确支持 mcp_servers。 一、Claude API 的 mcp_servers 如何使用 根据 Anthropic 最新官方文档(2026 年 11 月),MCP Connector 仍属于 Beta 功能。 官方文档:Anthropic MCP Connector⁠ 调用时需要三个关键部分: 参数 作用 mcp_servers 定义远程 MCP 地址、名称和认证信息 tools 通过 mcp_toolset 指定启用的 MCP 工具 anthropic-beta 启用 MCP Connector 功能 目前主要有以下 Beta 版本: Beta Header 说明 mcp-client-2025-04-04 已弃用的旧版 mcp-client-2025-11-20 支持工具集配置、白名单、黑名单 mcp-client-2026-09-15 新版,增加 MCP 工具列表记录与固定(Pinning) 新版 2026-09-15 包含 2025-11-20 的能力。Claude Platform Docs +1 需要注意:Claude API 的 mcp_servers 目前仅支持通过 HTTPS 访问的远程 MCP,兼容 Streamable HTTP 和 SSE,不能直接运行本地 STDIO MCP Server。 二、公开且无需认证的 MCP 测试服务器 以下服务器都有公开的远程 MCP Endpoint,可以用于测试 Claude API。 1. DeepWiki MCP 首选测试 免费、无需 API Key,提供仓库文档读取和问答功能。 https://mcp.deepwiki.com/mcp 工具:read_wiki_structure、read_wiki_contents、ask_question 官方 GitHub⁠ 2. Cloudflare Documentation MCP 查询 Cloudflare 产品文档,适合测试文档搜索类工具。 https://docs.mcp.cloudflare.com/mcp Cloudflare 官方文档⁠ 3. AWS Knowledge MCP 查询 AWS 服务知识和官方技术信息,无需 AWS 凭证即可使用公开知识服务。 https://knowledge-mcp.global.api.aws AWS 官方文档⁠ DeepWiki 的无认证要求和三个工具由 Cognition 官方确认。以上地址是公开服务地址,但我没有在你的上游环境中实际完成调用,服务可用性仍以测试结果为准。Cognition +3 三、完整 Claude API 测试 CURL 下面是直接用于 Anthropic Messages API 的完整请求。 使用 DeepWiki,指定 Claude 调用 read_wiki_structure 工具读取 modelcontextprotocol/servers 仓库的文档结构。 使用最新 MCP Beta 版本 export ANTHROPIC_API_KEY="你的API密钥" export ANTHROPIC_BASE_URL="https://api.anthropic.com" curl -sS --fail-with-body \ "${ANTHROPIC_BASE_URL}/v1/messages" \ -H "x-api-key: ${ANTHROPIC_API_KEY}" \ -H "anthropic-version: 2023-06-01" \ -H "anthropic-beta: mcp-client-2026-09-15" \ -H "content-type: application/json" \ -d '{ "model": "claude-sonnet-5-5", "max_tokens": 2048, "messages": [ { "role": "user", "content": "请使用 DeepWiki 的 read_wiki_structure 工具,查询 modelcontextprotocol/servers 仓库的文档结构,并简要总结。" } ], "mcp_servers": [ { "type": "url", "name": "deepwiki", "url": "https://mcp.deepwiki.com/mcp" } ], "tools": [ { "type": "mcp_toolset", "mcp_server_name": "deepwiki", "default_config": { "enabled": false }, "configs": { "read_wiki_structure": { "enabled": true } } } ] }' 这里使用目前官方列出的 claude-sonnet-5-5 模型。Claude Platform Docs 正确响应是什么样的? 使用 mcp-client-2026-09-15 时,应该关注这三个响应类型: Content Block 意义 mcp_tool_listing MCP 工具发现结果,包含名称、描述和参数 Schema mcp_tool_use Claude 发起 MCP 工具调用 mcp_tool_result MCP 服务执行工具后的返回结果 示意结构(非真实执行结果): { "content": [ { "type": "mcp_tool_listing", "mcp_server_name": "deepwiki", "tools": [ { "name": "read_wiki_structure", "description": "...", "input_schema": {} } ] }, { "type": "mcp_tool_use", "id": "mcptoolu_example", "name": "read_wiki_structure", "server_name": "deepwiki", "input": { "repoName": "modelcontextprotocol/servers" } }, { "type": "mcp_tool_result", "tool_use_id": "mcptoolu_example", "is_error": false, "content": [ { "type": "text", "text": "..." } ] } ] } 后面通常还会包含 Claude 对结果的文字总结。 这类 MCP 工具调用是由 Anthropic 服务端执行的,和普通客户端工具 tool_use 不同,不需要你手动接收工具调用后再向 MCP Server 发请求。Claude Platform Docs 四、测试其他 MCP 功能 测试老版 Beta 协议 只需将上述 CURL 中的 Header 替换为: anthropic-beta: mcp-client-2025-11-20 mcp_servers 和 tools 结构保持不变。 注意,该版本不会产生新版的 mcp_tool_listing 块。 测试同时连接多个 MCP 服务器 { "mcp_servers": [ { "type": "url", "name": "deepwiki", "url": "https://mcp.deepwiki.com/mcp" }, { "type": "url", "name": "cloudflare", "url": "https://docs.mcp.cloudflare.com/mcp" } ], "tools": [ { "type": "mcp_toolset", "mcp_server_name": "deepwiki" }, { "type": "mcp_toolset", "mcp_server_name": "cloudflare" } ] } 将这两段数组添加到正常 Messages API 请求体中,就能测试多个 MCP Server 的工具发现与调用。每个服务器必须对应一个 mcp_toolset。 五、用于检测上游是否支持官方 Claude MCP 如果你是为了检测 AI API 中转渠道是否完整实现 Anthropic 协议,我建议按以下顺序测试: * 基础参数测试:请求包含 mcp_servers 和 mcp_toolset,确认没有被上游直接拒绝。 * 工具发现测试:使用 2026-09-15 版本,检查是否有 mcp_tool_listing,以及工具名称和 Schema 是否正确。 * 工具执行测试:检查 mcp_tool_use、mcp_tool_result,并确认 is_error: false。 * 工具白名单测试:只启用 read_wiki_structure,确认其他 MCP 工具不会被 Claude 使用。 * 多服务器测试:同时加入 DeepWiki 和 Cloudflare,检查两个工具集是否可以正常加载、独立调用。 重要区别: 如果请求成功,能够证明上游兼容相应 MCP 功能,但不能单凭这一点确定它一定是 Anthropic 官方直连。完整转发请求和响应的代理同样可以通过测试。反过来,如果测试失败,也可能是模型权限、Beta 功能支持、网络连通性或 MCP 服务自身异常,而不一定是伪造接口。 官方还支持固定 MCP 工具列表。使用 2026-09-15 时,可以先获取 mcp_tool_listing,再将返回的工具 Schema 固定到 mcp_toolset.tools,用于检测工具列表一致性。Claude Platform Docs 对于你的 API 渠道检测场景,DeepWiki + mcp-client-2026-09-15 + mcp_tool_listing + 实际工具调用 是最值得先实现的一组测试,既不需要额外准备 MCP 认证信息,也能覆盖工具发现与执行两个关键环节。 Anthropic 官方 API 模型与预定义工具兼容性清单 官方资料核查日期:2026 年 11 月 12 日 针对你现在的 Go AI API 中转与上游检测系统,建议建立一套 模型 ID × 预定义工具版本 × 请求协议 × 响应特征 的检测机制。 有一个关键结论: 支持 Anthropic Messages API,不等于上游就是 Anthropic 官方服务。 第三方服务可以兼容 Messages API,甚至模拟工具调用,但不一定真正实现 Anthropic 托管的服务器工具。 因此,检测需要分成三层: * 协议兼容性:是否支持 /v1/messages、模型查询、Anthropic 格式的工具声明。 * 官方工具能力:是否真正执行 Web Search、Web Fetch、Code Execution 等服务器工具。 * 来源验证:是否可以通过可信的官方连接或凭据确认请求经过 Anthropic,而不只是响应内容相似。 一、Anthropic 官方预定义工具总表 目前官方工具目录包含以下 11 类工具。此处先列出官方参考页当前列出的版本;更早的历史版本另行标注。 工具 当前官方 type 版本 执行位置 Web Search web_search_20250305、20260209、20260318 Anthropic 服务端 Web Fetch web_fetch_20250910、20260209、20260309、20260318 服务端 Code Execution code_execution_20250825、20260120、20260521 服务端 Advisor advisor_20260301 服务端 Tool Search tool_search_tool_regex_20251119、tool_search_tool_bm25_20251119 服务端 MCP Connector mcp_toolset 服务端 Memory memory_20250818 客户端 Bash bash_20250124 客户端 Text Editor text_editor_20250124、20250728 客户端 Computer Use computer_20250124、20251124、computer_toolset_20260801 客户端 Browser Use browser_toolset_20260801 客户端 这里省略版本公共前缀的写法仅用于展示。实际 API 请求必须使用完整字符串。 特别注意: Bash、Memory、Text Editor、Computer Use 和 Browser Use 都是客户端执行的工具。它们的 tool_use 返回值只能说明模型发起了工具调用,不能说明 Anthropic 官方服务器已经执行操作。 官方依据:Claude Platform Docs +2 二、各模型支持哪些工具 官方模型目录目前列出了 21 个模型版本,包括已退役版本。下表以 Anthropic 直连 Claude API 为基准,不把 Bedrock、Vertex AI 等平台的特殊兼容行为混在一起。 为了避免表格过宽,采用下面的规则: * 基础工具组 B:Web Search、Web Fetch、Code Execution、Bash、Text Editor、Memory、MCP Connector。这些工具在当前 Claude 4 及以上模型上均有对应的受支持版本,具体版本仍需匹配。 * TS:Tool Search * A:Advisor * C:Computer Use * R:Browser Use 模型 ID 基础组 B TS A C R claude-fable-5-2 ✓ ✓ ✓ 新版 ✓ claude-fable-5-1 ✓ ✓ ✓ 新版 ✓ claude-fable-5 ✓ ✓ ✓ 新版 ✓ claude-mythos-5-2 ✓ ✓ ✓ 新版 ✓ claude-mythos-5-1 ✓ ✓ ✓ 新版 ✓ claude-mythos-5 ✓ ✓ ✓ 新版 ✓ claude-opus-5-5 ✓ ✓ ✓ 新版 ✓ claude-opus-5 ✓ ✓ ✓ 新版 ✓ claude-opus-4-8 ✓ ✓ ✓ 新版 ✓ claude-opus-4-7 ✓ ✓ ✓ 20251124 — claude-opus-4-6 ✓ ✓ ✓ 20251124 — claude-opus-4-5-20251101 ✓ ✓ — 20251124 — claude-opus-4-1-20250805 ✓ — — 20250124 — claude-opus-4-20250514 ✓ — — 20250124 — claude-sonnet-5-5 ✓ ✓ ✓ 新版 ✓ claude-sonnet-5 ✓ ✓ ✓ 新版 ✓ claude-sonnet-4-6 ✓ ✓ ✓ 20251124 — claude-sonnet-4-5-20250929 ✓ ✓ — 20250124 — claude-sonnet-4-20250514 ✓ — — 20250124 — claude-haiku-5-5 ✓ ✓ ✓ 新版 ✓ claude-haiku-4-5-20251001 ✓ ✓ ✓ 20250124 — 其中「新版」是 computer_toolset_20260801;标注日期的 C 列代表 computer_ 加对应日期后缀。 这张表反映的是官方公布的模型与工具兼容范围,而不是我已持有 API Key 对所有组合完成实测的结果。 需要注意三个条件: * Mythos 模型存在访问限制,列入官方目录不代表任何账户都可调用。 * Opus 4.1、Opus 4 和 Sonnet 4 在 Claude API 上已退役,不能把它们用作当前在线检测的正常测试样本。 * Advisor 是一个双模型功能,表中 ✓ 只表示该模型可以充当支持的执行模型,实际还必须选择官方允许的 Advisor 模型配对。 官方依据:Claude Platform Docs +4 三、所有工具版本的官方 cURL 请求 我已整理成可以直接用于上游兼容性测试的文件,包含 11 类工具、29 组逐版本测试请求,以及 21 个模型的兼容矩阵。 完整测试包 包含全部 cURL、Bash 测试脚本、CSV 和 JSON 矩阵 已生成 下载完整 Anthropic 检测工具包 单独获取 29 组完整 cURL 文档 Markdown 可运行的测试脚本 Bash 模型 × 工具版本兼容矩阵 CSV 机器可读测试配置 JSON 除了前面列出的当前工具版本,测试包还补充了历史版本,包括: 工具 补充的历史版本 Code Execution code_execution_20250522 Bash bash_20241022 Text Editor text_editor_20241022、text_editor_20250429 Computer Use computer_20241022 MCP Connector mcp-client-2025-04-04、mcp-client-2025-11-20、mcp-client-2026-09-15 请求头格式 部分历史工具需要旧版模型或 Beta 请求头,不能保证在当前已退役模型上仍可运行。测试文件中将它们与现行版本区分开来。Claude Platform Docs +4 四、官方 cURL 调用示例 以 Web Search 的 web_search_20250305 为例: export ANTHROPIC_API_KEY="sk-ant-..." curl -sS https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2026-10-21" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 2048, "tools": [ { "type": "web_search_20250305", "name": "web_search", "max_uses": 1 } ], "messages": [ { "role": "user", "content": "Search the web for the IANA reserved domains page." } ] }' 可以将地址替换为待测上游的域名,对比其 HTTP 状态、响应结构和工具实际执行行为。 另外,推荐先查询官方 Models API: curl -sS \ "https://api.anthropic.com/v1/models?limit=100" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2026-10-21" /v1/models 返回的能力字段可用于预筛选,但它不能替代逐工具版本测试。Claude Platform Docs +1 五、直接运行上游检测 解压测试包后,在 Linux 或 macOS 下执行: export ANTHROPIC_API_KEY="你的上游API密钥" # 指向待测的 Anthropic 兼容上游 export BASE_URL="https://your-upstream.example.com" # 查看全部测试项 bash anthropic_tool_probes.sh list # 测试 Web Search bash anthropic_tool_probes.sh web_search:20250305 # 测试 Web Fetch bash anthropic_tool_probes.sh web_fetch:20250910 # 测试 Code Execution bash anthropic_tool_probes.sh code_execution:20260521 # 测试最新 Computer Use bash anthropic_tool_probes.sh computer_toolset:20260801 BASE_URL 应填写 API 根地址,不包含 /v1。脚本会自行拼接 /v1/messages。 MCP 测试还需要一个真实可访问的 MCP Server 地址。客户端工具测试只发送首轮请求;真正执行工具、提交 tool_result 需要由你的 Go 客户端完成。 六、怎样判断上游是不是 Anthropic 官方? 建议你的 Go 检测系统不要只有一个 is_official 布尔值,而要分开记录: 检测维度 检测内容 证明力 协议 Messages API、错误格式、流式事件 低 模型 Models API、模型 ID、能力字段 低 工具声明 是否接受正确工具版本、拒绝错误组合 中低 服务端执行 Web Search、Web Fetch、Code Execution 是否产生实际结果 较高 官方来源 可信的官方直连、TLS 连接目标及账户侧记录 最关键 例如,真实调用 Web Search 时,可检查 server_tool_use、web_search_tool_result 等内容块,而不是仅检查 200 OK。但这些 JSON 字段仍然可以由兼容服务模拟。Claude Platform Docs +1 检测结果建议定义为: type UpstreamDetection struct { ProtocolCompatible bool ModelCompatible bool SupportedTools map[string]bool ServerToolExecuted map[string]bool OfficialVerified bool Confidence float64 Evidence []string } 关键限制是:仅凭黑盒 API 的响应,无法百分之百证明上游就是 Anthropic 官方。 一个中转服务可以真实转发到 Anthropic,也可以模拟 Anthropic 的 API 行为。 因此,你的系统最终应区分: 「Anthropic 协议兼容」→「官方工具执行能力兼容」→「官方来源已验证」 而不是将模型和工具测试全部通过直接等同于官方直连。 本次提供的 cURL 和矩阵依据官方文档整理,脚本已通过 Bash 语法检查;由于没有你的上游 API Key,尚未对这些接口逐一发起真实请求验证。# GFast-V3

GFast V3.2

goframe vue element plus typescript vite license

## 平台简介 * 基于全新Go Frame 2.3+Vue3+Element Plus开发的全栈前后端分离的管理系统 * 前端采用vue-next-admin 、Vue、Element UI。 * 本项目由奇讯科技团队开发。 * 如您想购买云服务器请先领取阿里云优惠券:[点我进入](https://www.aliyun.com/minisite/goods?userCode=fcor2omk ),腾讯云优惠券:[点我领取](https://cloud.tencent.com/act/cps/redirect?redirect=1062&cps_key=20b1c3842f74986b2894e2c5fcde7ea2&from=console ) * 目前我们基于gfast开发了:吸vo( ̄▽ ̄)d毒人员风控平台、政府数据化招商平台、档案资源普查信息系统、扶贫资产管理系统、厂房消防安全风控平台、重点项目督办平台等。 ## 特征 * 高生产率:几分钟即可搭建一个后台管理系统 * 模块化:单应用多系统的模式,将一个完整的应用拆分为多个系统,后续扩展更加便捷,增加代码复用性。 * 插件化: 可通过插件的方式扩展系统功能 * 认证机制:采用gtoken的用户状态认证及casbin的权限认证 * 路由模式:得利于goframe2.0提供了规范化的路由注册方式,无需注解自动生成api文档 * 面向接口开发 ## 内置功能 1. 用户管理:用户是系统操作者,该功能主要完成系统用户配置。 2. 部门管理:配置系统组织机构(公司、部门、小组),树结构展现支持数据权限。 3. 岗位管理:配置系统用户所属担任职务。 4. 菜单管理:配置系统菜单,操作权限,按钮权限标识等。 5. 角色管理:角色菜单权限分配、设置角色按机构进行数据范围权限划分。 6. 字典管理:对系统中经常使用的一些较为固定的数据进行维护。 7. 参数管理:对系统动态配置常用参数。 8. 操作日志:系统正常操作日志记录和查询;系统异常信息日志记录和查询。 9. 登录日志:系统登录日志记录查询包含登录异常。 10. 在线用户:当前系统中活跃用户状态监控。 11. 定时任务:在线(添加、修改、删除)任务调度包含执行结果日志。 12. 代码生成:前后端代码的生成。 13. 服务监控:监视当前系统CPU、内存、磁盘、堆栈等相关信息。 14. 在线构建器:拖动表单元素生成相应的HTML代码。 15. 文件上传,缓存标签等。 > 项目使用模块化与插件化的方式开发,目前正在升级的插件有:cms系统、万能模型、微信管理、工单系统、问答系统、工作流引擎...,同时也欢迎大家把写好的插件上传到商城,我们来帮您实现技术变现,获取收益! > GFast开源以来得到了大家的很多支持,如果您愿意为GFast贡献代码或提供建议,请加微信:qixun007(备注:gfast) ## 演示地址 [http://v3.g-fast.cn/sys](http://v3.g-fast.cn/sys) 账号:demo 密码:123456 ## 配置 项目数据库文件 `resource/data/db.sql` 创建数据库导入后修改配置 `manifest/config/config.yaml.bak` 复制改为`manifest/config/config.yaml` 其中gfToken配置 ```yaml gfToken: cacheKey: "gfToken_" #缓存前缀 timeOut: 10800 #token超时时间(秒) maxRefresh: 5400 #token自动刷新时间(秒) multiLogin: true #是否允许一个账号多人同时登录 encryptKey: "49c54195e750b04e74a8429b17896586" #加密key (32位) cacheModel: "redis" #存储引擎 (memory使用内存|redis使用redis) excludePaths: #排除不做登录验证的路由地址 - "/api/v1/system/login" ``` 项目为前后端分离,前端地址: github地址:[https://github.com/tiger1103/gfast-ui](https://github.com/tiger1103/gfast-ui) gitee地址:[https://gitee.com/tiger1103/gfast-ui](https://gitee.com/tiger1103/gfast-ui) ## 文档地址 > [http://doc.g-fast.cn/docs/gfast32](http://doc.g-fast.cn/docs/gfast32) ## 相关视频 [https://space.bilibili.com/254192571/channel/seriesdetail?sid=223204](https://space.bilibili.com/254192571/channel/seriesdetail?sid=223204) ## 演示图
## 感谢(排名不分先后) > gf框架 [https://github.com/gogf/gf](https://github.com/gogf/gf) > > vue-next-admin [https://gitee.com/lyt-top/vue-next-admin](https://gitee.com/lyt-top/vue-next-admin) > > swaggo [https://github.com/swaggo/swag](https://github.com/swaggo/swag) > >gtoken [https://github.com/goflyfox/gtoken](https://github.com/goflyfox/gtoken) > >casbin [https://github.com/casbin/casbin](https://github.com/casbin/casbin) PHP开源工作流引擎tpflow [https://gitee.com/ntdgg/tpflow](https://gitee.com/ntdgg/tpflow) CCflow 国内最优秀的开源流程引擎 [https://gitee.com/opencc/ccflow](https://gitee.com/opencc/ccflow) ## 交流QQ群 > > 感谢你使用GFast,公司团队精力时间有限,因此我们不再提供免费的技术服务,目前Gfast QQ交流群有部分用户进行了捐赠,捐赠后请联系作者进vip用户群,vip群中问题将得到优先解答,同时也会根据您的需求进行分析和优先安排,vip群也会提供Gfast的其它福利。 > 同时您也可以联系我们,雇佣我们团队为您干活,谢谢合作! >快来加入群聊【Gfast框架交流群】(1群:865697297-已满,2群:444129379),发现精彩内容,记得备注加群来意。 ## 免责声明: > 1、Gfast仅限自己学习使用,一切商业行为与Gfast无关。 > 2、用户不得利用Gfast从事非法行为,用户应当合法合规的使用,发现用户在使用产品时有任何的非法行为,Gfast有权配合有关机关进行调查或向政府部门举报,Gfast不承担用户因非法行为造成的任何法律责任,一切法律责任由用户自行承担,如因用户使用造成第三方损害的,用户应当依法予以赔偿。 > 3、所有与使用Gfast相关的资源直接风险均由用户承担。 ## 商用说明 > 商用注意事项 如果您将此项目用于商业用途,请遵守Apache2.0协议并保留作者技术支持声明。 * GFast快速开发平台采用Apache-2.0技术协议 * 二次开发如用于商业性质或开源竞品请不要删除和修改GFast源码头部的版权与作者声明及出处 * 允许进行商用,但是不允许二次开源出来并进行收费 * 我们已经申请了相关的软件著作权和相关登记(证书号:软著登字第7511736号) * 如果您在自己的项目中使用了我们项目中的扩展或模块,请在项目介绍中进行明确说明 > 开源版包含基础框架功能,如您需要更多功能,请使用授权版。 #### 版本区别 | 权益对比 | 开源版 | 授权版 | |-----------|------------------|-----------------------------------------------| | 商用权限 | 仅供学习交流 | 企业外包、二次开发使用/商用 | | 社区 | QQ交流群 | 微信授权用户群 | | 服务 | QQ群答疑 | 微信团队答疑 | | 后台基础管理框架 | 提供 | 提供 | | 权限管理功能 | 基础版(基础rbac 权限管控) | 增强版(角色上下级权限,数据权限,角色有效期权限) |) | | 代码生成 | 无 | 提供(支持字典选项,树形结构选项,表关联,上传功能,富文本,导入导出excel等功能生成) | | 消息队列 | 无 | 提供 | | websocket | 无 | 提供(广播通知,私信通知) | | 技术咨询 | 无 | 提供 | | 部署指导 | 无 | 提供 | | Bug修复 | 不定期 | 快速修复并提交 | | 更新 | 不定期 | 及时更新 | #### 更新日志 #### V3.2.25 ##### date:2024-05-07 * 1、升级项目依赖包,更新存在安全风险的外部依赖包 * 2、修复数据权限为全部权限时model返回错误的bug * 3、修复webscoket空指针异常,兼容gf2.7.0 #### V3.2.24 #### date:2024-04-30 * 1、完善数据权限,简化数据权限接入 #### V3.2.23 #### date:2024-04-12 * 1、修复用户选择器回显问题 * 2、修复图片上传组件只上传一张图片时回显问题 * 3、完善角色授权模式 * 3.1、角色有效期和有效时间段设置,若设置了有效日期,只能在该时区内有权限访问 * 3.2、数据权限功能完善,可针对不同菜单设置不同的数据权限,数据权限划分更细化 更多更新说明请查看[更新日志](http://doc.g-fast.cn/docs/gfast32/gfast32-1fj8kpj9qhntm) ## 支持开源 如果您喜爱gfast,请给常熬夜的作者来杯咖啡吧! 点我送咖啡 ## [感谢JetBrains提供的免费GoLand](https://jb.gg/OpenSource) [![avatar](https://camo.githubusercontent.com/323657c6e81419b8e151e9da4c71f409e3fcc65d630535170c59fe4807dbc905/68747470733a2f2f676f6672616d652e6f72672f646f776e6c6f61642f7468756d626e61696c732f313131343131392f6a6574627261696e732e706e67)](https://jb.gg/OpenSource)