MobileOPS Managed Agent Python SDK

Server-side Python SDK for the MobileOPS Managed Agent API.

The SDK exposes five surfaces:

• client.agent wraps the LangGraph runtime client and exposes the supported Assistant CRUD methods at client.agent.assistants.
• client.files exposes MobileOPS Sandbox Workspace file routes.
• client.resources manages Context Hub resources, versions, and latest-version files.
• client.vaults manages credential vaults and their write-only credentials.
• client.sandbox_profiles manages sandbox profiles (运行环境).

Assistant create and update retain LangGraph's ordinary arguments, while persisted configuration is exposed through product fields. Pass response_schema to persist a Draft 2020-12 object schema, read the Run's validated result from final state structured_response, and pass response_schema=None on update to clear it.

Note: the Agent Server freezes the Assistant config into each Thread at creation, and that frozen copy takes precedence over the Assistant's current config on later Runs. Setting, changing, or clearing response_schema therefore only affects Runs started on new Threads; existing Threads keep the schema captured at their creation.

import os

from mobileops_managed_agent import MobileOpsManagedAgentClient

client = MobileOpsManagedAgentClient(api_url=api_url, api_key=api_key)

thread = await client.agent.threads.create()
await client.agent.runs.create(thread["thread_id"], assistant_id, input=input)

skill = await client.resources.create("skills", zip_bytes)  # slug inferred
profile = await client.sandbox_profiles.create(
    name="prod",
    spec={"network": {"allow": ["*.example.com"]}},
)
vault = await client.vaults.create(name="prod")
await client.vaults.credentials.create(
    vault["id"],
    name="GRAFANA_TOKEN",
    value=os.environ["GRAFANA_TOKEN"],
    allowed_hosts=["grafana.example.com"],
)
assistant = await client.agent.assistants.create(
    name="Operations agent",
    skills=[{
        "ref": skill["ref"],  # e.g. incident-response@sha256-…
        "target_path": "/workspace/skills",  # zip already contains {slug}/
    }],
    sandbox_profile=profile["id"],
    credential_vault=vault["id"],
)

await client.resources.versions.create("skills", skill["slug"], next_zip_bytes)
await client.resources.files.list("skills", skill["slug"])
await client.files.list(thread["thread_id"], "/workspace")

Keep MobileOPS Managed Agent API keys in server-side code only.