跳转至

provider_runtime

概览

  • 模块：fieldqkit.api.quantum_platform
  • 作用：按 provider 名称创建统一运行时对象，绑定 BackendAdapter 与 TaskAdapter。
  • 入口函数：create_provider_runtime(...)

核心数据结构

ProviderRuntime

@dataclass
class ProviderRuntime:
    provider: str
    backend_adapter: Any
    task_adapter: Any
字段 类型 说明
provider str 标准化 provider 名（小写）。
backend_adapter Any 对应 provider 的后端发现/解析适配器。
task_adapter Any 对应 provider 的任务提交与结果适配器。

工厂函数

create_provider_runtime(*, provider: str, client: Any) -> ProviderRuntime

参数 类型 必填 说明
provider str 是 支持 quafu/tianyan/guodun/tencent/origin/fieldquantum/logicalqubit/simulator。
client Any 是 当前 QuantumHardwareClient 实例（供 task adapter 绑定上下文）。

返回值

按 provider 返回：

  • quafu：QuafuBackendAdapter + QuafuTaskAdapter
  • tianyan：TianYanBackendAdapter + TianYanTaskAdapter
  • guodun：GuoDunBackendAdapter + GuoDunTaskAdapter
  • tencent：TencentBackendAdapter + TencentTaskAdapter
  • origin：OriginBackendAdapter + OriginTaskAdapter
  • fieldquantum：FieldQuantumBackendAdapter + FieldQuantumTaskAdapter（量坤云端模拟器）
  • logicalqubit：LogicalQubitBackendAdapter + LogicalQubitTaskAdapter（逻辑比特量子云，直连 REST）
  • simulator：SimulatorBackendAdapter + task_adapter=None（本地模拟器，无需 token）

异常

  • ValueError("provider must be one of: 'quafu', 'tianyan', 'guodun', 'tencent', 'simulator', 'fieldquantum', 'origin', or 'logicalqubit'")

示例

from fieldqkit.api.quantum_platform import create_provider_runtime
from fieldqkit.api.client import QuantumHardwareClient

client = QuantumHardwareClient()
runtime = create_provider_runtime(provider="quafu", client=client)

print(runtime.provider)
print(type(runtime.backend_adapter).__name__)
print(type(runtime.task_adapter).__name__)

相关页面