必须先获取API密钥并确认Base URL，否则请求返回401或404；密钥格式为gcp-sk-xxxxxxxxxx，需填入Authorization头；Base URL由区域和命名空间决定且大小写敏感；space_id和session_id须准确传递以维持会话状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在项目中正确配置 Agent Space API，必须先获取有效凭证并明确 Base URL，否则所有后续请求都会返回 401 或 404 错误。
获取 API 访问凭证
登录 Google Cloud Console → 进入 AI Applications → 打开目标 AgentSpace → 点击右上角「Settings」→ 在「API Access」标签页中点击「Generate Key」。生成后立即复制保存，该密钥【仅显示一次，关闭页面即不可再查】。
密钥格式为 gcp-sk-xxxxxxxxxx，需填入 Authorization 请求头的 Bearer 后，如：Authorization: Bearer gcp-sk-xxxxxxxxxx。
确认 Base URL 和命名空间
Agent Space API 的 Base URL 不是固定值，它由部署区域和命名空间共同决定。例如：
美国多伦多区域的命名空间 my-agent-prod → Base URL 为 https://us-east1-my-agent-prod.aip.google.com/v1
注意：【Base URL 中的命名空间必须与控制台中创建时完全一致，大小写敏感，且不能含下划线或中文】。填错会导致 404 Not Found，而非认证失败。
可在控制台 AgentSpace 概览页底部的「API Endpoint」字段直接复制完整 Base URL，避免手输错误。
在代码中初始化客户端
方法一：使用官方 Python SDK（推荐）
pip install google-aiplatform
from google.cloud import aiplatform
aiplatform.init(project="your-gcp-project-id", location="us-east1", api_endpoint="us-east1-my-agent-prod.aip.google.com")
client = aiplatform.gapic.AgentSpaceClient()
方法二：手动构造 HTTP 请求（适用于任何语言）
向 {Base URL}/spaces/{space_id}/messages 发起 POST 请求，Header 必须包含：
Content-Type: application/json
Authorization: Bearer gcp-sk-xxxxxxxxxx
space_id 是控制台中 AgentSpace 的唯一标识符，形如 space-abc123xyz，在「Settings」→「General」页最顶部可见。
配置请求参数与会话状态
第一步：发起首次对话请求，携带 system_instruction 字段声明角色意图
POST {Base URL}/spaces/{space_id}/messages
{"messages": [{"role": "user", "content": "今天北京天气如何？"}], "system_instruction": "你是一个企业内部知识助手，只回答与公司政策、IT支持、HR流程相关的问题。"}
第二步：提取响应中的 session_id 字段值（位于 response.session.name，格式如 sessions/abc123-xyz789）
第三步：后续请求必须在 URL 路径中替换 messages 为 sessions/{session_id}/messages，并在 body 中省略 system_instruction —— 否则会触发新会话，丢失上下文。
这一步不能跳过。不传 session_id 就等于每次都是新用户重聊，历史工具调用、记忆缓存、状态变量全部清空。
