배포
배포 생성
BetaManagedAgentsDeployment beta().deployments().create(params, requestOptions = RequestOptions.none())배포 나열
DeploymentListPage beta().deployments().list(params = DeploymentListParams.none(), requestOptions = RequestOptions.none())배포 가져오기
BetaManagedAgentsDeployment beta().deployments().retrieve(params = DeploymentRetrieveParams.none(), requestOptions = RequestOptions.none())배포 업데이트
BetaManagedAgentsDeployment beta().deployments().update(params = DeploymentUpdateParams.none(), requestOptions = RequestOptions.none())배포 보관
BetaManagedAgentsDeployment beta().deployments().archive(params = DeploymentArchiveParams.none(), requestOptions = RequestOptions.none())지금 배포 실행
BetaManagedAgentsDeploymentRun beta().deployments().run(params = DeploymentRunParams.none(), requestOptions = RequestOptions.none())배포 일시 중지
BetaManagedAgentsDeployment beta().deployments().pause(params = DeploymentPauseParams.none(), requestOptions = RequestOptions.none())배포 일시 중지 해제
BetaManagedAgentsDeployment beta().deployments().unpause(params = DeploymentUnpauseParams.none(), requestOptions = RequestOptions.none())Models
class BetaManagedAgentsAgentArchivedDeploymentPausedReasonError { type; }The deployment's agent was archived.
The deployment's agent was archived.
class BetaManagedAgentsCronSchedule { type; expression; timezone; /* 2 more */ }5-field POSIX cron schedule with computed runtime timestamps.
5-field POSIX cron schedule with computed runtime timestamps.
String expression5-field POSIX cron expression: minute hour day-of-month month day-of-week (e.g., "0 9 * * 1-5" for weekdays at 9am). Day-of-week is 0-7 where 0 and 7 both mean Sunday. Extended cron syntax - seconds or year fields, and the special characters L, W, #, and ? - is not supported, nor are predefined shortcuts (@daily).
5-field POSIX cron expression: minute hour day-of-month month day-of-week (e.g., "0 9 * * 1-5" for weekdays at 9am). Day-of-week is 0-7 where 0 and 7 both mean Sunday. Extended cron syntax - seconds or year fields, and the special characters L, W, #, and ? - is not supported, nor are predefined shortcuts (@daily).
String timezoneIANA timezone identifier (e.g., "America/Los_Angeles", "UTC").
IANA timezone identifier (e.g., "America/Los_Angeles", "UTC").
Optional<LocalDateTime> lastRunAtTime the most recent scheduled run actually started. Null until one completes; preserved after the deployment is archived. Manual runs do not update this.
Time the most recent scheduled run actually started. Null until one completes; preserved after the deployment is archived. Manual runs do not update this.
Up to 5 timestamps of upcoming cron occurrences. Non-empty for active and paused deployments (reflects what the schedule would do if unpaused); empty once the deployment is archived (archived_at set). Each fire is offset by a small per-schedule jitter, so a run will actually start at or shortly after its listed time.
class BetaManagedAgentsCronScheduleParams { type; expression; timezone; }5-field POSIX cron schedule. Literal wall-clock matching in the configured timezone.
5-field POSIX cron schedule. Literal wall-clock matching in the configured timezone.
String expression5-field POSIX cron expression: minute hour day-of-month month day-of-week (e.g., "0 9 * * 1-5" for weekdays at 9am). Day-of-week is 0-7 where 0 and 7 both mean Sunday. Extended cron syntax - seconds or year fields, and the special characters L, W, #, and ? - is not supported, nor are predefined shortcuts (@daily).
5-field POSIX cron expression: minute hour day-of-month month day-of-week (e.g., "0 9 * * 1-5" for weekdays at 9am). Day-of-week is 0-7 where 0 and 7 both mean Sunday. Extended cron syntax - seconds or year fields, and the special characters L, W, #, and ? - is not supported, nor are predefined shortcuts (@daily).
String timezoneRequired. IANA timezone identifier (e.g., "America/Los_Angeles", "UTC"). Validated against the IANA timezone database.
Required. IANA timezone identifier (e.g., "America/Los_Angeles", "UTC"). Validated against the IANA timezone database.
class BetaManagedAgentsDeployment { type; id; agent; /* 14 more */ }A deployment is a configured instance of an agent — it binds the agent to everything needed to run it autonomously: an environment, credentials, initial events, and an optional schedule.
A deployment is a configured instance of an agent — it binds the agent to everything needed to run it autonomously: an environment, credentials, initial events, and an optional schedule.
class BetaManagedAgentsDeploymentInitialEvent: unionAn event sent to a session immediately after it is created. Supports user.message, user.define_outcome, and system.message.
An event sent to a session immediately after it is created. Supports user.message, user.define_outcome, and system.message.
class BetaManagedAgentsDeploymentInitialEventParams: unionAn event sent to a session immediately after it is created. Supports user.message, user.define_outcome, and system.message.
An event sent to a session immediately after it is created. Supports user.message, user.define_outcome, and system.message.
class BetaManagedAgentsDeploymentPausedReason: unionWhy a deployment is paused. Non-null exactly when status is paused.
Why a deployment is paused. Non-null exactly when status is paused.
class BetaManagedAgentsManualDeploymentPausedReason { type; }The caller invoked the pause endpoint on the deployment.
The caller invoked the pause endpoint on the deployment.
class BetaManagedAgentsErrorDeploymentPausedReason { type; error; }A scheduled fire recorded a failed run whose error auto-pauses the deployment.
A scheduled fire recorded a failed run whose error auto-pauses the deployment.
The failed run's error.
The failed run's error.
class BetaManagedAgentsDeploymentPausedReasonError: unionThe error that triggered an auto-pause. Matches the failed run's error.type.
The error that triggered an auto-pause. Matches the failed run's error.type.
enum BetaManagedAgentsDeploymentStatusLifecycle status of a deployment.
Lifecycle status of a deployment.
The deployment is active and can run sessions. Archived deployments also report this status; check archived_at to distinguish them.
The deployment is paused. Autonomous triggers are suppressed; manual runs are still permitted.
class BetaManagedAgentsDeploymentSystemMessageEvent { type; content; }Privileged context for the accompanying turn and all subsequent turns, appended to the session's system context as a role: "system" turn rather than replacing the top-level system prompt.
Privileged context for the accompanying turn and all subsequent turns, appended to the session's system context as a role: "system" turn rather than replacing the top-level system prompt.
List<BetaManagedAgentsSystemContentBlock> contentSystem content blocks to append. Text-only.
System content blocks to append. Text-only.
String textThe text content.
The text content.
class BetaManagedAgentsDeploymentUserDefineOutcomeEvent { type; description; rubric; maxIterations; }An outcome the agent should work toward. The agent begins work on receipt.
An outcome the agent should work toward. The agent begins work on receipt.
What the agent should produce. This is the task specification.
Rubric rubricHow to grade the outcome. Text or file reference.
How to grade the outcome. Text or file reference.
class BetaManagedAgentsFileRubric { type; fileId; }Rubric referenced by a file uploaded via the Files API.
Rubric referenced by a file uploaded via the Files API.
ID of the rubric file.
class BetaManagedAgentsTextRubric { type; content; }Rubric content provided inline as text.
Rubric content provided inline as text.
Rubric content. Plain text or markdown — the grader treats it as freeform text.
Optional<Long> maxIterationsEval→revision cycles before giving up. Default 3, max 20.
Eval→revision cycles before giving up. Default 3, max 20.
class BetaManagedAgentsDeploymentUserMessageEvent { type; content; }A user message sent to the session.
A user message sent to the session.
List<Content> contentArray of content blocks for the user message.
Array of content blocks for the user message.
class BetaManagedAgentsTextBlock { type; text; }Regular text content.
Regular text content.
String textThe text content.
The text content.
class BetaManagedAgentsImageBlock { type; source; }Image content specified directly as base64 data or as a reference via a URL.
Image content specified directly as base64 data or as a reference via a URL.
class BetaManagedAgentsDocumentBlock { type; source; context; title; }Document content, either specified directly as base64 data, as text, or as a reference via a URL.
Document content, either specified directly as base64 data, as text, or as a reference via a URL.
class BetaManagedAgentsRedactedBlock { type; }Placeholder for content withheld by Anthropic model policy.
Placeholder for content withheld by Anthropic model policy.
class BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError { type; }The deployment's environment was archived.
The deployment's environment was archived.
class BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError { type; }The deployment's environment no longer exists.
The deployment's environment no longer exists.
class BetaManagedAgentsErrorDeploymentPausedReason { type; error; }A scheduled fire recorded a failed run whose error auto-pauses the deployment.
A scheduled fire recorded a failed run whose error auto-pauses the deployment.
The failed run's error.
The failed run's error.
class BetaManagedAgentsFileNotFoundDeploymentPausedReasonError { type; }A file resource referenced by the deployment no longer exists.
A file resource referenced by the deployment no longer exists.
class BetaManagedAgentsFileResourceConfig { type; fileId; mountPath; }A file mounted into each session's container.
A file mounted into each session's container.
ID of a previously uploaded file.
Mount path in the container. Defaults to /mnt/session/uploads/<file_id>.
class BetaManagedAgentsGitHubRepositoryResourceConfig { type; url; checkout; mountPath; }A GitHub repository mounted into each session's container. The authorization token is write-only and never returned.
A GitHub repository mounted into each session's container. The authorization token is write-only and never returned.
Github URL of the repository
Optional<Checkout> checkoutBranch or commit to check out. Defaults to the repository's default branch.
Branch or commit to check out. Defaults to the repository's default branch.
class BetaManagedAgentsBranchCheckout { type; name; }
String nameBranch name to check out.
Branch name to check out.
class BetaManagedAgentsCommitCheckout { type; sha; }
String shaFull commit SHA to check out.
Full commit SHA to check out.
Mount path in the container. Defaults to /workspace/<repo-name>.
class BetaManagedAgentsManualDeploymentPausedReason { type; }The caller invoked the pause endpoint on the deployment.
The caller invoked the pause endpoint on the deployment.
class BetaManagedAgentsMcpEgressBlockedDeploymentPausedReasonError { type; }An MCP server host used by the deployment's agent is blocked by the environment's network policy.
An MCP server host used by the deployment's agent is blocked by the environment's network policy.
class BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError { type; }A memory store referenced by the deployment is archived.
A memory store referenced by the deployment is archived.
class BetaManagedAgentsMemoryStoreResourceConfig { type; memoryStoreId; access; instructions; }A memory store attached to each session created from this deployment.
A memory store attached to each session created from this deployment.
The memory store ID (memstore_...). Must belong to the caller's organization and workspace.
Optional<Access> accessAccess mode for the mounted store. Defaults to read_write. read_only mounts the store as a read-only filesystem.
Access mode for the mounted store. Defaults to read_write. read_only mounts the store as a read-only filesystem.
Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.
class BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError { type; }The deployment's organization is disabled.
The deployment's organization is disabled.
class BetaManagedAgentsSchedule { type; expression; timezone; /* 2 more */ }A recurring schedule with computed runtime timestamps. Discriminated union — only cron is supported currently.
A recurring schedule with computed runtime timestamps. Discriminated union — only cron is supported currently.
String expression5-field POSIX cron expression: minute hour day-of-month month day-of-week (e.g., "0 9 * * 1-5" for weekdays at 9am). Day-of-week is 0-7 where 0 and 7 both mean Sunday. Extended cron syntax - seconds or year fields, and the special characters L, W, #, and ? - is not supported, nor are predefined shortcuts (@daily).
5-field POSIX cron expression: minute hour day-of-month month day-of-week (e.g., "0 9 * * 1-5" for weekdays at 9am). Day-of-week is 0-7 where 0 and 7 both mean Sunday. Extended cron syntax - seconds or year fields, and the special characters L, W, #, and ? - is not supported, nor are predefined shortcuts (@daily).
String timezoneIANA timezone identifier (e.g., "America/Los_Angeles", "UTC").
IANA timezone identifier (e.g., "America/Los_Angeles", "UTC").
Optional<LocalDateTime> lastRunAtTime the most recent scheduled run actually started. Null until one completes; preserved after the deployment is archived. Manual runs do not update this.
Time the most recent scheduled run actually started. Null until one completes; preserved after the deployment is archived. Manual runs do not update this.
Up to 5 timestamps of upcoming cron occurrences. Non-empty for active and paused deployments (reflects what the schedule would do if unpaused); empty once the deployment is archived (archived_at set). Each fire is offset by a small per-schedule jitter, so a run will actually start at or shortly after its listed time.
class BetaManagedAgentsScheduleParams { type; expression; timezone; }A recurring schedule. Discriminated union — only cron is supported currently.
A recurring schedule. Discriminated union — only cron is supported currently.
String expression5-field POSIX cron expression: minute hour day-of-month month day-of-week (e.g., "0 9 * * 1-5" for weekdays at 9am). Day-of-week is 0-7 where 0 and 7 both mean Sunday. Extended cron syntax - seconds or year fields, and the special characters L, W, #, and ? - is not supported, nor are predefined shortcuts (@daily).
5-field POSIX cron expression: minute hour day-of-month month day-of-week (e.g., "0 9 * * 1-5" for weekdays at 9am). Day-of-week is 0-7 where 0 and 7 both mean Sunday. Extended cron syntax - seconds or year fields, and the special characters L, W, #, and ? - is not supported, nor are predefined shortcuts (@daily).
String timezoneRequired. IANA timezone identifier (e.g., "America/Los_Angeles", "UTC"). Validated against the IANA timezone database.
Required. IANA timezone identifier (e.g., "America/Los_Angeles", "UTC"). Validated against the IANA timezone database.
class BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError { type; }The deployment configures resources, but its environment is self-hosted and cannot mount them.
The deployment configures resources, but its environment is self-hosted and cannot mount them.
class BetaManagedAgentsSessionResourceConfig: unionA configured session resource. Echoes the input minus write-only credentials.
A configured session resource. Echoes the input minus write-only credentials.
class BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError { type; }A referenced resource no longer exists and its kind was not reported.
A referenced resource no longer exists and its kind was not reported.
class BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError { type; }A skill referenced by the deployment's agent no longer exists.
A skill referenced by the deployment's agent no longer exists.
class BetaManagedAgentsUnknownDeploymentPausedReasonError { type; }An unrecognized error auto-paused the deployment. A fallback variant; matches a run whose error.type is unknown_error.
An unrecognized error auto-paused the deployment. A fallback variant; matches a run whose error.type is unknown_error.
class BetaManagedAgentsVaultArchivedDeploymentPausedReasonError { type; }A vault referenced by the deployment is archived.
A vault referenced by the deployment is archived.
class BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError { type; }A vault referenced by the deployment no longer exists.
A vault referenced by the deployment no longer exists.
class BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError { type; }The deployment's workspace was archived.
The deployment's workspace was archived.