Añadir detección
Defina el alcance de revisión de texto generado por IA o protección de prompts con OpenDetector, mediante un contrato de detección independiente y una política operativa.
Planificar acceso a detecciónAgent API y Grid / Desarrolladores
Construya su primer agente.
Comience con una tarea acotada.
Solicite acceso a Agent API, confirme un agente habilitado y ejecute una tarea sintética con un presupuesto explícito. Los ejemplos de la API de modelos de Grid están disponibles a continuación.
El acceso a Agent API y Grid es por invitación. Su cuenta determina los servicios habilitados y las tarifas efectivas.
Agent API / Primera ejecución
Delegue, inspeccione y luego revise.
Utilice el origen de API, la clave portadora (Bearer) y el ID de agente habilitado confirmados durante la incorporación. Confirme sus herramientas y su política de aprobación antes de enviar una solicitud. El ejemplo utiliza una entrada sintética y un presupuesto ilustrativo.
- Configure
FORWARD_AGENT_BASEcon el origen proporcionado, sin barra diagonal final. MantengaFORWARD_AGENT_KEYen su servidor o entorno local. - Cree
first-agent.jsoncon su ID de agente habilitado, un objetivo y un presupuesto como se muestra en la guía. Ejecútelo desde un directorio privado conumask 077. - Una delegación exitosa devuelve HTTP 202. Lea
run_idystatusdesderun.json. Mantenga privados los tokens devueltos. - Inspeccione
GET /v1/agent/runs/{run_id}con la misma autorización. Revise la finalización, el resultado y el uso antes de ampliar el alcance.
Delegar una ejecución de agente
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.jsonSolo plantilla. Su cuenta controla la disponibilidad y las tarifas efectivas. Enviar una solicitud puede generar consumo; un presupuesto no es una estimación del costo del resultado.
03 / Primera llamada
Elija su cliente.
Mantenga el mismo endpoint.
Los ejemplos leen la clave y el ID del modelo desde su entorno. Envían un mensaje de chat e imprimen la respuesta.
Antes de ejecutar
Utilice una cuenta invitada, FORLEX_API_KEY y un GRID_MODEL_ID compatible con chat de su lista de modelos habilitados.
- Base de la API
- https://api.genai.forlex.cloud/v1
- Solicitar
- POST /chat/completions
Una solicitud exitosa confirma el acceso. Su evaluación determina si un modelo se ajusta al flujo de trabajo.
Planificar la evaluaciónInstale el SDK: python3 -m pip install openai. Guarde el ejemplo como first-call.py y luego ejecute 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)Acceso y configuración
Configure su cuenta y modelo.
Grid es por invitación. Mantenga su clave en su entorno local o configuración del servidor, fuera del código del navegador y del control de versiones. Los ejemplos utilizan marcadores de posición.
01 / Acceso y clave
Una vez invitado, abra la Consola, vaya a Claves y cree una clave de API.
Configurar su clave de API
Configurar su clave de API
export FORLEX_API_KEY="replace-with-your-key"02 / Modelo habilitado
Configure FORLEX_API_KEY primero. Elija un modelo compatible con completaciones de chat de la lista de su cuenta y utilice su ID exacto.
Listar y seleccionar un modelo habilitado
Reemplace ambos marcadores de posición antes de ejecutar la primera llamada.
Listar modelos habilitados
curl https://api.genai.forlex.cloud/v1/models \
-H "Authorization: Bearer ${FORLEX_API_KEY:?Set FORLEX_API_KEY first}"Elegir un modelo habilitado
export GRID_MODEL_ID="replace-with-an-enabled-chat-model-id"04 / Prepararse para producción
Comprenda la respuesta. Revise el costo.
Añada manejo de errores, mida resultados útiles y verifique el consumo en la Consola. Confirme los requisitos de datos, despliegue y operación con los responsables de aprobar la producción.
Solución de problemas de respuestas
- 401 / 403
- Verifique la clave, la invitación y el acceso de la cuenta. La lista de modelos habilitados es específica de su cuenta.
- Acceso y claves
- 402 / 429
- Revise la facturación o los límites de solicitudes. Utilice retroceso (backoff) para los límites de tasa; resuelva la facturación antes de reintentar.
- Facturación y límites
- 503
- Un carril serverless inactivo puede estar iniciándose. Respete el encabezado Retry-After cuando esté presente y utilice reintentos acotados.
- Errores e inicio en frío
Dé el siguiente paso con su equipo.
Conecte su herramienta de programación
Prepare una configuración específica para la herramienta y luego evalúe un modelo fijado en tareas de programación acotadas con su equipo.
Preparar una configuración de ConnectAdapte un modelo
Defina la tarea, la preparación de los datos y la evaluación antes de elegir un checkpoint o método de entrenamiento.
Explorar entrenamientoEntregar un flujo de trabajo
Aporte el proceso y las integraciones. Definimos el alcance de la evaluación y la implementación con su equipo.
Explorar Proyectos