Skip to content
Nappai Documentation

Custom Component

This component acts as a ready-made template inside Nappai. It simply takes the text you provide and passes it along to the next step in your workflow without changing it. It is primarily designed to help developers and advanced users quickly create new custom components, but anyone can use it as a simple text relay in their automation flows.

How it Works

Think of this component as a digital conveyor belt for text. When you type or paste content into the Input Value field, the component instantly packages that text into a standard format that other Nappai tools can easily understand. It does not analyze, edit, or transform your text in any way. Once packaged, the text is made available as an Output that can be sent to other nodes in your dashboard, such as AI assistants, data formatters, or storage tools. The entire process happens locally within your workspace, ensuring a fast and straightforward data handoff.

Inputs

Input Fields

The following fields are available to configure this component:

  • Input Value: The text you want to pass through the workflow. This field is pre-filled with “Hello, World!” as a starting example, but you can type anything here, including spaces, line breaks, or special characters.

Outputs

  • Output: The final packaged text that flows out of this node. You can connect this to any other component that expects text or data input, such as an AI message parser, a database saver, or a text modifier.

Output Data Example (JSON)json

{ “type”: “Data”, “value”: “Hello, World!” } Note: The exact structure adapts to Nappai’s internal data schema, but you will always see the original text you entered preserved inside it.

Connectivity

This component is designed to sit at the beginning or middle of a data flow. It naturally connects to:

  • AI Assistants & Prompt Builders: Feed your text directly into an LLM or chatbot node to start a conversation or request.
  • Data Processors & Modifiers: Route the text to nodes that format, clean, translate, or summarize it.
  • Storage & Logging Tools: Send the input directly to a database, file, or dashboard widget for quick reference. Because it outputs a standardized data format, it plays well with almost any downstream node in the Nappai automation system.

Usage Example

Imagine you are building an automated report generator. You can place the Custom Component at the start of your workflow, type a project update into the Input Value field, and then connect the Output to an AI summarizer node. The component will instantly pass your raw update to the AI, which then analyzes it and sends the summary to a final email sender node. It acts as a clean, reliable starting point for any text based automation.

Important Notes

⚠️ Single Text Input Only 🟢 This component only accepts a single text input and produces the same text as output. It does not support other data types or multiple inputs.

⚠️ Development Mode Notice 🟡 The component is flagged as a development component. It may change or be removed in future releases, so avoid using it in critical production workflows.

💡 Use as a Template for Custom Components 🟢 This component serves as a starting point for building your own components. Edit the class code to add functionality before using it in production.

🟡 Default Input Value 🟢 If no input is provided, the component uses the default value “Hello, World!”. Users can change this default in the component settings.

ℹ️ Output Mirrors Input 🟢 The output data is identical to the input value. Any changes to the input will be reflected directly in the output.

Tips and Best Practices

  • Use this component as a reliable starting point when building text-based automation flows.
  • If you need to process, analyze, or change your text, connect this component to a transformer or AI node right after it.
  • Keep in mind that this node is intended primarily as a development template; for standard text passing in active workflows, consider using Nappai’s built-in text relay nodes if available.
  • Test your workflows with different text inputs to ensure downstream nodes correctly receive the formatted data.

Security Considerations

This component does not collect, store, or transmit your data externally. All text input and output processing happens locally within your Nappai workspace. As with any automation tool, avoid pasting sensitive or confidential information into text fields unless you are certain the connected downstream nodes handle data securely. Since this node simply passes text through unchanged, it carries no inherent security risks, but always verify the security settings of any tools you connect it to.