Agent Space API怎么用于自动化任务-人工智能-PHP中文网

必须先在agentspace ui中发布agent并启用api访问，才能调用其api；未发布则返回404或403。发布后获取api key，构造含task和input字段的json请求，用curl或python提交，通过轮询或webhook监听结果。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

agent space api怎么用于自动化任务

要让 AgentSpace 的 API 真正驱动业务自动化任务，不是把接口文档抄一遍就能跑起来——它需要你先在 UI 里完成 Agent 的行为定义、权限绑定和工具连接，API 才能安全地触发那个“已配置好”的执行单元。

确认 Agent 已在 AgentSpace UI 中发布为可调用服务

进入 AgentSpace 控制台 → 左侧导航栏点击「Agents」→ 找到目标 Agent（例如“合同审批助手”）→ 点击右侧「Publish」按钮 → 在弹出面板中勾选「Enable API access」→ 点击「Confirm & Publish」。

【必须完成这一步】 否则 API 调用会返回 404 或 403，因为未发布的 Agent 不会生成可用的 endpoint 和 token 绑定关系。

发布成功后，页面自动跳转至「API Details」页，你会看到 Endpoint URL、API Key 和示例 cURL 命令。

获取并安全存储 API Key

在「API Details」页点击「Copy API Key」按钮，将密钥粘贴到你的自动化脚本环境变量中（如 Linux 下写入 ~/.bashrc 的 AGENTSPACE_API_KEY），不要硬编码进 Python 文件或 Git 仓库。

这个 Key 是长期有效的，但一旦泄露，攻击者可冒充该 Agent 调用所有已授权工具（如 Jira 创建工单、ServiceNow 更新状态）。如果怀疑泄漏，立即回到「API Details」页点击「Regenerate Key」。

构造最小可行请求体

AgentSpace API 接收标准 JSON POST 请求，核心字段只有两个：task 和 input。

task 字段值必须严格匹配你在 UI 中为该 Agent 设定的「Task Name」（例如你在设计时填的是 “review_contract_terms”，这里就不能写成 “review-contract-terms” 或 “contract_review”）。

input 字段是纯字典结构，键名必须与你在 UI 中配置的「Input Schema」完全一致。比如你设定了 required: ["contract_id", "reviewer_dept"]，那 input 就只能包含这两个 key，多一个少一个都会被拒绝。

Agent Autopilot.Bak

自驱动代理工作流，采用心跳驱动的任务执行，提供昼夜进度报告和长期记忆整合，并与待办管理系统集成。

下载

用 curl 发起首次测试调用

打开终端，执行以下命令（替换 YOUR_ENDPOINT 和 YOUR_API_KEY）：

curl -X POST YOUR_ENDPOINT \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task": "review_contract_terms", "input": {"contract_id": "CT2026-8842", "reviewer_dept": "legal"}}'

如果返回 HTTP 202 Accepted，且 body 中有 "request_id" 字段，说明请求已被平台接收并进入队列；若返回 422，则检查 input 字段是否拼写错误或缺失必填项。

批量任务：用 Python 脚本循环提交

方法一：直接 requests.post（适合每秒不超过 5 次的小批量）
import requests
import time
api_url = "https://asia-southeast1-aiplatform.googleapis.com/v1/projects/xxx/locations/xxx/agents/xxx:execute"
headers = {"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"}
tasks = [
  {"task": "review_contract_terms", "input": {"contract_id": "CT2026-8842", "reviewer_dept": "legal"}},
  {"task": "review_contract_terms", "input": {"contract_id": "CT2026-8843", "reviewer_dept": "finance"}}
]
for task in tasks:
  resp = requests.post(api_url, headers=headers, json=task)
  print(f"Status: {resp.status_code}, ID: {resp.json().get('request_id')}")
  time.sleep(0.5) # 避免触发平台限流

方法二：用异步 aiohttp（适合单次提交 50+ 任务）
需额外安装 pip install aiohttp；注意 AgentSpace API 不支持 WebSocket 流式响应，所有请求仍是独立 HTTP 短连接。

方法三：通过 Google Cloud Scheduler + Pub/Sub 中转（适合每日定时触发、需审计日志的场景）
先在 Cloud Console 创建 Pub/Sub topic，AgentSpace API 可配置为订阅该 topic；Scheduler 按 cron 规则向 topic 发布消息，由平台自动转换为 execute 请求。

监听执行结果的两种方式

方式1：轮询 GET /v1/requests/{request_id}（最简单，适合调试）
每次调用后拿到 request_id，用 GET 请求该地址，直到 status 字段变为 "COMPLETED" 或 "FAILED"。注意：status 为 "PROCESSING" 时，response body 中不包含 output 字段。

方式2：配置 Webhook 回调（生产环境推荐）
在 AgentSpace UI 的 Agent 编辑页 → 「Advanced Settings」→ 填写你的 HTTPS endpoint（需支持 TLS 1.2+，且域名经公网可解析）→ 选择触发事件（如 on_success、on_failure）→ 保存。平台会在任务结束时向你指定地址发起 POST，payload 包含完整 input、output 和 execution_trace。

Webhook 地址必须返回 HTTP 2xx，否则平台会按指数退避重试最多 3 次；若连续失败，后续回调将被暂停，需手动在 UI 中重新启用。