Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.neuralfactory.ai/llms.txt

Use this file to discover all available pages before exploring further.

Managing Connections

Toolkit connections require authentication to access external services. This guide covers setting up, testing, and maintaining those connections.

Setting up a connection

1

Navigate to Toolkits

Open the Toolkits section from the sidebar.
2

Select or create a toolkit

Choose an existing toolkit to configure or create a new one.
3

Configure authentication

Each integration has its own authentication method:
  • OAuth (Jira, Confluence, Outlook, SharePoint, Google Drive) — Click “Connect” and complete the OAuth authorization flow in the popup window
  • API key — Enter the API key provided by the external service
  • Custom credentials — Provide the required credentials as specified by the integration
4

Test the connection

After configuring credentials, use the Test Connection button (if available) to verify that Neural Factory can successfully communicate with the external service.
5

Assign to agents

Once the toolkit is connected, assign it to the agents that should be able to use it. This is done in the agent configuration under the tools section.

Managing existing connections

Refreshing credentials

OAuth tokens may expire over time. If a toolkit stops working:
  1. Navigate to the toolkit in the Toolkits section
  2. Click Reconnect or Re-authorize
  3. Complete the OAuth flow again

Revoking access

To disconnect a toolkit:
  1. Navigate to the toolkit configuration
  2. Click Disconnect or remove the credentials
  3. Remove the toolkit from any agents that had it assigned

Viewing connection status

The Toolkits page shows the connection status for each configured toolkit — whether it’s connected, requires re-authorization, or has errors.

Troubleshooting

  • OAuth flow fails — Ensure your browser allows popups for the Neural Factory domain
  • Connection test fails — Verify that the external service is accessible and the credentials are correct
  • Intermittent failures — Check if the external service has rate limits or downtime
  • Permission errors — The authenticated account may lack the required permissions in the external service
See Connection Problems for more detailed troubleshooting.