Skip to main content

​
Goal

Connect and manage integrations safely with clear troubleshooting steps.

​
Steps

  1. Open Alter settings and go to integrations or tool manager.
  2. Connect one integration at a time and test immediately.
  3. Confirm required permissions and account scopes.
  4. Create a simple test prompt to verify expected behavior.
  5. If failures occur, review provider auth and retry.

​
Managing Many Tools

Enabling many tools increases context window usage and impacts performance. For most workflows, use Flow - Alter’s tool orchestrator that automatically selects the right tool for each request.

Use Flow for Tool Orchestration

Flow reduces context usage by acting as a single tool that routes requests to the appropriate integration automatically.
Instead of loading all tools into every request, Flow:
  • Analyzes your request and selects the right tool
  • Handles multi-step orchestration across tools
  • Reduces context window usage and improves performance
Enable Flow in Tool Manager under Local Tools > Alter.

​
Coding tools

Tools Manager → Local Tools → Coding lists four local coding integrations: Fastest path: install a specialized agent from Marketplace → Browse — for example the live ChatGPT Agent. On first run, Alter prompts you to enable the linked coding tool. See Coding tools — Marketplace onboarding. Connect only the providers you need. Each exposes run, list, control, and settings tools to Alter’s model when enabled for the current action.

Coding tools guide

Prerequisites, workspace permissions, and provider differences

​
Troubleshooting

  • Re-authenticate provider connection.
  • Confirm local/network permissions.
  • Check integration-specific limits and quotas.