Skip to main content

​
Overview

Apigene Copilot is an AI-powered conversational interface that enables you to interact with multiple applications, APIs, and services using natural language. Instead of writing code or making manual API calls, simply describe what you want to accomplish, and Copilot will execute the necessary actions.
Copilot home screen with Chat and Agent Builder toggle
Copilot can run tools live and render structured results (for example, a searchable table of GitHub commits):
Copilot chat showing generative UI table of GitHub commits

​
Key Features

​
Multi-Application Support

  • Connect and interact with multiple applications simultaneously
  • Execute complex workflows across different services
  • Seamlessly switch between applications in a single conversation

​
Intelligent Tool Selection

  • Automatic selection of the right tools and APIs based on your request
  • Context-aware recommendations for API operations
  • Smart parameter detection and validation

​
Real-Time Execution

  • Live execution of API calls with streaming responses
  • View request and response data in real-time
  • Monitor tool invocations as they happen

​
Agent Builder Mode

A dedicated mode for creating and configuring agents — not for everyday chat. Agent Builder walks you through discovering integrations, drafting instructions, attaching skills, validating config, and presenting setup cards. Use Chat to talk to your apps and agents. Use Agent Builder to define agents as resources. See the full Agent Builder guide for workflows, examples, and when to use each mode.

​
Model Selection

Choose from multiple AI model providers configured in Settings:
  • OpenAI — GPT models
  • Anthropic — Claude models
  • Google — Gemini models
  • xAI — Grok models
  • Amazon Bedrock — AWS-hosted models (IAM credentials)
  • Microsoft Foundry — Azure OpenAI deployments
The model selector supports search and collapsible provider groups when you have many models configured.

​
Reasoning Models

For models that support extended thinking, Copilot can show a reasoning panel alongside the response. Organization admins set Reasoning Effort (None, Low, Medium, High) under Settings → Organization → Model Settings.

​
Getting Started

​
Starting a New Chat

  1. Navigate to the Copilot page from the main navigation
  2. Choose Chat or Agent Builder with the mode toggle on the home screen
  3. Type your request in the message input at the bottom
  4. Press Enter or click Send to start the conversation

​
Onboarding Checklist (Trial Users)

New trial users see a getting started checklist on the home screen. It tracks progress toward:
  1. Configuring a model provider (API key)
  2. Installing and configuring an application
  3. Creating your first agent
Dismiss the checklist when you no longer need it, or follow the links to complete each step. Agent Builder is the fastest path to step 3 — see Agent Builder.

​
Your First Query

Try these example queries to get started:
  • “List all my GitHub repositories”
  • “Create a new Jira issue for the bug I found”
  • “Send a message in Slack to the #engineering channel”
  • “Get my last 10 emails from Gmail”

​
Selecting AI Model

  1. Click the model selector in the top bar
  2. Choose from available models based on your needs:
    • Fast models: Quick responses for simple tasks
    • Powerful models: Complex reasoning and multi-step workflows
    • Balanced models: Good balance of speed and capability

​
Chat Features

​
Tool Invocations

When Copilot executes actions, you’ll see:
  • Tool name and description: What action is being performed
  • Parameters: The data being sent to the API
  • Status indicators: Success, loading, or error states
  • Response data: Full results from the API call

​
Message Actions

Each message supports:
  • Copy: Copy message content to clipboard
  • Regenerate: Re-run the AI response with same context
  • Edit: Modify your previous message
  • Branch: Create a new conversation from this point

​
File Attachments

Upload files to enhance your conversations:
  1. Click the attachment icon in the message input
  2. Select files from your computer
  3. Copilot analyzes and uses the file content in responses
Supported formats: images (image/*), PDF (.pdf), plain text and code files (text/*), and other readable text-based files. Binary files that cannot be read as text prompt you to describe what you need instead.
File attachments are available in Chat mode. Agent Builder focuses on agent configuration rather than file analysis.

​
Mentions

Reference specific resources in your messages:
  • @agents: Invoke a specific agent to handle the request
  • @context: Include context items in the conversation
  • @threads: Reference previous conversation threads

​
Commands (Saved Prompts)

Reuse frequent prompts without retyping them. Commands are personal saved prompts you can insert into chat. Create a command
  1. Type a prompt in the chat input
  2. Click the bookmark button to open Save command
  3. Give it a name, optionally bind an agent, and save
You can also manage commands under Settings → Personal → Commands (add, edit, or delete). Use a command
  1. Type / in the chat input
  2. Search or select a saved command
  3. The prompt is inserted (and the bound agent is mentioned when one is attached)
Commands are stored in your personal settings and follow you across chats.

​
Follow-up Suggestions

When enabled, Copilot shows short Continue with chips under the latest assistant reply. Click a chip to send that follow-up as your next message. Enable or disable under Settings → Personal → Chat → Follow-up suggestions. Off by default.

​
Message Queue

While Copilot is still streaming a reply, you can keep typing and send the next message. Queued messages appear above the input (up to 5 per thread). You can:
  • Remove a queued message before it sends
  • Send now to interrupt the current run and flush that message when ready
If the queue is full, wait for a slot or remove an item before adding another.

​
Use Case Proposals

In Chat and Agent Builder, ask Copilot to suggest concrete use cases for your apps (for example, “Suggest use cases for Jira and Slack”). Copilot can show a use case proposals card you can review and act on, similar to skill proposal cards in Agent Builder.

​
Chat Preferences

Open Chat Preferences (shortcut ⇧⌘L / Shift+Cmd+L on supported layouts) to personalize how Copilot behaves in chat:
  • User instructions / personalization — how you want to be addressed, role, traits, and related fields
  • MCP instructions — optional per-MCP-server customization for tool behavior
  • Base system prompt — personal base prompt applied across chats
These preferences are personal. Organization model keys and policies still come from Settings.

​
Tool Control

​
Tool Choice Modes

Control how Copilot uses tools: Auto (Default)
  • AI automatically decides when to use tools
  • Best for most use cases
  • Balances efficiency and accuracy
Required
  • Forces the AI to use at least one tool
  • Ensures API interactions happen
  • Good for action-focused tasks
None
  • Disables all tool usage
  • Pure conversational mode
  • Use for questions and planning

​
Selecting Applications

Choose which applications Copilot can access:
  1. Click the applications dropdown in the top bar
  2. Select or deselect applications
  3. Only selected applications will be available for the conversation
  4. Leave empty to allow access to all configured applications

​
Advanced Features

​
Multi-Step Workflows

Copilot can execute complex multi-step operations:
The AI will:
  1. Create the GitHub issue
  2. Extract the issue URL from the response
  3. Post to Slack with the URL included

​
Context Awareness

Copilot maintains context throughout the conversation:
  • References to previous messages
  • Remembers data from earlier tool invocations
  • Builds on previous results

​
Error Handling

When errors occur:
  • Clear error messages explain what went wrong
  • Suggestions for how to fix the issue
  • Option to retry with corrected parameters

​
Best Practices

​
Writing Effective Prompts

Be Specific
  • ❌ “Get my data”
  • ✅ “Get all issues created in the last week from Jira”
Include Context
  • ❌ “Update the issue”
  • ✅ “Update issue PROJ-123 to set status to ‘In Progress’”
Break Down Complex Tasks
  • Instead of one complex request, use multiple specific requests
  • Let Copilot handle each step and verify results

​
Managing Conversations

Create New Threads
  • Start new conversations for unrelated topics
  • Keep conversations focused on a single workflow
  • Use descriptive titles for easy reference
Use Mentions
  • Mention specific agents for specialized tasks
  • Reference context items for consistent data
  • Link related conversation threads

​
Performance Tips

Choose the Right Model
  • Use faster models for simple queries
  • Reserve powerful models for complex reasoning
  • Consider cost and response time tradeoffs
Limit Application Scope
  • Select only relevant applications
  • Reduces tool selection overhead
  • Improves response accuracy

​
Keyboard Shortcuts

  • Cmd/Ctrl + Enter: Send message
  • Cmd/Ctrl + K: Open command palette
  • /: Open saved commands (when the input is a slash command)
  • Shift + Cmd/Ctrl + L: Open Chat Preferences (when available)
  • Escape: Cancel current operation
  • ↑: Edit previous message

​
Troubleshooting

​
Copilot Not Responding

  • Check your internet connection
  • Verify API keys are configured
  • Try refreshing the page

​
Wrong Tool Selected

  • Be more specific in your request
  • Mention the application name explicitly
  • Check that the right applications are enabled

​
Authentication Errors

  • Verify application credentials in Settings
  • Check if tokens have expired
  • Reconfigure the application security settings

​
Next Steps