This Documentation is Being Deprecated

This page is being phased out as part of our documentation reorganization.

Click this card to be redirected to the updated version with the most current information.

If you notice any discrepancies or areas needing improvement in the new documentation, please use the “Report an issue” button at the bottom of the page.

This article will briefly introduce common structures in plugin development.

​
Path Specifications

When specifying file paths in Manifest or any yaml files, follow these two rules based on file types:

  • For multimedia files like images or videos (e.g., plugin icon), place them in the _assets folder under the plugin root directory.
  • For regular text files like .py or .yaml, use the absolute path within the plugin project.

​
Common Structures

When defining plugins, some data structures can be shared among tools, models, and Endpoints. Here are these shared structures.

​
I18nObject

I18nObject is an internationalization structure compliant with IETF BCP 47 standard, currently supporting four languages:

  • en_US
  • zh_Hans
  • ja_Jp
  • pt_BR

​
ProviderConfig

ProviderConfig is a common provider form structure, applicable to both Tool and Endpoint

  • name (string): Form item name
  • label (I18nObject, required): Follows IETF BCP 47
  • type (provider_config_type, required): Form type
  • scope (provider_config_scope): Option range, varies with type
  • required (bool): Cannot be empty
  • default (any): Default value, only supports basic types float int string
  • options (list[provider_config_option]): Options, only used when type is select
  • helper (object): Help documentation link label, follows IETF BCP 47
  • url (string): Help documentation link
  • placeholder (object): Follows IETF BCP 47

​
ProviderConfigOption(object)

  • value(string, required)：values
  • label(object, required)：comply with IETF BCP 47

​
ProviderConfigType(string)

  • secret-input (string)：Configuration information will be encrypted
  • text-input(string)：Plain text
  • select(string)：drop-down box
  • boolean(bool)：switchgear
  • model-selector(object)：Model configuration information, including vendor name, model name, model parameters, etc.
  • app-selector(object)：app id
  • tool-selector(object)：Tool configuration information, including tool vendor, name, parameters, etc.
  • dataset-selector(string)：TBD

​
ProviderConfigScope(string)

  • When type is model-selector
    • all
    • llm
    • text-embedding
    • rerank
    • tts
    • speech2text
    • moderation
    • vision
  • When type is app-selector
    • all
    • chat
    • workflow
    • completion
  • When type is tool-selector
    • all
    • plugin
    • api
    • workflow

​
ModelConfig

  • provider (string): Model provider name including plugin_id, in the format of langgenius/openai/openai
  • model (string): Specific model name
  • model_type (enum): Model type enumeration, refer to this document

​
NodeResponse

  • inputs (dict): Variables finally input to the node
  • outputs (dict): Node output results
  • process_data (dict): Data generated during node execution

​
ToolSelector

  • provider_id (string): Tool provider name
  • tool_name (string): Tool name
  • tool_description (string): Tool description
  • tool_configuration (dict[str, Any]): Tool configuration information
  • tool_parameters (dict[str, dict]): Parameters requiring LLM inference
    • name (string): Parameter name
    • type (string): Parameter type
    • required (bool): Whether required
    • description (string): Parameter description
    • default (any): Default value
    • options (list[string]): Available options

Edit this page | Report an issue