SuperAPI AI 工具集

agent-canvas-environment

智能体与模型

查看项目

更新于 10-16 03:11

技能介绍

用途:当运行在本地 Agent Canvas 栈内或旁边时使用,适合检查本地后端、创建或监控本地会话、把工作委派给另一个本地会话。

主要能力与规则:本地后端视为 agent-server API,通常为 http://localhost:8001;本地 UI 为独立前端,通常为 http://localhost:8000。不要打印会话 API 密钥,直接通过 X-Session-API-Key 传递。运行时服务块或用户显式提供的主机优先于默认端口。改动仓库前先执行 git status -sb,若工作树有无关改动,改用独立 worktree 或 clone。委派时提示词需自包含,新会话不继承当前聊天上下文。

用法:会话密钥按 SESSION_API_KEY、OH_SESSION_API_KEYS_0、LOCAL_BACKEND_API_KEY 顺序取第一个,或读取 $HOME/.openhands/agent-canvas/api-key.txt。用 curl 请求 /api/conversations/search 验证后端,HTTP 200 表示可用。委派用 POST /api/conversations:推荐从带 X-Expose-Secrets: encrypted 的 GET /api/settings 取得加密 agent_settings(含 Fernet 加密的 llm.api_key),删除 schema_version 与 mcp_config,合并 exec 工具集与 load_*_skills 标志,并设 secrets_encrypted: true。也可仅传 agent_profile_id,但该方式不含工具。创建后检查 execution_status、工具列表与 ConversationErrorEvent。

限制:默认 /api/settings 会把凭据掩码为 "*********",直接转发会导致 LLMAuthenticationError;不要直接读取 ~/.openhands/profiles/.json。若配置的 MCP 服务器不可达,创建会话可能因 MCP Connection Failure 失败。