Frequently Asked Questions (FAQ)

This section addresses common questions and issues users might encounter while using Forjinn. If you don't find your answer here, please refer to the Contact Support section.

General Questions

Q: What is Forjinn?

A: Forjinn is a visual programming platform for building, managing, and deploying AI-driven applications and workflows. It features both a Chat Builder for conversational AI and a Visual Canvas for drag-and-drop workflow orchestration.

Q: What is the difference between Chat Builder and Visual Canvas?

A: The Chat Builder is a streamlined, form-based interface for quickly creating conversational AI agents with predefined components. The Visual Canvas offers full drag-and-drop flexibility for building complex multi-step workflows with custom node connections, conditions, and branching logic. You can switch between them from the tile-based dashboard or within any flow.

Q: Do I need to know how to code to use Forjinn?

A: No, Forjinn is designed to be user-friendly and allows you to build complex AI workflows without writing code. Both Chat Builder and Visual Canvas support no-code development. However, familiarity with AI concepts can enhance your experience.

Q: Is Forjinn free to use?

A: The pricing model depends on your deployment or service provider. Please check with your administrator or the platform's official website for details.

Q: What frameworks does Forjinn support?

A: Forjinn supports multiple AI agent frameworks including Google ADK, CrewAI, AutoGen, and standard LangChain-based agents. You can choose the framework that best fits your use case when creating agents.

Chat Builder Questions

Q: How do I get started with Chat Builder?

A: From the dashboard, click the Chat Builder tile. You'll be guided through a streamlined setup where you can select your LLM provider, add tools, configure memory, and define your agent's behavior -- all through a form-based interface.

Q: How do I switch from Chat Builder to Visual Canvas?

A: Any flow created in Chat Builder can be opened in Visual Canvas for advanced editing. Look for the "Edit in Canvas" option in your flow's settings or actions menu.

Chatflow Questions

Q: My chatflow isn't responding. What should I do?

A:

1. Check Connections: Ensure all components in your chatflow are correctly connected.
2. Verify Credentials: Make sure all LLM and tool components have valid Credentials configured.
3. Review Logs: Check the chatflow's execution logs for any error messages.
4. Test Components Individually: Try testing individual components if possible to isolate the issue.

Q: How do I use my own custom API with a chatflow?

A: You can use the "HTTP Request Tool" component to make calls to your custom API. You might need to set up an "HTTP Basic Auth" or "HTTP Bearer Token" Credential if your API requires authentication. You can also leverage the API Gateway feature to manage multiple API endpoints from a centralized location.

Q: Can I share my chatflows with others?

A: Yes, you can Export and Import Chatflows to share them with other users or move them between different Forjinn instances.

Agent Questions

Q: Which agent framework should I use?

A: Forjinn supports multiple frameworks:

• Google ADK: Best for projects leveraging Google's AI ecosystem and Gemini models
• CrewAI: Ideal for role-based multi-agent collaboration with defined roles and tasks
• AutoGen: Great for conversational multi-agent patterns and code generation workflows
• Standard (LangChain): Best for single-agent tools, RAG, and straightforward chains

Choose based on your specific use case during agent creation.

Q: My agent is not using the tools I provided. Why?

A:

1. Agent Type: Ensure you've selected an agent type that is designed to use tools (e.g., ReAct Agent, Conversational Agent).
2. Prompt Instructions: Your agent's prompt needs to clearly instruct it to use tools when appropriate. The agent's "Thought" process in the Agent Executions logs can reveal if it's considering tool use.
3. Tool Configuration: Verify that the tools are correctly configured and have the necessary Credentials.

Q: How can I make my agent remember past conversations?

A: Integrate a "Memory" component (e.g., Conversational Buffer Memory) into your agent's configuration. This will allow the agent to maintain conversational context.

API Gateway Questions

Q: What is the API Gateway feature?

A: The API Gateway centralizes management of all your API endpoints, providing unified authentication, rate limiting, request/response transformation, and monitoring. It allows you to expose your Forjinn flows and agents as REST API endpoints without managing infrastructure.

Q: How do I set up API Gateway?

A: Navigate to the API Gateway tile on your dashboard, then configure your endpoints, authentication methods, and routing rules. See the API Gateway documentation for detailed setup instructions.

Credential Questions

Q: My API key is not working. What should I check?

A:

1. Correct Key: Double-check that you've entered the API key correctly, without any extra spaces or characters.
2. Service Status: Verify that the external service (e.g., OpenAI, Google) is operational.
3. Permissions: Ensure the API key has the necessary permissions on the external service side.
4. Rate Limits: You might be hitting rate limits imposed by the external service.
5. Credential Type: Make sure you selected the correct credential type when adding it.

Triggers Questions

Q: What are Triggers?

A: Triggers allow you to start workflows automatically based on events, schedules, or external inputs. Supported trigger types include webhooks, scheduled cron jobs, and event-based triggers from integrated services.

Admin Questions

Q: How do I add a new user?

A: Refer to the Managing Users guide in the Admin section.

Q: A user can't access a specific feature. What should I check?

A: Review the user's assigned Roles and the Permissions associated with those roles to ensure they have the necessary access.

Dashboard Questions

Q: How do I navigate the new dashboard?

A: Forjinn uses a tile-based dashboard that provides quick access to all major features including Chat Builder, Visual Canvas, API Gateway, Agents, Datasets, Triggers, and Settings. Click any tile to navigate to that section. You can customize your dashboard layout from Settings.

If your question is not answered here, please Contact Support.