跳至正文

Agent API 与 Grid / 开发者

构建您的第一个智能体。
从一项边界清晰的任务开始。

申请 Agent API 访问权限,确认已启用的智能体,并在明确预算下运行合成测试任务。下方同时提供 Grid 模型 API 调用示例。

Agent API 与 Grid 访问均采用邀请制。您的账户决定了已启用的服务范围及实际生效费率。

Agent API / 首次运行

委派任务,检查状态,随后审阅结果。

请使用在账户开通期间确认的 API 源地址、Bearer 密钥及已启用的智能体 ID。在发送请求前,请确认该智能体的工具权限与审批策略。本示例使用合成输入数据与示例预算。

  1. 将 FORWARD_AGENT_BASE 设置为所提供的源地址(末尾不带斜杠)。请将 FORWARD_AGENT_KEY 保存在您的服务器或本地环境中。
  2. 按指南所示,使用您已启用的智能体 ID、任务目标与预算创建 first-agent.json 。请在私有目录中使用以下命令运行: umask 077.
  3. 成功的任务委派将返回 HTTP 202。请读取 run_id 与 status 来自 run.json. 请妥善保管返回的凭据与令牌,切勿泄露。
  4. 使用相同的授权信息检查 GET /v1/agent/runs/{run_id} 。在扩大任务范围前,请审阅完成状态、输出结果及资源消耗。
阅读请求体与审批指南 使用 Grid 模型 API
委派智能体运行任务

curl --fail-with-body --silent --show-error \
  -X POST "${FORWARD_AGENT_BASE}/v1/agent/delegate" \
  -H "Authorization: Bearer ${FORWARD_AGENT_KEY}" \
  -H "Content-Type: application/json" \
  --data-binary @first-agent.json \
  --output run.json

仅为模板示例。您的账户决定了实际可用性与生效费率。发送请求可能会产生计费用量;所设预算上限不代表对结果实际成本的估算。

03 / 首次调用

选择您的客户端。
保持使用同一服务端点。

以下示例将从您的环境变量中读取密钥和模型 ID,发送一条对话消息并打印回复。

运行前准备

请使用受邀账户、 FORLEX_API_KEY 以及您已启用模型列表中支持对话的 GRID_MODEL_ID 。

配置访问权限与模型
API 基础地址
https://api.genai.forlex.cloud/v1
提交申请
POST /chat/completions

请求成功即确认访问权限已就绪。至于模型是否契合您的业务工作流,则由您的后续评估决定。

规划评估方案

安装 SDK:python3 -m pip install openai。将示例保存为 first-call.py,然后运行 python3 first-call.py。

first-call.py

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.genai.forlex.cloud/v1",
    api_key=os.environ["FORLEX_API_KEY"],
)

response = client.chat.completions.create(
    model=os.environ["GRID_MODEL_ID"],
    messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)

访问权限与配置

配置您的账户与模型。

Grid 采用邀请制。请将密钥保存在本地环境或服务器配置中,切勿写入浏览器前端代码或版本控制系统。以下示例均使用占位符。

01 / 访问权限与密钥

受邀后,请打开控制台(Console),前往“密钥”(Keys)页面并创建 API 密钥。

设置您的 API 密钥
设置您的 API 密钥

export FORLEX_API_KEY="replace-with-your-key"
打开 Grid 控制台

02 / 已启用的模型

将 FORLEX_API_KEY 。请从您的账户模型列表中选择一个支持对话补全(Chat Completions)的模型,并使用其确切 ID。

列出并选择已启用的模型

在运行首次调用前,请先替换这两个占位符。

列出已启用的模型

curl https://api.genai.forlex.cloud/v1/models \
  -H "Authorization: Bearer ${FORLEX_API_KEY:?Set FORLEX_API_KEY first}"
选择已启用的模型

export GRID_MODEL_ID="replace-with-an-enabled-chat-model-id"
对比公开目录

04 / 为生产环境做准备

理解响应内容,审阅实际成本。

添加错误处理逻辑,衡量实际业务成效,并在控制台中查看资源消耗。与负责生产环境审批的干系人确认数据安全、部署方案及运维要求。

响应故障排查
401 / 403
检查密钥、邀请状态及账户访问权限。已启用模型列表与您的具体账户绑定。
访问权限与密钥
402 / 429
审阅计费状态或请求速率限制。遇到速率限制时请采用退避重试(Backoff);若为计费问题,请先解决计费异常再行重试。
计费与限额
503
空闲的 Serverless 通道可能正在预热启动。如有返回 Retry-After 响应头,请遵循其指示并使用有界重试机制。
错误与冷启动

与您的团队共同推进下一步。

添加安全检测

规划 OpenDetector AI 文本审阅或提示词安全防护,配备独立的检测契约与运行策略。

规划检测服务访问

连接您的编程工具

准备好特定工具的配置方案,随后与团队在限定范围的编程任务上评估固定版本的模型。

准备 Connect 配置

适配模型

在选择 Checkpoint 或训练方法之前,请先明确任务目标、数据就绪度及评估方案。

探索训练服务

申请访问权限

Agent API 与 Grid 访问权限均实行邀请制。具体启用的服务与条款将在入驻引导期间确认。

草稿仅在本次浏览器访问期间保留。刷新页面将清空草稿。

依据我们的 隐私与数据保护声明 (GDPR、LGPD 与 CCPA)进行处理。绝不出售或共享任何个人数据。

联系我们

请告知您的基本信息和需要评估的需求内容。

草稿仅在本次浏览器访问期间保留。刷新页面将清空草稿。

在本次访问期间,每个主题都会保留各自的需求内容。切换主题不会丢失您的联系方式。

依据我们的 隐私与数据保护声明 (GDPR、LGPD 与 CCPA)进行处理。绝不出售或共享任何个人数据。

[隐私与遥测控制]

数据保护与遥测偏好设置

Forward Intelligence (国际业务由 Forlex, LLC 运营,巴西业务由 Forlex Ltda运营) 尊重您在欧盟/英国 GDPR、巴西 LGPD(Lei nº 13.709/2018)以及加利福尼亚州 CCPA/CPRA 下享有的权利。

严格必要的存储始终启用

在您的浏览器本地存储颜色主题 (grid-theme)、文档导航状态以及您的隐私偏好设置 (fwdi_privacy_consent_v1)。不会设置任何第三方 Cookie 或跨站追踪器。

语言选择器仅将您的语言偏好保存在第一方 Cookie (fwdi-language) 中,有效期最长为一年。这不会启用任何可选的分析功能。

脱敏路由与漏斗分析已禁用

收集列入白名单的营销路由上的汇总页面浏览量及粗粒度商业漏斗事件,采集工具为 @vercel/analytics。查询字符串、动态路径和个人数据在发送前均会在客户端进行脱敏处理。

阅读完整的 GDPR / LGPD / CCPA 声明