managed-agent-sdk 0.0.1__py3-none-any.whl

managed_agent_sdk/__init__.py

@@ -0,0 +1,325 @@
+"""Managed Agent SDK（Python）。
+
+控制面走腾讯云 API，数据面走 ACP 协议，两段凭证由 SDK 内部缝合。
+API 与 Node 版 ``@tencent-ai/managed-agent-sdk`` 保持一致。
+
+Example:
+    >>> import asyncio
+    >>> from managed_agent_sdk import (
+    ...     CreateAgentOpts, CreateSessionOpts, CreateVersionOpts,
+    ...     ManagedAgentClient, ManifestBuilder,
+    ... )
+    >>>
+    >>> async def main():
+    ...     async with ManagedAgentClient() as client:
+    ...         agent = await client.agents.create(
+    ...             CreateAgentOpts(
+    ...                 agent_name="日志分析助手",
+    ...                 model="deepseek-v3",
+    ...                 manifest=ManifestBuilder()
+    ...                     .system_prompt("你是日志分析专家")
+    ...                     .build(),
+    ...             )
+    ...         )
+    ...         version = await agent.versions.create(CreateVersionOpts())
+    ...         session = await agent.sessions.create(
+    ...             CreateSessionOpts(version_id=version.version_id)
+    ...         )
+    ...         res = await session.prompt("分析这份日志")
+    ...         print(res.stop_reason)
+    ...         await session.disconnect()
+    >>>
+    >>> asyncio.run(main())  # doctest: +SKIP
+
+两条与出参有关的约定（与 Node 版一致）：
+
+1. **入参 snake_case，出参 PascalCase** —— 出参原样透传云 API 字段名，
+   便于对照官方文档排查。
+2. **不做控制面自动重试** —— ``Create*`` 类接口非幂等且无 ``ClientToken``，
+   重试 ``sessions.create()`` 会重复拉起沙箱并产生真实费用。
+"""
+
+from __future__ import annotations
+
+from ._version import __version__
+from .acp.client import AcpConnectionState, NotificationListener
+from .acp_types import (
+    AudioContent,
+    ContentBlock,
+    EmbeddedResource,
+    ImageContent,
+    PromptResponse,
+    ResourceLink,
+    SessionNotification,
+    TextContent,
+)
+from .agent import (
+    Agent,
+    AgentA2A,
+    AgentSessions,
+    AgentVersions,
+    CreateSessionOpts,
+    UpdateA2AOpts,
+    UpdateAgentOpts,
+)
+from .auth import ChatCredentialProvider, OneIdCredentialProvider
+
+# CapiClient / resolve_credentials 不对外导出：SDK 不提供调用未封装接口的透传能力
+# （与 Node 侧 index.ts 一致）。内部联调脚本（e2e）直接从 .capi 引入。
+from .catalog import (
+    ConnectorRegistry,
+    ExpertPage,
+    ExpertRegistry,
+    ListConnectorsOpts,
+    ListExpertsOpts,
+    ListSkillsOpts,
+    SkillPage,
+    SkillRegistry,
+)
+from .client import CreateAgentOpts, ManagedAgentClient
+from .errors import (
+    AcpAuthError,
+    AcpNetworkError,
+    AcpProtocolError,
+    AuthError,
+    CapiError,
+    CapiErrorType,
+    CloudAgentError,
+    ConflictError,
+    InvalidRequestError,
+    NetworkError,
+    NotFoundError,
+    PermissionDeniedError,
+    RateLimitError,
+    ServerError,
+    ServiceUnavailableError,
+    TimeoutError,
+    ValidationError,
+)
+from .external_agent import (
+    A2ASkill,
+    AgentExternalAgents,
+    BindExternalAgentOpts,
+    BindResult,
+    ExternalAgentBound,
+    ListExternalAgentsOpts,
+    UnbindExternalAgentOpts,
+    UnbindResult,
+    is_bound,
+)
+from .manifest import (
+    MANIFEST_VERSION,
+    ExpertRefInput,
+    ManifestBuilder,
+    ManifestExpertRef,
+    ManifestRefType,
+    ManifestSkillRef,
+    SkillRefInput,
+)
+from .opts import (
+    DEFAULT_API_VERSION,
+    DEFAULT_ENDPOINT,
+    DEFAULT_REGION,
+    DEFAULT_TIMEOUT_MS,
+    MAX_PAGE_LIMIT,
+    AgentListOpts,
+    AgentSortBy,
+    ClientOpts,
+    ConnectOpts,
+    Credentials,
+    Filter,
+    Language,
+    Logger,
+    LogLevel,
+    Page,
+    PageOpts,
+    RequestOpts,
+    SessionListOpts,
+    SessionSortBy,
+    SortDirection,
+)
+from .session import MessageListOpts, PromptOpts, Session
+from .types import (
+    A2AConfig,
+    A2ASkillItem,
+    A2AStatus,
+    AgentInfo,
+    AgentListItem,
+    AgentVersionItem,
+    BuiltinModel,
+    ChatEndpointItem,
+    ConnectorAuthMode,
+    ConnectorItem,
+    ConnectorSource,
+    ConnectorStatus,
+    ConnectorType,
+    EnabledStatus,
+    ExpertCounts,
+    ExpertItem,
+    ExpertSource,
+    ExternalAgentInfo,
+    Message,
+    MessageEvent,
+    MessageEventType,
+    PublishStatus,
+    RoutingItem,
+    SessionInfo,
+    SessionItem,
+    SessionSource,
+    SessionStatus,
+    SkillCounts,
+    SkillItem,
+    SkillSource,
+    TokenUsage,
+    ToolCall,
+    ToolCallStatus,
+    VersionInfo,
+    VersionStatus,
+    VersionType,
+)
+from .version import (
+    CreateVersionFromSourceOpts,
+    CreateVersionOpts,
+    UpdateVersionOpts,
+    Version,
+)
+
+__all__ = [
+    "__version__",
+    # ── ACP 协议类型（数据面）────────────────────────────────
+    "ContentBlock",
+    "TextContent",
+    "ImageContent",
+    "AudioContent",
+    "ResourceLink",
+    "EmbeddedResource",
+    "PromptResponse",
+    "SessionNotification",
+    "AcpConnectionState",
+    "NotificationListener",
+    # session.connect() 的入参（Node 版叫 ConnectOpts）
+    "ConnectOpts",
+    # ── 入口 ────────────────────────────────
+    "ManagedAgentClient",
+    # ── 领域对象 ────────────────────────────────
+    "Agent",
+    "AgentVersions",
+    "AgentSessions",
+    "AgentA2A",
+    "AgentExternalAgents",
+    "is_bound",
+    "ConnectorRegistry",
+    "SkillRegistry",
+    "ExpertRegistry",
+    "Session",
+    "Version",
+    "ManifestBuilder",
+    "OneIdCredentialProvider",
+    "ChatCredentialProvider",
+    # ── 入参 ────────────────────────────────
+    "CreateAgentOpts",
+    "UpdateAgentOpts",
+    "CreateSessionOpts",
+    "UpdateA2AOpts",
+    "CreateVersionOpts",
+    "CreateVersionFromSourceOpts",
+    "UpdateVersionOpts",
+    "MessageListOpts",
+    "PromptOpts",
+    "A2ASkill",
+    "ListConnectorsOpts",
+    "ListSkillsOpts",
+    "ListExpertsOpts",
+    "ManifestSkillRef",
+    "ManifestExpertRef",
+    "ManifestRefType",
+    "SkillRefInput",
+    "ExpertRefInput",
+    # ── 出参 ────────────────────────────────
+    "AgentInfo",
+    "AgentListItem",
+    "BuiltinModel",
+    "VersionInfo",
+    "AgentVersionItem",
+    "SessionInfo",
+    "ChatEndpointItem",
+    "SessionItem",
+    "MessageEvent",
+    "Message",
+    "ToolCall",
+    "TokenUsage",
+    "ExternalAgentInfo",
+    "A2ASkillItem",
+    "A2AConfig",
+    "RoutingItem",
+    "BindResult",
+    "UnbindResult",
+    "ExternalAgentBound",
+    "ListExternalAgentsOpts",
+    "BindExternalAgentOpts",
+    "UnbindExternalAgentOpts",
+    # 目录资源出参
+    "ConnectorItem",
+    "SkillItem",
+    "SkillCounts",
+    "SkillPage",
+    "ExpertItem",
+    "ExpertCounts",
+    "ExpertPage",
+    # ── 枚举 ────────────────────────────────
+    "VersionType",
+    "VersionStatus",
+    "SessionStatus",
+    "SessionSource",
+    "A2AStatus",
+    "MessageEventType",
+    "ToolCallStatus",
+    "CapiErrorType",
+    "AgentSortBy",
+    "SessionSortBy",
+    "SortDirection",
+    "SkillSource",
+    "ExpertSource",
+    "PublishStatus",
+    "EnabledStatus",
+    "ConnectorStatus",
+    "ConnectorSource",
+    "ConnectorType",
+    "ConnectorAuthMode",
+    # ── 配置 ────────────────────────────────
+    "ClientOpts",
+    "RequestOpts",
+    "PageOpts",
+    "AgentListOpts",
+    "SessionListOpts",
+    "Page",
+    "Filter",
+    "Credentials",
+    "Logger",
+    "LogLevel",
+    "Language",
+    # ── 错误 ────────────────────────────────
+    "CloudAgentError",
+    "ValidationError",
+    "TimeoutError",
+    "CapiError",
+    "InvalidRequestError",
+    "AuthError",
+    "PermissionDeniedError",
+    "NotFoundError",
+    "ConflictError",
+    "RateLimitError",
+    "ServerError",
+    "ServiceUnavailableError",
+    "NetworkError",
+    "AcpAuthError",
+    "AcpNetworkError",
+    "AcpProtocolError",
+    # ── 常量与工具 ────────────────────────────────
+    "DEFAULT_ENDPOINT",
+    "DEFAULT_API_VERSION",
+    "DEFAULT_REGION",
+    "DEFAULT_TIMEOUT_MS",
+    "MAX_PAGE_LIMIT",
+    "MANIFEST_VERSION",
+]

managed_agent_sdk/_generated/__init__.py

@@ -0,0 +1,8 @@
+"""由 scripts/codegen.py 从 spec/ 生成。请勿手改 —— 改 spec/ 后跑 `pnpm codegen`。"""
+
+from __future__ import annotations
+
+from .actions import *  # noqa: F403
+from .defaults import *  # noqa: F403
+from .enums import *  # noqa: F403
+from .types import *  # noqa: F403