功能域Functional domain

渠道与平台集成Channels & integrations

企业微信、飞书、钉钉、GitHub/GitLab、CopilotKit、Nacos、RocketMQ、对象存储等外部平台适配。关注鉴权、幂等、回调和消息格式转换。Adapters for WeCom, Feishu, DingTalk, GitHub/GitLab, CopilotKit, Nacos, RocketMQ and object storage, with auth, idempotency and callbacks.

154类型总数types total

47Python

107Java

3学习锚点learning anchors

心智模型Mental model

平台集成层把智能体接入企业消息渠道和基础设施：钉钉、飞书、Discord、消息队列、对象存储与 API 网关。Platform integration connects agents to enterprise channels and infrastructure: DingTalk, Feishu, Discord, messaging queues, object storage and gateways.

先学什么What to learn first

渠道回调必须验签、去重并快速 ACK，重活异步处理。Channel callbacks must verify signatures, deduplicate and ACK fast; do heavy work asynchronously.
渠道消息与内部 Msg 之间需要可靠的映射和 id 关联。Maintain reliable mapping and id correlation between channel messages and internal Msg.
限流与重试策略要服从各平台配额。Rate limits and retries must respect each platform's quotas.

生产常见坑Production pitfalls

同步处理渠道回调导致平台超时重推，产生重复回复。Synchronous callback handling triggers platform retries and duplicate replies.
未做消息幂等，机器人重复应答。No idempotency causes repeated bot responses.

进入对应闯关单元Practice this domain →

域内图谱Domain map

点击节点打开 API 页面；拖拽平移，滚轮缩放。Click a node to open its API page. Drag to pan, scroll to zoom.

Python API 集Python API set 47

归入本功能域的全部 Python 公开类型，按所属包分组。Every public Python type classified into this domain, grouped by owning package.

agentscope.app.channel27

`BindingState`	class	绑定状态，把智能体接入外部消息渠道与企业平台。
`BindingStep`	class	绑定步骤，把智能体接入外部消息渠道与企业平台。
`ChannelBase`	class	平台渠道的抽象基类。
`ChannelBase.Config`	class	配置，保存相关配置项。
`ChannelBase.Credentials`	class	凭证，把智能体接入外部消息渠道与企业平台。
`ChannelCapability`	class	渠道能力，把智能体接入外部消息渠道与企业平台。
`ChannelClients`	class	渠道客户端，封装与远端服务的连接和调用。
`ChannelConfirmationResultEvent`	class	渠道确认结果事件，描述执行过程中的事件。
`ChannelError`	class	渠道错误，把智能体接入外部消息渠道与企业平台。
`ChannelEvent`	class	渠道事件，描述执行过程中的事件。
`ChannelGateway`	class	渠道网关，把智能体接入外部消息渠道与企业平台。
`ChannelHeartbeat`	class	渠道心跳，把智能体接入外部消息渠道与企业平台。
`ChannelLifecycleDispatcher`	class	渠道生命周期调度器，把智能体接入外部消息渠道与企业平台。
`ChannelStatus`	class	渠道状态，把智能体接入外部消息渠道与企业平台。
`ChannelTypeRegistry`	class	渠道类型注册表，把智能体接入外部消息渠道与企业平台。
`ChannelTypeSchema`	class	渠道类型模式，把智能体接入外部消息渠道与企业平台。
`ChatKind`	class	聊天种类，把智能体接入外部消息渠道与企业平台。
`CredentialBindingBase`	class	凭证绑定基类，把智能体接入外部消息渠道与企业平台。
`DingTalkChannel`	class	DingTalk 渠道，把智能体接入外部消息渠道与企业平台。
`DingTalkChannel.Config`	class	配置，保存相关配置项。
`DingTalkChannel.Credentials`	class	凭证，把智能体接入外部消息渠道与企业平台。
`DiscordChannel`	class	Discord 渠道，把智能体接入外部消息渠道与企业平台。
`DiscordChannel.Config`	class	配置，保存相关配置项。
`DiscordChannel.Credentials`	class	凭证，把智能体接入外部消息渠道与企业平台。
`FeishuChannel`	class	Feishu 渠道，把智能体接入外部消息渠道与企业平台。
`FeishuChannel.Config`	class	配置，保存相关配置项。
`FeishuChannel.Credentials`	class	凭证，把智能体接入外部消息渠道与企业平台。

agentscope.app.hub11

`ClawSkillHub`	class	Claw 技能中心，把智能体接入外部消息渠道与企业平台。
`GitHubMCPHub`	class	GitHub MCP 中心，把智能体接入外部消息渠道与企业平台。
`HubBase`	class	中心基类，把智能体接入外部消息渠道与企业平台。
`HubError`	class	中心错误，把智能体接入外部消息渠道与企业平台。
`MCPCard`	class	MCP 卡片，把智能体接入外部消息渠道与企业平台。
`MCPHubBase`	class	MCP 中心基类，把智能体接入外部消息渠道与企业平台。
`MCPHubPage`	class	MCP 中心页码，把智能体接入外部消息渠道与企业平台。
`SkillArchive`	class	技能归档，把智能体接入外部消息渠道与企业平台。
`SkillCard`	class	技能卡片，把智能体接入外部消息渠道与企业平台。
`SkillHubBase`	class	技能中心基类，把智能体接入外部消息渠道与企业平台。
`SkillHubPage`	class	技能中心页码，把智能体接入外部消息渠道与企业平台。

agentscope.app.access5

`DenyAllResourceAccessPolicy`	class	拒绝所有资源访问策略，把智能体接入外部消息渠道与企业平台。
`ResourceAccessPolicyBase`	class	资源访问策略基类，把智能体接入外部消息渠道与企业平台。
`ResourceKind`	class	资源种类，把智能体接入外部消息渠道与企业平台。
`ResourcePermission`	class	资源权限，把智能体接入外部消息渠道与企业平台。
`ResourceRef`	class	资源引用，把智能体接入外部消息渠道与企业平台。

agentscope.app.message_bus4

`InMemoryMessageBus`	class	In 记忆消息总线，把智能体接入外部消息渠道与企业平台。
`MessageBus`	class	消息总线，把智能体接入外部消息渠道与企业平台。
`MessageBusKeys`	class	消息总线密钥，把智能体接入外部消息渠道与企业平台。
`RedisMessageBus`	class	Redis 消息总线，把智能体接入外部消息渠道与企业平台。

Java API 集Java API set 107

归入本功能域的全部 Java 公开类型，按包分组并标注构件。Every public Java type classified into this domain, grouped by package with its artifact.

io.agentscope.extensions.channel.weixin17

`JsonNodeResponse`	record	`agentscope-extensions-channel-weixin`	承载 JSON 节点响应数据的记录类型。
`WeixinChannel`	class	`agentscope-extensions-channel-weixin`	Weixin 渠道，把智能体接入外部消息渠道与企业平台。
`WeixinChannelProperties`	record	`agentscope-extensions-channel-weixin`	承载 Weixin 渠道属性数据的记录类型。
`WeixinCredentialProvider`	interface	`agentscope-extensions-channel-weixin`	定义 Weixin 凭证提供者契约的接口。
`WeixinCredentialRejectedException`	class	`agentscope-extensions-channel-weixin`	Weixin 凭证已拒绝异常，表示执行过程中的错误。
`WeixinCredentials`	record	`agentscope-extensions-channel-weixin`	承载 Weixin 凭证数据的记录类型。
`WeixinInboundMapper`	class	`agentscope-extensions-channel-weixin`	Weixin 入站 Mapper，把智能体接入外部消息渠道与企业平台。
`WeixinInboxClaim`	record	`agentscope-extensions-channel-weixin`	承载 Weixin 收件箱 Claim数据的记录类型。
`WeixinInboxMessage`	record	`agentscope-extensions-channel-weixin`	承载 Weixin 收件箱消息数据的记录类型。
`WeixinLease`	record	`agentscope-extensions-channel-weixin`	承载 Weixin Lease数据的记录类型。
`WeixinLoginChallenge`	record	`agentscope-extensions-channel-weixin`	承载 Weixin Login Challenge数据的记录类型。
`WeixinLoginClient`	class	`agentscope-extensions-channel-weixin`	Weixin Login 客户端，封装与远端服务的连接和调用。
`WeixinLoginSession`	record	`agentscope-extensions-channel-weixin`	承载 Weixin Login 会话数据的记录类型。
`WeixinLoginStep`	record	`agentscope-extensions-channel-weixin`	承载 Weixin Login 步骤数据的记录类型。
`WeixinOutboundClient`	class	`agentscope-extensions-channel-weixin`	Weixin 出站客户端，封装与远端服务的连接和调用。
`WeixinRuntimeListener`	interface	`agentscope-extensions-channel-weixin`	定义 Weixin 运行时监听器契约的接口。
`WeixinStateStore`	interface	`agentscope-extensions-channel-weixin`	定义 Weixin 状态存储契约的接口。

io.agentscope.extensions.channel.dingtalk9

`DingTalkAccessTokenProvider`	class	`agentscope-extensions-channel-dingtalk`	DingTalk 访问令牌提供者，把智能体接入外部消息渠道与企业平台。
`DingTalkCallbackController`	class	`agentscope-extensions-channel-dingtalk`	DingTalk 回调控制器，把智能体接入外部消息渠道与企业平台。
`DingTalkCallbackCrypto`	class	`agentscope-extensions-channel-dingtalk`	DingTalk 回调 Crypto，把智能体接入外部消息渠道与企业平台。
`DingTalkChannel`	class	`agentscope-extensions-channel-dingtalk`	DingTalk 渠道，把智能体接入外部消息渠道与企业平台。
`DingTalkChannelProperties`	record	`agentscope-extensions-channel-dingtalk`	承载 DingTalk 渠道属性数据的记录类型。
`DingTalkChannelRegistry`	class	`agentscope-extensions-channel-dingtalk`	DingTalk 渠道注册表，把智能体接入外部消息渠道与企业平台。
`DingTalkInboundMapper`	class	`agentscope-extensions-channel-dingtalk`	DingTalk 入站 Mapper，把智能体接入外部消息渠道与企业平台。
`DingTalkOutboundClient`	class	`agentscope-extensions-channel-dingtalk`	DingTalk 出站客户端，封装与远端服务的连接和调用。
`DingTalkStreamClient`	class	`agentscope-extensions-channel-dingtalk`	DingTalk 流客户端，封装与远端服务的连接和调用。

io.agentscope.examples.copilotkit.a2ui8

`A2uiComposer`	class	`agentscope-copilotkit`	A 2 ui Composer，把智能体接入外部消息渠道与企业平台。
`A2uiModelClient`	interface	`agentscope-copilotkit`	定义 A 2 ui 模型客户端契约的接口。
`A2uiOperations`	class	`agentscope-copilotkit`	A 2 ui Operations，把智能体接入外部消息渠道与企业平台。
`A2uiSchemaSource`	interface	`agentscope-copilotkit`	定义 A 2 ui 模式来源契约的接口。
`A2uiSurface`	record	`agentscope-copilotkit`	承载 A 2 ui Surface数据的记录类型。
`BundledA2uiSchemaSource`	class	`agentscope-copilotkit`	Bundled A 2 ui 模式来源，把智能体接入外部消息渠道与企业平台。
`DashScopeA2uiModelClient`	class	`agentscope-copilotkit`	DashScope A 2 ui 模型客户端，封装与远端服务的连接和调用。
`WorkbenchCatalog`	class	`agentscope-copilotkit`	Workbench 目录，把智能体接入外部消息渠道与企业平台。

io.agentscope.extensions.channel.feishu8

`FeishuAccessTokenProvider`	class	`agentscope-extensions-channel-feishu`	Feishu 访问令牌提供者，把智能体接入外部消息渠道与企业平台。
`FeishuCallbackController`	class	`agentscope-extensions-channel-feishu`	Feishu 回调控制器，把智能体接入外部消息渠道与企业平台。
`FeishuChannel`	class	`agentscope-extensions-channel-feishu`	Feishu 渠道，把智能体接入外部消息渠道与企业平台。
`FeishuChannelProperties`	record	`agentscope-extensions-channel-feishu`	承载 Feishu 渠道属性数据的记录类型。
`FeishuChannelRegistry`	class	`agentscope-extensions-channel-feishu`	Feishu 渠道注册表，把智能体接入外部消息渠道与企业平台。
`FeishuCrypto`	class	`agentscope-extensions-channel-feishu`	Feishu Crypto，把智能体接入外部消息渠道与企业平台。
`FeishuInboundMapper`	class	`agentscope-extensions-channel-feishu`	Feishu 入站 Mapper，把智能体接入外部消息渠道与企业平台。
`FeishuOutboundClient`	class	`agentscope-extensions-channel-feishu`	Feishu 出站客户端，封装与远端服务的连接和调用。

io.agentscope.extensions.channel.github8

`GitHubBotIdentityResolver`	class	`agentscope-extensions-channel-github`	GitHub Bot 身份解析器，把智能体接入外部消息渠道与企业平台。
`GitHubChannel`	class	`agentscope-extensions-channel-github`	GitHub 渠道，把智能体接入外部消息渠道与企业平台。
`GitHubChannelProperties`	record	`agentscope-extensions-channel-github`	承载 GitHub 渠道属性数据的记录类型。
`GitHubChannelRegistry`	class	`agentscope-extensions-channel-github`	GitHub 渠道注册表，把智能体接入外部消息渠道与企业平台。
`GitHubInboundMapper`	class	`agentscope-extensions-channel-github`	GitHub 入站 Mapper，把智能体接入外部消息渠道与企业平台。
`GitHubOutboundClient`	class	`agentscope-extensions-channel-github`	GitHub 出站客户端，封装与远端服务的连接和调用。
`GitHubSignatureVerifier`	class	`agentscope-extensions-channel-github`	GitHub Signature 校验器，把智能体接入外部消息渠道与企业平台。
`GitHubWebhookController`	class	`agentscope-extensions-channel-github`	GitHub Webhook 控制器，把智能体接入外部消息渠道与企业平台。

io.agentscope.extensions.channel.wecom8

`WeComAccessTokenProvider`	class	`agentscope-extensions-channel-wecom`	WeCom 访问令牌提供者，把智能体接入外部消息渠道与企业平台。
`WeComCallbackController`	class	`agentscope-extensions-channel-wecom`	WeCom 回调控制器，把智能体接入外部消息渠道与企业平台。
`WeComChannel`	class	`agentscope-extensions-channel-wecom`	WeCom 渠道，把智能体接入外部消息渠道与企业平台。
`WeComChannelProperties`	record	`agentscope-extensions-channel-wecom`	承载 WeCom 渠道属性数据的记录类型。
`WeComChannelRegistry`	class	`agentscope-extensions-channel-wecom`	WeCom 渠道注册表，把智能体接入外部消息渠道与企业平台。
`WeComCrypto`	class	`agentscope-extensions-channel-wecom`	WeCom Crypto，把智能体接入外部消息渠道与企业平台。
`WeComInboundMapper`	class	`agentscope-extensions-channel-wecom`	WeCom 入站 Mapper，把智能体接入外部消息渠道与企业平台。
`WeComOutboundClient`	class	`agentscope-extensions-channel-wecom`	WeCom 出站客户端，封装与远端服务的连接和调用。

io.agentscope.extensions.channel.common7

`AccessTokenStore`	interface	`agentscope-extensions-channel-common`	定义访问令牌存储契约的接口。
`BotLoopGuard`	class	`agentscope-extensions-channel-common`	Bot 循环守卫，把智能体接入外部消息渠道与企业平台。
`CachedAccessToken`	record	`agentscope-extensions-channel-common`	承载已缓存访问令牌数据的记录类型。
`ChannelMediaMetadata`	class	`agentscope-extensions-channel-common`	渠道 Media 元数据，把智能体接入外部消息渠道与企业平台。
`IdempotencyStore`	class	`agentscope-extensions-channel-common`	Idempotency 存储，负责持久化与读取数据。
`InboundEventDeduplicator`	interface	`agentscope-extensions-channel-common`	定义入站事件 Deduplicator契约的接口。
`InMemoryAccessTokenStore`	class	`agentscope-extensions-channel-common`	In 记忆访问令牌存储，负责持久化与读取数据。

io.agentscope.extensions.channel.gitlab7

`GitLabBotIdentityResolver`	class	`agentscope-extensions-channel-gitlab`	GitLab Bot 身份解析器，把智能体接入外部消息渠道与企业平台。
`GitLabChannel`	class	`agentscope-extensions-channel-gitlab`	GitLab 渠道，把智能体接入外部消息渠道与企业平台。
`GitLabChannelProperties`	record	`agentscope-extensions-channel-gitlab`	承载 GitLab 渠道属性数据的记录类型。
`GitLabChannelRegistry`	class	`agentscope-extensions-channel-gitlab`	GitLab 渠道注册表，把智能体接入外部消息渠道与企业平台。
`GitLabInboundMapper`	class	`agentscope-extensions-channel-gitlab`	GitLab 入站 Mapper，把智能体接入外部消息渠道与企业平台。
`GitLabOutboundClient`	class	`agentscope-extensions-channel-gitlab`	GitLab 出站客户端，封装与远端服务的连接和调用。
`GitLabWebhookController`	class	`agentscope-extensions-channel-gitlab`	GitLab Webhook 控制器，把智能体接入外部消息渠道与企业平台。

io.agentscope.extensions.cos7

`Builder`	class	`agentscope-extensions-cos`	构建器，用于构建并配置目标实例。
`Builder`	class	`agentscope-extensions-cos`	构建器，用于构建并配置目标实例。
`CosAgentStateStore`	class	`agentscope-extensions-cos`	COS 智能体状态存储，负责持久化与读取数据。
`CosBaseStore`	class	`agentscope-extensions-cos`	COS 基类存储，负责持久化与读取数据。
`CosDistributedStore`	class	`agentscope-extensions-cos`	COS 分布式存储，负责持久化与读取数据。
`CosRemoteSnapshotClient`	class	`agentscope-extensions-cos`	COS 远程快照客户端，封装与远端服务的连接和调用。
`CosSnapshotSpec`	class	`agentscope-extensions-cos`	COS 快照规格，把智能体接入外部消息渠道与企业平台。

io.agentscope.extensions.oss7

`Builder`	class	`agentscope-extensions-oss`	构建器，用于构建并配置目标实例。
`Builder`	class	`agentscope-extensions-oss`	构建器，用于构建并配置目标实例。
`OssAgentStateStore`	class	`agentscope-extensions-oss`	OSS 智能体状态存储，负责持久化与读取数据。
`OssBaseStore`	class	`agentscope-extensions-oss`	OSS 基类存储，负责持久化与读取数据。
`OssDistributedStore`	class	`agentscope-extensions-oss`	OSS 分布式存储，负责持久化与读取数据。
`OssRemoteSnapshotClient`	class	`agentscope-extensions-oss`	OSS 远程快照客户端，封装与远端服务的连接和调用。
`OssSnapshotSpec`	class	`agentscope-extensions-oss`	OSS 快照规格，把智能体接入外部消息渠道与企业平台。

io.agentscope.examples.copilotkit.service6

`AgentEventAguiReplayer`	class	`agentscope-copilotkit`	智能体事件 AGUI Replayer，把智能体接入外部消息渠道与企业平台。
`CopilotKitRuntimeService`	class	`agentscope-copilotkit`	CopilotKit 运行时服务，把智能体接入外部消息渠道与企业平台。
`DemoThreadStore`	class	`agentscope-copilotkit`	Demo 会话线程存储，负责持久化与读取数据。
`InMemoryAgentEventStore`	class	`agentscope-copilotkit`	In 记忆智能体事件存储，负责持久化与读取数据。
`PersistingAgentEventEnricher`	class	`agentscope-copilotkit`	Persisting 智能体事件 Enricher，把智能体接入外部消息渠道与企业平台。
`StoredAgentEvent`	record	`agentscope-copilotkit`	承载已存储智能体事件数据的记录类型。

io.agentscope.examples.copilotkit.workbench6

`RefundOrderTool`	class	`agentscope-copilotkit`	Refund 顺序工具，封装可被智能体调用的能力。
`WorkbenchAguiEventConverter`	class	`agentscope-copilotkit`	Workbench AGUI 事件转换器，把智能体接入外部消息渠道与企业平台。
`WorkbenchEventMiddleware`	class	`agentscope-copilotkit`	Workbench 事件中间件，在智能体执行流程中提供横切扩展。
`WorkbenchState`	class	`agentscope-copilotkit`	Workbench 状态，把智能体接入外部消息渠道与企业平台。
`WorkbenchStateRegistry`	class	`agentscope-copilotkit`	Workbench 状态注册表，把智能体接入外部消息渠道与企业平台。
`WorkbenchTools`	class	`agentscope-copilotkit`	Workbench 工具，封装可被智能体调用的能力。

io.agentscope.extensions.higress5

`HigressMcpClientBuilder`	class	`agentscope-extensions-higress`	Higress MCP 客户端构建器，用于构建并配置目标实例。
`HigressMcpClientWrapper`	class	`agentscope-extensions-higress`	Higress MCP 客户端包装器，把智能体接入外部消息渠道与企业平台。
`HigressToolkit`	class	`agentscope-extensions-higress`	Higress 工具包，把智能体接入外部消息渠道与企业平台。
`HigressToolSearchResult`	class	`agentscope-extensions-higress`	Higress 工具搜索结果，把智能体接入外部消息渠道与企业平台。
`ToolInfo`	record	`agentscope-extensions-higress`	承载工具信息数据的记录类型。

io.agentscope.examples.copilotkit.config2

`AgentConfiguration`	class	`agentscope-copilotkit`	智能体配置，保存相关配置项。
`CopilotKitRouteConfiguration`	class	`agentscope-copilotkit`	CopilotKit 路由配置，保存相关配置项。

io.agentscope.core.nacos.prompt1

NacosPromptListener class agentscope-extensions-nacos-prompt Nacos 提示词监听器，把智能体接入外部消息渠道与企业平台。

io.agentscope.examples.copilotkit1

CopilotKitExampleApplication class agentscope-copilotkit CopilotKit Example 应用，把智能体接入外部消息渠道与企业平台。

Python ↔ Java 对照Python ↔ Java

Python

MCPHubBaseSessionRecordInMemoryMessageBus

Java

ChannelWorkBridgeChannelConfigEntryNacosAgentRegistry

两套实现共享同一概念模型，但在并发（async/await 与 Reactor）、打包（wheel 模块与 Maven 构件）和生命周期 API 上存在差异。需要精确签名时请使用 API 全景。The two implementations follow the same conceptual model but differ in concurrency (async/await vs Reactor), packaging (wheel modules vs Maven artifacts) and lifecycle APIs. Use the full API map to locate exact signatures.

打开 API 全景Open full API map →