AgentCore SDK 概述-智能体构建和治理平台 AgentCore-阿里云帮助中心

基于 AgentCore 开发 Agent 应用时，模型、MCP 工具、Skill、记忆和凭证都由平台托管。逐个拼接资源访问地址和访问密钥会使应用随运行环境变化而失效，凭证也容易写进代码或日志。AgentCore SDK 让业务代码按名称调用这些托管资源，把资源接入已有的 Agent 框架，并通过 AG-UI 或 OpenAI Chat Completions 协议对外提供 Agent 服务。

本文是 AgentCore SDK 文档入口，用于确认 SDK 的能力边界、选择开发语言、准备所需资源并选定对外服务协议；安装命令、代码示例和框架集成方法由两篇使用指南按开发语言分别介绍。

功能介绍

功能	说明
模型	按模型连接名称调用云端模型，支持普通调用和流式输出；也可接入自有模型服务。
MCP	获取工具列表、调用工具，并将工具接入 Agent 框架；支持平台托管的 MCP 服务和自有服务。
Skill	加载平台已发布的 Skill，或加载随应用分发的 Skill 文件。
记忆	写入、检索、查询、更新和删除记忆，并通过框架适配器接入 Agent 执行流程。
凭证	按名称获取托管凭证，或为 MCP 显式绑定 MCP Header 凭证。
框架适配	转换模型、工具和执行事件。
对外服务协议	使用 AgentCoreServer 提供 AG-UI、OpenAI Chat Completions 或自定义协议服务，也可以继续使用现有 Web 服务。

本文介绍的 alibabacloud-agentcore-sdk 是用于开发 Agent 应用的 SDK，与调用平台管理 API 的 OpenAPI SDK 不是同一个包。SDK 不负责创建 Workspace、上传代码、构建镜像或部署应用。云端资源示例由 AgentCore 托管的应用运行环境执行，SDK 从运行环境获取访问配置，业务代码无需填写平台访问密钥。自有模型、自有 MCP 服务和随应用分发的 Skill 无需注册为平台资源，其连接方式见对应使用指南的“接入自定义资源”。

选择开发语言

开发语言	使用指南	基础运行环境
Python	AgentCore Python SDK 使用指南	Python 3.10 及以上。部分框架需要更高版本，详见对应使用指南。
JavaScript / TypeScript	AgentCore Node.js SDK 使用指南	Node.js 20.3 及以上。部分框架需要更高版本，详见对应使用指南。

两篇使用指南都包含托管资源与自定义资源的调用方法、完整的 LangChain Agent 服务示例、协议调用示例和常见问题，只需阅读所用语言的那一篇，无需对照另一种语言的参数和代码。各语言支持的框架与记忆适配范围详见对应使用指南。

使用前准备

开通 AgentCore，并按管理 Workspace创建 Agent 所属的 Workspace。
根据应用需要的能力准备资源，并确认 Agent 对这些资源具有相应访问权限。

各能力需要准备的资源如下：

需要的能力	需要准备的资源
调用云端模型	模型连接，以及该连接中已配置的模型。创建方式见管理模型。
使用 MCP	MCP 服务。创建方式见管理 MCP 工具。
使用 Skill	已启用且有已发布版本的 Skill。创建与发布流程见管理 Skill。
使用记忆	MemoryStore。
使用托管凭证	按需创建 API Key 凭证或 MCP Header 凭证。创建与授权方式见管理凭证。

只调用模型时，无需创建 MCP、Skill、MemoryStore 或额外凭证。完成准备后，打开所用语言的使用指南，安装 SDK 及所需框架依赖，然后编写并部署 Agent 应用。

选择对外服务协议

需求	协议
展示 Agent 多步执行过程、消息边界、工具调用和结果	AG-UI
接入使用 Chat Completions 格式的客户端	OpenAI Chat Completions

AG-UI 与 OpenAI Chat Completions 的表达范围不同：AG-UI 保留独立的工具结果事件，OpenAI Chat Completions 不提供独立的工具结果响应事件。具体请求示例、事件说明和限制见对应使用指南的“调用 Agent 服务”。此外，AgentCoreServer 也支持以自定义协议对外提供服务，还可以继续使用现有 Web 服务。

AgentCoreServer 只负责协议接入，不会自动持久化对话历史。会话状态由应用或框架维护，长期记忆不能替代完整的会话历史。

功能介绍

选择开发语言

使用前准备

选择对外服务协议

相关文档