OCI Generative AI Agent icon

OCI Generative AI Agent

Interact with OCI Generative AI Agent Runtime

Actions4

Chat

AI-generated

Summary

Send a user message to an OCI Generative AI Agent Endpoint and return the agent's response.

Inputs

  • agentEndpointId (required) — The OCID of the Generative AI Agent Endpoint to use
  • userMessage (required) — Message to send to the agent
  • sessionId — The session ID to use for the chat. If omitted, the agent may start a new session.
  • shouldStream — If true, the response may be a stream; n8n will surface a note instead of full JSON.

Output shape

Returns an array of items, each with a json field. If the SDK returns a streaming ReadableStream (has getReader), the json value is { streamed: true, note: 'Streaming responses are not directly supported in n8n output. Disable Stream Response to receive full JSON.' }. Otherwise, the json value is the full chat result from the OCI agent (resp.chatResult or resp).

Streaming is not fully supported in n8n's UI; disabling Stream Response yields the complete JSON response.

Examples

Example 1: Chat with a new session

agentEndpointId: , userMessage: 'Hello', sessionId: '', shouldStream: false

Example 2: Continue an existing session

agentEndpointId: , userMessage: 'How are you?', sessionId: '', shouldStream: false

Links

Discussion