Computer-Use Agents API
Run and manage H Company's Computer-Use Agents from any MCP client.
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `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
}コミュニティ
エビデンス