确认 worker - Open Managed Agents

POST

/

v1

/

environments

/

{environment_id}

/

work

/

{work_id}

/

ack

确认 worker

curl --request POST \
  --url http://localhost:38080/v1/environments/{environment_id}/work/{work_id}/ack \
  --header 'X-Api-Key: <api-key>'

import requests

url = "http://localhost:38080/v1/environments/{environment_id}/work/{work_id}/ack"

headers = {"X-Api-Key": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {'X-Api-Key': '<api-key>'}};

fetch('http://localhost:38080/v1/environments/{environment_id}/work/{work_id}/ack', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "http://localhost:38080/v1/environments/{environment_id}/work/{work_id}/ack"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("X-Api-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "acknowledged_at": "<string>",
  "created_at": "<string>",
  "data": {
    "id": "<string>",
    "type": "session"
  },
  "environment_id": "<string>",
  "id": "<string>",
  "latest_heartbeat_at": "<string>",
  "metadata": {},
  "secret": "<string>",
  "started_at": "<string>",
  "state": "queued",
  "stop_requested_at": "<string>",
  "stopped_at": "<string>",
  "type": "work"
}

{
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  },
  "request_id": "<string>",
  "type": "error"
}

每个请求都必须发送 ?beta=true。

授权

X-Api-Key

string

header

默认值:sk-ant-local-default

必填

OMA 工作区 API 密钥。

请求头

anthropic-beta

string

用于指定要使用的 beta 版本的可选请求头。

要使用多个 beta，请使用逗号分隔的列表（如 beta1,beta2），或为每个 beta 分别指定该请求头。

anthropic-version

string

你想使用的 OMA API 版本。

在此处阅读更多关于版本控制和我们版本历史的信息。

authorization

string | null

路径参数

environment_id

string

必填

work_id

string

必填

查询参数

beta

enum<boolean>

必填

为此接口启用 Beta API 合同，必须为 true。

可用选项:

true

响应

成功的响应

表示自托管环境中一个工作单元的 worker。

woker 在创建会话时，或长期休眠的会话收到新消息时进入队列。环境 worker 会轮询待执行的 worker，并在自托管沙箱中执行。

acknowledged_at

string | null

必填

该 worker 被确认接收并分配给自托管 sandbox 时的 RFC 3339 时间戳

created_at

string

必填

创建 worker 时的 RFC 3339 时间戳

data

SessionWorkData · object

必填

实际要执行的 worker

Show child attributes

environment_id

string

必填

此 worker 所属的环境标识符（例如 env_...）

id

string

必填

worker 标识符（例如 'work_...'）

latest_heartbeat_at

string | null

必填

最近一次心跳的 RFC 3339 时间戳

metadata

元数据 · object

必填

与此 worker 关联的用户提供的元数据键值对

Show child attributes

secret

string | null

必填

环境 worker 用于执行此 worker 的凭据载荷。轮询 worker 时可能填充该字段；其他所有获取路径上均为 null。

started_at

string | null

必填

worker 执行开始的 RFC 3339 时间戳

state

enum<string>

必填

worker 的当前状态

可用选项:

queued,

starting,

active,

stopping,

stopped

stop_requested_at

string | null

必填

请求停止时的 RFC 3339 时间戳

stopped_at

string | null

必填

worker 执行停止的 RFC 3339 时间戳

type

string

默认值:work

必填

对象类型（始终为 'work'）

Allowed value: "work"

确认 worker

curl --request POST \
  --url http://localhost:38080/v1/environments/{environment_id}/work/{work_id}/ack \
  --header 'X-Api-Key: <api-key>'

import requests

url = "http://localhost:38080/v1/environments/{environment_id}/work/{work_id}/ack"

headers = {"X-Api-Key": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {'X-Api-Key': '<api-key>'}};

fetch('http://localhost:38080/v1/environments/{environment_id}/work/{work_id}/ack', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "http://localhost:38080/v1/environments/{environment_id}/work/{work_id}/ack"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("X-Api-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "acknowledged_at": "<string>",
  "created_at": "<string>",
  "data": {
    "id": "<string>",
    "type": "session"
  },
  "environment_id": "<string>",
  "id": "<string>",
  "latest_heartbeat_at": "<string>",
  "metadata": {},
  "secret": "<string>",
  "started_at": "<string>",
  "state": "queued",
  "stop_requested_at": "<string>",
  "stopped_at": "<string>",
  "type": "work"
}

{
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  },
  "request_id": "<string>",
  "type": "error"
}