Xill4 AI

Xill4 AI is an OpenAI-powered assistant for working with Xill4 projects, flows, components, and migrations. It combines Xill4 documentation with the context of the project or flow you are viewing, allowing you to ask questions in natural language and request selected actions.

Configure OpenAI

Xill4 AI is enabled when an OpenAI API token is configured. Configure the token with either the XILL4_EDITOR_API_TOKEN environment variable or the editor.apiToken property in config.yml.

Environment variable

XILL4_EDITOR_API_TOKEN=YOUR_OPENAI_API_TOKEN

Configuration file

config.yml

editor:
  apiToken: YOUR_OPENAI_API_TOKEN

Restart Xill4 after changing the configuration. The Xill4 AI button is hidden when no token is configured.

warning

Treat the OpenAI API token as a secret. Do not commit it to source control or include it in a project, flow variable, component setting, or chat message.

See editor.apiToken for the full configuration reference.

Open the assistant

After Xill4 AI is enabled, select the Xill4 AI button in the lower-left corner of the application. The assistant is available from the welcome page, project pages, and the flow designer.

When opened from a project or flow, the assistant automatically receives the current project and flow identifiers when available. This lets it inspect the relevant resources without asking you to find their IDs.

You can also select Explain by AI on a flow error. Xill4 sends the error, message, timestamp, and component ID to the assistant as the starting point for an explanation.

Capabilities

Xill4 guidance

Ask questions about anything in the documentation, projects, flows, components, Content Store schemas, configuration, and best practices. Xill4 AI can search its Xill4 knowledge base and inspect component information before answering.

Example prompts:

• How should I structure an extraction flow?
• How do I use the HTTP Request component?
• Which Content Store fields are required for a RECORD?

Project and flow context

Xill4 AI can list projects and inspect project details, complete flow designs, individual component configurations, and component connections. This context helps it give answers that match the resources you are currently working with.

Flow debugging

When you ask why a flow failed, Xill4 AI can:

1. Search the flow logs for errors and warnings.
2. Match log entries to component IDs.
3. Inspect the affected component configuration and connections.
4. Consult the component documentation.
5. Propose the exact configuration changes to investigate or apply.

The assistant diagnoses and recommends changes; it does not currently modify an existing flow configuration.

Report generation

Ask Xill4 AI to create a custom report. It translates the request into a MongoDB query and selected columns, then creates a report flow in the current project. The response includes a link that opens the created flow.

Describe the data to include, filters to apply, columns to show, and a report name. Review the generated query and flow before running it against production data.

Migration project initialization

Xill4 AI can initialize an accelerator-based migration project. Provide:

• The source system.
• The target system.
• An existing, writable, absolute directory on the Xill4 server where mapping sheets may be created.

The assistant downloads the matching Migration Accelerator, creates the project, imports its environment and flows, and creates the mapping sheets and reports directories.

Supported source systems:

• Alfresco
• Documentum
• File System
• FileNet Hybrid
• HP TRIM
• NetDocuments
• OnBase
• OpenText Content Server
• OpenText Content Server DB
• eDOCS DB
• SharePoint On-Premises

Supported target systems:

• Alfresco
• Documentum
• NetDocuments
• OpenText Content Server
• SharePoint Online

eDOCS DB can only be combined with the NetDocuments target. The other listed sources can be combined with any listed target.

Actions and data access

Xill4 AI uses read-only tools to search documentation and retrieve project, flow, component, and log information. It also has tools that can create resources:

Action	Result
Initialize a migration project	Creates a project, an environment, flows, and mapping directories.
Generate a report	Creates a report flow in a project.

Created projects and flows are shown as links below the assistant's response. Select a link to open the resource directly. Xill4 AI does not currently update or delete existing resources.

Important considerations

• Xill4 AI currently supports OpenAI only.
• Prompts and the Xill4 context required to answer them are processed using the configured OpenAI service.
• AI-generated guidance and queries can be incomplete or incorrect. Review recommendations and generated flows before using them with production data.
• Do not share credentials, tokens, certificates, connection strings, personal data, or other sensitive content in chat messages.
• Use project environment secrets for sensitive migration configuration. Flow variables and component settings are stored unencrypted and are exported with flows.
• Select Clear chat to delete the current conversation and reset the assistant's conversation memory.