Skip to main content

Frequently Asked Questions (FAQ)

This page compiles common GeniSpace user questions and answers. If you don't find your question here, please refer to Troubleshooting or contact us.

Registration & Login​

How do I register a GeniSpace account?
  1. Visit the GeniSpace website
  2. Click "Sign Up" in the upper-right corner
  3. Fill in your email, password, and other basic information
  4. Complete email verification
  5. Log in and enter the console
What should I do if I can't log in?
  1. Check your network connection
  2. Verify your email and password are correct
  3. Clear browser cache and cookies
  4. Use "Forgot Password" to reset your password
  5. Try using a different browser (latest versions of Chrome, Firefox, Safari, or Edge)

If the issue persists, please contact support.

Agents​

What is the difference between task-type and conversational agents?
  • Task-type: Designed for structured input/output, supports JSON Schema validation, suitable for data processing, API integration, and automated workflows
  • Conversational: Designed for multi-turn conversations, supports context memory, suitable for customer service, consulting, and creative collaboration

See Agent Overview for details.

How do I test an agent?
  • Task-type: Enter data in the test area of the agent configuration page and execute
  • Conversational: Open the corresponding agent in the Chat application for multi-turn conversation testing

Workflows & Tasks​

How are workflows triggered for execution?

Three trigger methods are supported:

  • Scheduled Trigger: Execute on a schedule using Cron expressions
  • Event Trigger: Respond to system or external events
  • Manual Trigger: User manually clicks to run

See Workflow Triggers for details.

How do I troubleshoot a failed workflow execution?
  1. View execution logs on the task details page
  2. Check whether each node's inputs and outputs are correct
  3. Verify environment variables and ConfigMap configuration
  4. Confirm that operators, data sources, and other dependencies are available

See Troubleshooting for details.

Operators & Tools​

How do I import a custom operator?
  1. Console → Operators → Import Tool
  2. Provide an OpenAPI definition or operator service URL
  3. After configuration, the operator can be used in workflows

See Custom Operators for details.

What specification do operators support?

Operators are defined using the OpenAPI 3.0 specification and support standard REST API descriptions. You can use the genispace-operators-custom framework for rapid development.

Data​

What is the difference between relational data sources and vector datasets?
  • Relational Data Sources: Connect to external databases to perform CRUD operations (insert/select/update/delete) in workflows
  • Vector Datasets: Store vectorized data for agent semantic retrieval and knowledge augmentation

See Data Overview for details.

Billing & Subscription​

What subscription plans are available?

GeniSpace offers four tiers: FREE, PERSONAL (Personal Pro), TEAM, and ENTERPRISE. These tiers differ in team limits, resource quotas, Token allowances, feature availability, and more.

See Billing & Subscription for details.

How does Token billing work?

Each time you use agents, operators, or other services, Tokens are deducted from your account balance. Token allowances are determined by your subscription plan and can be topped up. Team billing is based on the team owner's account.

See Billing Overview for details.

Teams & Permissions​

How do I invite team members?

A TEAM or ENTERPRISE subscription is required. Invite members in Console → Team and assign appropriate permissions.

See Team Management for details.

API & Development​

How do I obtain an API key?
  1. Console → Settings → API Keys
  2. Create a new key
  3. Copy and store it securely (only displayed once after creation)

See API Authentication for details.

Is there an SDK available?

GeniSpace provides an official JavaScript/TypeScript SDK: genispace/sdk-javascript. There are also open-source operator frameworks and chat plugin development resources available.

See Developer Resources for details.

Deployment​

Does GeniSpace support private deployment?

The Enterprise edition supports self-hosted (private) deployment. Self-hosted versions come with Enterprise edition privileges by default, with no subscription payment required.

See Enterprise Deployment or contact sales.

Technical Support​