Computer-Use Agents API
Run and manage H Company's Computer-Use Agents from any MCP client.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"hai-agents": {
"url": "https://agp.hcompany.ai/mcp"
}
}
}Remote-Endpunkte
https://agp.hcompany.ai/mcpstreamable-httphttps://agp.eu.hcompany.ai/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (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.
Eingabe-Schema
{
"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"
]
}Ausgabe-Schema
{
"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.
Eingabe-Schema
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
},
"wait": {
"default": true,
"type": "boolean"
}
},
"required": [
"session_id"
]
}Ausgabe-Schema
{
"type": "object",
"additionalProperties": true
}🟢list_agents(page, size)
List agents the caller can run: their org's agents plus the public ``h/`` ones.
Eingabe-Schema
{
"type": "object",
"properties": {
"page": {
"default": 1,
"type": "integer"
},
"size": {
"default": 20,
"type": "integer"
}
}
}Ausgabe-Schema
{
"type": "object",
"additionalProperties": true
}🟡send_message(session_id, message)
Send a follow-up message to a running session.
Eingabe-Schema
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"session_id",
"message"
]
}Ausgabe-Schema
{
"type": "object",
"additionalProperties": {
"type": "string"
}
}🔴cancel_session(session_id)
Cancel a session; a no-op if it does not exist or already finished.
Eingabe-Schema
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
}
},
"required": [
"session_id"
]
}Ausgabe-Schema
{
"type": "object",
"additionalProperties": {
"type": "string"
}
}⚪share_session(session_id)
Make a session publicly readable and return its absolute share URL.
Eingabe-Schema
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
}
},
"required": [
"session_id"
]
}Ausgabe-Schema
{
"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.
Eingabe-Schema
{
"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"
]
}Ausgabe-Schema
{
"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.
Eingabe-Schema
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
},
"path": {
"type": "string"
}
},
"required": [
"session_id",
"path"
]
}Ausgabe-Schema
{
"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.
Eingabe-Schema
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
},
"path": {
"type": "string"
},
"content_base64": {
"type": "string"
}
},
"required": [
"session_id",
"path",
"content_base64"
]
}Ausgabe-Schema
{
"type": "object",
"additionalProperties": true
}Community
Nachweis