SETUP 5 MINUTES

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.

2
Steps
5 min
Setup time
Multiple
Providers
Enterprise
Ready

Video Tutorial

LLM Provider Comparison

Anthropic (Claude)

Advanced reasoning and analysis capabilities with excellent safety features.

Pros:
  • Superior reasoning and analysis
  • Excellent for complex tasks
  • Strong safety and ethics
  • Long context windows
Cons:
  • Higher cost per token
  • Limited image generation

OpenAI (GPT)

Versatile models with strong creative writing and code generation abilities.

Pros:
  • Excellent creative writing
  • Strong code generation
  • Lower cost options available
  • Faster response times
Cons:
  • 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

  1. Visit Anthropic Console Go to console.anthropic.com and sign in or create an account
  2. Navigate to API Keys Click on "API Keys" in the left sidebar
  3. Create New Key Click "Create Key", give it a name like "orckAI Production", and copy the generated key
  4. Add Credits Add billing information and credits to your account (minimum $5 recommended)

OpenAI API Key

  1. Visit OpenAI Platform Go to platform.openai.com and sign in or create an account
  2. Access API Keys Navigate to "API keys" section in your dashboard
  3. Generate Key Click "Create new secret key", name it "orckAI", and copy the key immediately
  4. 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.

  1. Open Settings In your orckAI dashboard, click the Settings icon in the left sidebar
  2. LLM Configuration Navigate to "LLM Configuration" section
  3. Add Anthropic Key Paste your Anthropic API key in the "Claude API Key" field and click "Test Connection"
  4. Add OpenAI Key Paste your OpenAI API key in the "OpenAI API Key" field and click "Test Connection"
  5. 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

Pro Tip

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.

  1. Create Test Chat Go to AI Agents and click "Create Agent" to start a new agent
  2. Select Model Choose Claude 3.5 Sonnet (or your preferred model) in the model dropdown
  3. Test Response Send a simple message like "Hello, can you help me test this setup?" and verify you get a response
  4. Check Multiple Models Try switching to different models to ensure all your configured providers are working

Troubleshooting

Common issues and their solutions:

Invalid API Key Error

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.

Rate Limit Exceeded

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.

Connection Timeout

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.