Package org.cibseven.connect.ai.agent
Class AgentConnectorConstants
java.lang.Object
org.cibseven.connect.ai.agent.AgentConnectorConstants
Internal constants shared across the agent connector implementation.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringFlag that indicates the execution of the agent connector in the process; only possible value istrue.static final StringPrefix for the per-activity chat log process variable.static final StringDefault base URL for the OpenAI-compatible API endpoint.static final intDefault sliding window size (number of messages) for the per-memory-id chat memory used whenuseChatMemoryis activated and no explicitchatMemoryMaxMessagesis provided.static final intDefault character overlap between consecutive chunks.static final intDefault maximum characters per text chunk before splitting.static final intDefault embedding vector dimension.static final StringDefault forinstructionModewhen the parameter is unset.static final intDefault maximum number of RAG results returned per query.static final doubleDefault minimum similarity score (0.0–1.0) for a result to be included.static final StringHard-coded fallback model used when nomodelinput parameter is set on the BPMN activity and the platform operator has not configured an override viaDEFAULT_MODEL_PROPERTYorDEFAULT_MODEL_ENV_VAR.static final StringEnvironment-variable fallback forDEFAULT_MODEL_PROPERTY.static final StringJVM system property that overridesDEFAULT_MODELfor the deployment.static final StringDefault PostgreSQL port whenpgPortinput parameter is not provided.static final StringDefault table name for the embedding store whenpgTableis not provided.static final StringEnvironment variable that overrides the base URL at the process level.static final StringinstructionModevalue — the modeler'sinstructionis appended to the bundled default prompt, separated byINSTRUCTION_MODE_SEPARATOR.static final StringinstructionModevalue — the modeler'sinstructionis prepended to the bundled default prompt, separated byINSTRUCTION_MODE_SEPARATOR.static final StringinstructionModevalue — the modeler'sinstructionreplaces the bundled default prompt entirely.static final StringSeparator used between the bundled default prompt and the caller instruction. -
Method Summary
Modifier and TypeMethodDescriptionstatic StringResolves the deployment-wide default model fromDEFAULT_MODEL_PROPERTY→DEFAULT_MODEL_ENV_VAR→DEFAULT_MODEL.
-
Field Details
-
DEFAULT_MODEL
Hard-coded fallback model used when nomodelinput parameter is set on the BPMN activity and the platform operator has not configured an override viaDEFAULT_MODEL_PROPERTYorDEFAULT_MODEL_ENV_VAR.Operators set their organisation-wide default through one of:
- JVM system property "cibseven.connect.ai-agent.defaultModel"
(e.g.
-Dcibseven.connect.ai-agent.defaultModel=<provider-model>), - environment variable "CIBSEVEN_CONNECT_AI_AGENT_DEFAULT_MODEL",
- or, in the run distro, the commented YAML stanza under
cibseven.connect.ai-agentindefault.yml.
Resolution order is implemented by
resolveDefaultModel().- See Also:
- JVM system property "cibseven.connect.ai-agent.defaultModel"
(e.g.
-
DEFAULT_MODEL_PROPERTY
JVM system property that overridesDEFAULT_MODELfor the deployment. Wins overDEFAULT_MODEL_ENV_VARwhen both are set.- See Also:
-
DEFAULT_MODEL_ENV_VAR
Environment-variable fallback forDEFAULT_MODEL_PROPERTY.- See Also:
-
DEFAULT_BASE_URL
Default base URL for the OpenAI-compatible API endpoint.- See Also:
-
ENV_BASE_URL
Environment variable that overrides the base URL at the process level. Set to e.g.https://openrouter.ai/api/v1to route requests through OpenRouter.- See Also:
-
DEFAULT_PG_PORT
Default PostgreSQL port whenpgPortinput parameter is not provided.- See Also:
-
DEFAULT_PG_TABLE
Default table name for the embedding store whenpgTableis not provided.- See Also:
-
DEFAULT_MAX_RAG_RESULTS
public static final int DEFAULT_MAX_RAG_RESULTSDefault maximum number of RAG results returned per query.- See Also:
-
DEFAULT_MIN_RAG_SCORE
public static final double DEFAULT_MIN_RAG_SCOREDefault minimum similarity score (0.0–1.0) for a result to be included. Set to 0.0 (no filtering) so results are always returned; tune per deployment. AllMiniLmL6V2 typically yields cosine similarities in the 0.3–0.7 range for related content.- See Also:
-
DEFAULT_EMBEDDING_DIMENSION
public static final int DEFAULT_EMBEDDING_DIMENSIONDefault embedding vector dimension.AllMiniLmL6V2EmbeddingModelproduces 384-dimensional vectors.- See Also:
-
DEFAULT_CHUNK_SIZE
public static final int DEFAULT_CHUNK_SIZEDefault maximum characters per text chunk before splitting.- See Also:
-
DEFAULT_CHUNK_OVERLAP
public static final int DEFAULT_CHUNK_OVERLAPDefault character overlap between consecutive chunks.- See Also:
-
AGENT_CONNECTOR_FLAG_VARIABLE_NAME
Flag that indicates the execution of the agent connector in the process; only possible value istrue.- See Also:
-
AGENT_CONNECTOR_LOG_PREFIX
Prefix for the per-activity chat log process variable. The full variable name isAGENT_CONNECTOR_LOG_PREFIX + <activityId>, so each service task running the connector writes its own chat log without further configuration from the BPMN designer.- See Also:
-
DEFAULT_CHAT_MEMORY_MAX_MESSAGES
public static final int DEFAULT_CHAT_MEMORY_MAX_MESSAGESDefault sliding window size (number of messages) for the per-memory-id chat memory used whenuseChatMemoryis activated and no explicitchatMemoryMaxMessagesis provided.- See Also:
-
INSTRUCTION_MODE_REPLACE
instructionModevalue — the modeler'sinstructionreplaces the bundled default prompt entirely. Default mode for backwards compatibility.- See Also:
-
INSTRUCTION_MODE_APPEND
instructionModevalue — the modeler'sinstructionis appended to the bundled default prompt, separated byINSTRUCTION_MODE_SEPARATOR.- See Also:
-
INSTRUCTION_MODE_PREPEND
instructionModevalue — the modeler'sinstructionis prepended to the bundled default prompt, separated byINSTRUCTION_MODE_SEPARATOR.- See Also:
-
DEFAULT_INSTRUCTION_MODE
Default forinstructionModewhen the parameter is unset.- See Also:
-
INSTRUCTION_MODE_SEPARATOR
Separator used between the bundled default prompt and the caller instruction.- See Also:
-
-
Method Details
-
resolveDefaultModel
Resolves the deployment-wide default model fromDEFAULT_MODEL_PROPERTY→DEFAULT_MODEL_ENV_VAR→DEFAULT_MODEL. Empty / blank values are treated as unset so an operator can re-enable the hard-coded fallback by clearing the override.
-