SuperAPI AI 工具集

aws-bedrock-agentcore-skill

智能体与模型

查看项目

更新于 10-15 21:41

技能介绍

用途:这是一个面向 AWS 的 AI 智能体构建技能包,为编码智能体提供官方指令、最佳实践、可用代码片段与来源 URL,使其能根据用户具体场景自主配置合适的智能体,而非套用单一模板。技能中每条结论都标注官方来源,来源索引位于 references/sources.md。

主要能力:提供自上而下的架构决策树,覆盖直接调用 Bedrock Converse API、Strands Agent 工具调用、Bedrock Knowledge Bases 的 RAG、多智能体(Graph/Swarm/Workflow/Agents-as-Tools/A2A)、AgentCore Runtime 无服务器部署、AgentCore Memory 持久记忆、Gateway 与 Identity 的鉴权与工具暴露、Guardrails 安全合规、Observability 可观测性、测试与灰度发布、批处理与成本路由等分支。还给出常见场景的编排配方(简单聊天、工具型智能体、私有文档 RAG、多智能体、无服务器生产智能体、带记忆与用户鉴权的智能体、测试与安全上线)。

使用方式:先读决策树确定用例与所需模式,再按参考索引只打开匹配的参考文件(渐进式披露,避免全量加载);推荐前确认功能成熟度(GA/Preview),不得将 Preview 功能作为生产默认;对时效性事实(模型 ID、价格、配额)需回到官方模型卡、Bedrock 定价页与 Service Quotas 控制台核实,不要硬编码;给出建议时向用户回引官方 URL。

核心原则:默认使用 BedrockModel/Converse API,不用旧版 InvokeModel;显式设置区域(优先 region_name 或 AWS_DEFAULT_REGION,AWS_REGION 优先级最低);IAM 最小权限并对信任策略加 aws:SourceAccount 与 aws:SourceArn 防混淆代理;按真实需要设置 max_tokens(Claude 3.7+/4.x 请求开始时按 input_tokens+max_tokens 预留 TPM 配额,结束时实际输出按 5 倍计费);部署前验证模型访问权限;多智能体中 SessionManager 只放在编排器上;部署前启用 CloudWatch Transaction Search;生产使用编号版 Guardrail 与推理配置文件;AgentCore Runtime 仅支持 ARM64 且需遵守 /invocations 与 8080 端口 /ping 的 HTTP 契约;长期记忆为异步,写入后不可立即读取;显式关闭会话与外部资源;合理组织提示缓存。

限制:模型 ID、价格、配额等会变化,需实时核实;部分 AgentCore 能力仍为 Preview,API 与行为可能变动;技能内部若出现冲突,以 references/ 详细参考文件为准,仍不确定时以 references/sources.md 中的官方 URL 为准。具体安装命令与代码示例资料中未完整提供。