Computer-Use Agents API
Run and manage H Company's Computer-Use Agents from any MCP client.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"hai-agents": {
"url": "https://agp.hcompany.ai/mcp"
}
}
}Puntos de conexión remotos
https://agp.hcompany.ai/mcpstreamable-httphttps://agp.eu.hcompany.ai/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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.
Esquema de entrada
{
"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"
]
}Esquema de salida
{
"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.
Esquema de entrada
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
},
"wait": {
"default": true,
"type": "boolean"
}
},
"required": [
"session_id"
]
}Esquema de salida
{
"type": "object",
"additionalProperties": true
}🟢list_agents(page, size)
List agents the caller can run: their org's agents plus the public ``h/`` ones.
Esquema de entrada
{
"type": "object",
"properties": {
"page": {
"default": 1,
"type": "integer"
},
"size": {
"default": 20,
"type": "integer"
}
}
}Esquema de salida
{
"type": "object",
"additionalProperties": true
}🟡send_message(session_id, message)
Send a follow-up message to a running session.
Esquema de entrada
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"session_id",
"message"
]
}Esquema de salida
{
"type": "object",
"additionalProperties": {
"type": "string"
}
}🔴cancel_session(session_id)
Cancel a session; a no-op if it does not exist or already finished.
Esquema de entrada
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
}
},
"required": [
"session_id"
]
}Esquema de salida
{
"type": "object",
"additionalProperties": {
"type": "string"
}
}⚪share_session(session_id)
Make a session publicly readable and return its absolute share URL.
Esquema de entrada
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
}
},
"required": [
"session_id"
]
}Esquema de salida
{
"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.
Esquema de entrada
{
"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"
]
}Esquema de salida
{
"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.
Esquema de entrada
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
},
"path": {
"type": "string"
}
},
"required": [
"session_id",
"path"
]
}Esquema de salida
{
"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.
Esquema de entrada
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
},
"path": {
"type": "string"
},
"content_base64": {
"type": "string"
}
},
"required": [
"session_id",
"path",
"content_base64"
]
}Esquema de salida
{
"type": "object",
"additionalProperties": true
}Comunidad
Evidencia