Original Agent icon

Original Agent

Custom AI Agent that connects to original AI Agents
Join our community

Overview

This node acts as a custom AI agent interface to the original.land platform, allowing users to send messages to an AI bot identified by a Bot ID. It supports sending single messages or continuing conversations using chat history, optionally including document uploads and structured output validation via JSON Schema.

Common scenarios include:

  • Integrating AI-driven conversational agents into workflows.
  • Automating responses or data extraction from AI models hosted on original.land.
  • Using structured output schemas to enforce response formats for downstream processing.
  • Streaming AI responses in real-time for interactive applications.

Practical example:

  • A user sends a question to the AI bot about sales data, providing a structured output schema that expects SQL queries. The node returns validated SQL queries generated by the AI, which can then be executed in a database.

Properties

Name Meaning
Bot ID The unique identifier of the original.land AI bot to interact with.
API Key The API key credential required to authenticate requests to the original.land API.
Message The message text to send to the AI agent.
Bot Endpoint The URL endpoint of the original.land API (default: https://ai-api.original.land).
Streaming Whether to receive the AI response as a streaming output (true/false).
Override System Prompt Optional system prompt text to override the default system prompt used by the AI agent.
Chat History JSON string representing previous chat messages to continue a conversation instead of starting fresh. Should be an array of objects with content, role, and optional attachments.
Enable Documents Whether to include binary document uploads in the request. If enabled, binary data from input items will be sent alongside the message.
Structured Output Schema JSON Schema string defining the expected structure and validation rules for the AI's response. Must conform to JSON Schema specification. Used to validate and constrain the AI output format.

Output

The node outputs a JSON object under the field originalAgent containing:

  • response: The AI-generated response content. If streaming is disabled, this is parsed JSON or plain text extracted from the API response. If streaming is enabled, it contains the raw streaming response string.
  • streaming: Boolean indicating if the response was streamed.
  • conversationId: A conversation identifier returned by the API for tracking or continuing sessions.

If documents are enabled, the node includes them in the request but does not alter the output structure.

No binary output is produced by this node.

Dependencies

  • Requires access to the original.land API endpoint.
  • Needs a valid API key credential for authentication.
  • Uses HTTP POST requests with either form-data (for documents) or URL-encoded body.
  • Supports streaming responses if enabled.
  • Validates structured output schemas using JSON Schema standards.

Troubleshooting

  • Invalid JSON format in Structured Output Schema: Ensure the JSON schema provided is valid JSON and conforms to JSON Schema specifications. Use online validators if needed.
  • Invalid JSON format in Chat History parameter: The chat history must be a valid JSON string representing an array or object of chat messages.
  • Payment Required: Insufficient credit: The API key used has insufficient credit to perform the operation. Check account balance or subscription status on original.land.
  • Error while contacting AI Entities APIs: General error indicating issues with the API call. Verify network connectivity, API endpoint URL, and API key validity.
  • Error processing document: When enabling documents, ensure binary data is correctly formatted and base64 encoded.
  • Streaming issues: If streaming is enabled but no data is received, verify network stability and API support for streaming.

Links and References

Discussion