Documentation
¶
Overview ¶
Command openai is the second reference example plugin demonstrating a real connector-consuming action, this time targeting the OpenAI Chat Completions API specifically: it contributes one connector type, "openai.connection@1", and one action, "ai.generate_text@1" (the action id is deliberately generic — see the vision document's own example list, section 7.4 — so a future provider plugin could contribute the same action bound to a different connector, without workflows changing).
Unlike plugins/examples/http's http.request@1, which is a generic, untyped passthrough that never turns a non-2xx response into a Go error (it's a legitimate result the workflow can branch on), this action knows the exact shape of what it's calling: a non-2xx response *is* a Go error here, since there is no meaningful "text" to hand back on failure. That matches the vision document's own framing (section 16): "L'IA doit rester encapsulée derrière des actions typées et auditables."
It depends only on the SDK (sdk/go-plugin), never on any internal/ package of the agent.
Source Files