Check the wire contract and authority boundary before inserting a proxy.
Practical procedure
- Inventory the exact chat fields and headers your proxy sends, including classification and operation identity.
- Configure the adapter to target the authorized GoCux service and preserve its product route alias.
- Test malformed input and refused admission in addition to a successful small request so errors are not normalized into empty answers.
Separate the external system from GoCux authority
A named external tool in a workflow does not establish a native GoCux integration. Start with an authorized export, an already configured connector, or a separately implemented adapter. Keep external account credentials in the owning system. In GoCux, inspect the available connector and its grants; the fact that a connector is registered does not itself authorize a task to use it.
Contract example
Developer examples below describe routes on an authorized, configured GoCux control-plane base URL. They are request shapes or operation references, not claims that a particular public hostname exposes the API. Use the workspace for the corresponding human workflow; availability and permissions depend on the actual deployment.
GET /connectors — inspect connectors available to the authenticated company
GET /connectors/{connector_id}
GET /connector-defaults
GET /task-contexts/{context_id}/connectorsInspect the result
The useful outcome is an explicit boundary: what information enters GoCux, which task can access it, and what result leaves. Start with a read-only sample and verify its source context. A local client or adapter owns the external invocation and its error handling unless an actual deployed connector provides that behavior.
What to keep explicit
A proxy that accepts an OpenAI-shaped configuration is not proof of complete GoCux compatibility. Do not forward provider-selection fields as customer authority.
Handle incomplete and refused work
Authentication with the external system is separate from GoCux authentication. Missing grants, revoked permissions or unavailable connectors must remain visible; do not replace them with invented data. Publishing a marketplace listing, creating a paid external resource or sending messages is a separate action from preparing an integration guide.
Continue with related guides
Bring this workflow into your workspace.
Set the scope. Review the evidence. Approve the steps that need it.