Computer-Use Agents API
Run and manage H Company's Computer-Use Agents from any MCP client.
我该使用它吗
质量与安全性
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"hai-agents": {
"url": "https://agp.hcompany.ai/mcp"
}
}
}远程端点
https://agp.hcompany.ai/mcpstreamable-httphttps://agp.eu.hcompany.ai/mcpstreamable-http它能做什么
工具清单
工具（9）
🟢run_agent(task, agent, max_steps, max_time_s, idempotency_key)
Start an agent on a task; return the answer or a session handle to wait on. ``agent`` from list_agents.
输入模式
{
"type": "object",
"properties": {
"task": {
"type": "string"
},
"agent": {
"type": "string"
},
"max_steps": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"max_time_s": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null
},
"idempotency_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"task",
"agent"
]
}输出模式
{
"type": "object",
"additionalProperties": true
}⚪wait_for_session(session_id, wait)
Poll a session: with ``wait`` long-poll for the answer, else return the current snapshot.
输入模式
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
},
"wait": {
"default": true,
"type": "boolean"
}
},
"required": [
"session_id"
]
}输出模式
{
"type": "object",
"additionalProperties": true
}🟢list_agents(page, size)
List agents the caller can run: their org's agents plus the public ``h/`` ones.
输入模式
{
"type": "object",
"properties": {
"page": {
"default": 1,
"type": "integer"
},
"size": {
"default": 20,
"type": "integer"
}
}
}输出模式
{
"type": "object",
"additionalProperties": true
}🟡send_message(session_id, message)
Send a follow-up message to a running session.
输入模式
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"session_id",
"message"
]
}输出模式
{
"type": "object",
"additionalProperties": {
"type": "string"
}
}🔴cancel_session(session_id)
Cancel a session; a no-op if it does not exist or already finished.
输入模式
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
}
},
"required": [
"session_id"
]
}输出模式
{
"type": "object",
"additionalProperties": {
"type": "string"
}
}⚪share_session(session_id)
Make a session publicly readable and return its absolute share URL.
输入模式
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
}
},
"required": [
"session_id"
]
}输出模式
{
"type": "object",
"additionalProperties": {
"type": "string"
}
}🟡list_files(session_id, path, max_entries, modified_before, name_after)
List files on a browser session's machine (e.g. downloads), newest first. ``session_id`` is the browser session id issued by env-manager when the session was created, not the id ``run_agent`` returns. When a listing is truncated, page on the last entry's modified_at (ISO-8601) and name, passed as modified_before and name_after. Send both: modification times are not unique, and a timestamp alone skips the rest of a tied group.
输入模式
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
},
"path": {
"default": "~/Downloads",
"type": "string"
},
"max_entries": {
"default": 500,
"type": "integer"
},
"modified_before": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"name_after": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"session_id"
]
}输出模式
{
"type": "object",
"additionalProperties": true
}🟢read_file(session_id, path)
Read a file from a browser session's machine; returns base64 content and metadata. ``session_id`` is the browser session id issued by env-manager when the session was created, not the id ``run_agent`` returns.
输入模式
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
},
"path": {
"type": "string"
}
},
"required": [
"session_id",
"path"
]
}输出模式
{
"type": "object",
"additionalProperties": true
}🟡write_file(session_id, path, content_base64)
Write base64-encoded content to a file on a browser session's machine. ``session_id`` is the browser session id issued by env-manager when the session was created, not the id ``run_agent`` returns.
输入模式
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
},
"path": {
"type": "string"
},
"content_base64": {
"type": "string"
}
},
"required": [
"session_id",
"path",
"content_base64"
]
}输出模式
{
"type": "object",
"additionalProperties": true
}社区
证据