Initial Setup
Configure your LLM providers and get ready to build
Get your orckAI platform configured with AI providers in just 5 minutes. We'll walk you through getting API keys, configuring models, and testing your setup to ensure everything works perfectly.
Video Tutorial
LLM Provider Comparison
Anthropic (Claude)
Advanced reasoning and analysis capabilities with excellent safety features.
- Superior reasoning and analysis
- Excellent for complex tasks
- Strong safety and ethics
- Long context windows
- Higher cost per token
- Limited image generation
OpenAI (GPT)
Versatile models with strong creative writing and code generation abilities.
- Excellent creative writing
- Strong code generation
- Lower cost options available
- Faster response times
- Less consistent reasoning
- More prone to hallucination
Step 1: Get API Keys
You'll need to obtain API keys from your chosen providers. We recommend setting up both for maximum flexibility.
Anthropic API Key
- Visit Anthropic Console Go to console.anthropic.com and sign in or create an account
- Navigate to API Keys Click on "API Keys" in the left sidebar
- Create New Key Click "Create Key", give it a name like "orckAI Production", and copy the generated key
- Add Credits Add billing information and credits to your account (minimum $5 recommended)
OpenAI API Key
- Visit OpenAI Platform Go to platform.openai.com and sign in or create an account
- Access API Keys Navigate to "API keys" section in your dashboard
- Generate Key Click "Create new secret key", name it "orckAI", and copy the key immediately
- Set Usage Limits Configure usage limits and add payment method in the billing section
Step 2: Configure in orckAI
Now let's add your API keys to the orckAI platform so your AI agents can use them.
- Open Settings In your orckAI dashboard, click the Settings icon in the left sidebar
- LLM Configuration Navigate to "LLM Configuration" section
- Add Anthropic Key Paste your Anthropic API key in the "Claude API Key" field and click "Test Connection"
- Add OpenAI Key Paste your OpenAI API key in the "OpenAI API Key" field and click "Test Connection"
- Save Configuration Click "Save Settings" to store your configuration securely
Model Selection Guide
Choose the right model for your use case based on cost, speed, and quality requirements.
| Model | Cost | Speed | Quality | Best For |
|---|---|---|---|---|
| Claude 3.5 Sonnet | Medium | Fast | Excellent | Complex analysis, reasoning, enterprise tasks |
| Claude 3 Haiku | Low | Very Fast | Good | Simple tasks, high-volume processing |
| GPT-4 | High | Medium | Excellent | Creative writing, complex reasoning |
| GPT-3.5 Turbo | Low | Very Fast | Good | Chat, simple tasks, prototyping |
Recommended Setup
Start with Claude 3.5 Sonnet for your first agents. It provides the best balance of reasoning capability, speed, and cost for most enterprise use cases. You can always switch models later or use different models for different agents based on their specific requirements.
Verify Configuration
Test your setup to ensure everything is working correctly before creating your first AI agent.
- Create Test Chat Go to AI Agents and click "Create Agent" to start a new agent
- Select Model Choose Claude 3.5 Sonnet (or your preferred model) in the model dropdown
- Test Response Send a simple message like "Hello, can you help me test this setup?" and verify you get a response
- Check Multiple Models Try switching to different models to ensure all your configured providers are working
Troubleshooting
Common issues and their solutions:
Problem: Getting authentication errors when testing connection.
Solution: Double-check your API key is copied correctly with no extra spaces. Ensure your API key has sufficient credits and hasn't expired.
Problem: Getting rate limit errors during testing.
Solution: Wait a few minutes and try again. Check your provider's rate limits and consider upgrading your plan if you need higher limits.
Problem: Requests timing out or failing to connect.
Solution: Check your internet connection and firewall settings. Ensure orckAI can make outbound HTTPS requests to the API providers.
Ready to Build Your First Agent?
Now that your LLM providers are configured, let's create your first AI agent.