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
}커뮤니티
증거