Source: docs/integration/prompt-integration-agent-prompt.md

Prompts for AI agents

Two prompts for integrating a form with Forgium Prompt Integrations.

---

Prompt 1 — Setup

The client pastes this into Claude Code alongside their existing form.

Claude analyzes the form and returns an input schema and a suggested prompt.

Analizá este formulario y devolveme:

1. Un JSON Schema con los campos que envía el form (input_schema).
2. Un prompt que procese esos datos y devuelva una respuesta útil.

Formato del input_schema:
- type: "object"
- additionalProperties: false
- required: [campos obligatorios]
- properties: cada campo con type, minLength/maxLength si aplica

Formato del prompt:
- Instrucciones claras para procesar los datos del form
- Que devuelva JSON estructurado
- Que no invente información que no esté en el input

What the client gets back

{
  "input_schema": {
    "type": "object",
    "additionalProperties": false,
    "required": ["nombre", "email", "consulta"],
    "properties": {
      "nombre":   { "type": "string", "maxLength": 200 },
      "email":    { "type": "string", "maxLength": 300 },
      "consulta": { "type": "string", "minLength": 10, "maxLength": 5000 }
    }
  },
  "suggested_prompt": "Sos un asistente de atención al cliente. Analizá la consulta del usuario y devolvé una respuesta clara y accionable en JSON con: respuesta, categoria, urgencia."
}

The client sends this to the Forgium operator.

---

Prompt 2 — Integration

The operator creates the integration via Admin API using the client's

input_schema and prompt. Forgium returns a bundle.

The operator pastes this into Claude Code alongside the client's form,

replacing the placeholders with the bundle values.

Conectá este formulario con Forgium Prompt Integrations.

Endpoint: <endpoint>
Turnstile sitekey: <sitekey>
Turnstile action: <action>

El endpoint espera un POST con JSON:
{
  "input": { <campos del input_schema> },
  "turnstile_token": "<token del widget>"
}

Lee https://docs.forgium.dev/docs/integration/prompt-integrations para el contrato completo.

---

Full flow

Cliente                          Operador                       Forgium
   │                                │                              │
   │  1. Pega Prompt 1 + su form    │                              │
   │     en Claude Code             │                              │
   │     → obtiene input_schema     │                              │
   │       + prompt sugerido        │                              │
   │                                │                              │
   │  2. Te pasa schema + prompt    │                              │
   │ ─────────────────────────────▶ │                              │
   │                                │                              │
   │                                │  3. Creás integración        │
   │                                │     (curl + admin key)       │
   │                                │ ───────────────────────────▶ │
   │                                │                              │
   │                                │  4. Recibís bundle           │
   │                                │ ◀─────────────────────────── │
   │                                │                              │
   │  5. Le pasás Prompt 2          │                              │
   │     + bundle                   │                              │
   │ ◀───────────────────────────── │                              │
   │                                │                              │
   │  6. Pega Prompt 2 + bundle     │                              │
   │     en Claude Code             │                              │
   │     → integra el form          │                              │
   │                                │                              │
   │  7. Deploya y funciona         │                              │
   │     Form → Forgium → JSON      │                              │