> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognigy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Copilot Configuration

> Learn how to configure Agent Copilot with an AI Agent, Voice Gateway, and contact center integration.

To integrate Agent Copilot with an AI Agent, you need to configure different components:

* [Agent Copilot](#agent-copilot)
* [Voice Gateway](#voice-gateway), for voice implementations.
* [Contact center integration](#contact-center-integration)

## Agent Copilot

The Agent Copilot configuration includes:

<AccordionGroup>
  <Accordion title="Agent Copilot Flow">
    The Agent Copilot Flow is a Flow separate from the AI Agent Flow to which you add Agent Copilot Nodes. The Copilot: Set Grid Node is required in this Flow to set the workspace arrangement on the contact center side and the widgets in the workspace. Other Agent Copilot Nodes provide functionality to the widgets in the workspace.
  </Accordion>

  <Accordion title="Agent Copilot Grid">
    The Agent Copilot Grid is a JSON object you can configure in the [Copilot: Set Grid Node](/ai/agents/develop/node-reference/agent-copilot/set-grid) that defines the layout of the Agent Copilot workspace. For more information, see [Configure the Workspace](/agent-copilot/configure/workspace).
  </Accordion>

  <Accordion title="Agent Copilot URL">
    To view the Agent Copilot workspace in the contact center interface, configure the Agent Copilot URL. The workspace is rendered at this URL as soon as the handover is triggered.

    To configure the URL, use the following format:

    `https://${AgentCopilotBaseUrl}/?userId=${userId}&sessionId=${sessionId}&URLToken=${URLToken}`

    Where:

    * `AICopilotBaseUrl` — the base URL used to access the Agent Copilot workspace.
    * `sessionId` — the Cognigy session ID. A session represents the interaction between the human agent and the Agent Copilot workspace.
    * `userId` — the Cognigy user ID. It helps Agent Copilot associate the interaction with a specific user.
    * `URLToken` — the Endpoint token from Cognigy.AI. The Endpoint must be linked to the Handover Flow. To find this token, go to the Endpoint that you created previously. In the **Endpoint URL** field, copy the token after `https://endpoint-trial.cognigy.ai/`. For example, in the URL `https://endpoint-trial.cognigy.ai/f38791ae20d4961acf0e97d9f377c4fe3df92894e1eff1c7a774a8ed089a4590`, the token is `f38791ae20d4961acf0e97d9f377c4fe3df92894e1eff1c7a774a8ed089a4590`. Only authorized users can access the Agent Copilot system through this URL.

    Example URL:

    ```txt wrap theme={null}
    https://ai-copilot-trial.cognigy.ai/?sessionId=session123&userId=user123&URLToken=a4d5c86c98f27730311591f28d194510e05ffed30ca148e3344970defd418e7d
    ```

    You need this URL for further steps in the [Deployment section](/agent-copilot/deploy/overview) where you choose how you want to deploy your Agent Copilot workspace.
  </Accordion>
</AccordionGroup>

## Voice Gateway

For voice implementations, you need to configure:

<AccordionGroup>
  <Accordion title="Voice Gateway Endpoint">
    Set up a [Voice Gateway Endpoint](/ai/agents/deploy/endpoint-reference/voice-gateway) and [application](/voice-gateway/webapp/applications) to connect the AI Agent to Voice Gateway, and Voice Gateway to the contact center.
  </Accordion>

  <Accordion title="Voice Copilot Endpoint">
    The [Voice Copilot Endpoint](/ai/agents/deploy/endpoint-reference/voice-copilot) receives the transcript of the voice call and sends it to the Agent Copilot Flow.
  </Accordion>
</AccordionGroup>

## Third-Party Platform Integration

You can integrate Agent Copilot with a third-party platform in the following ways:

<AccordionGroup>
  <Accordion title="Handover to Human Agents">
    For chat applications, you need to configure the handover to human agents by adding a [Handover to Human Agent Node](/ai/agents/develop/node-reference/service/handover-to-agent) to the AI Agent Flow and by using the [Copilot section](/agent-copilot/configure/copilot-section) in the Endpoint settings.
  </Accordion>

  <Accordion title="Call Transfer to Human Agents">
    To transfer calls from the AI Agent to human agents, you need to configure the call transfer by adding a [Transfer Node](/ai/agents/develop/node-reference/voice/voice-gateway/transfer) to the AI Agent Flow.
  </Accordion>
</AccordionGroup>

Both implementations require a [handover provider](/ai/escalate/handover-reference/overview) that supports the contact center platform you use.

## More Information

* [Agent Copilot Workspace](/agent-copilot/overview)
* [Getting started with Agent Copilot for Chat](/agent-copilot/getting-started/chat)
* [Getting started with Agent Copilot for Voice-to-Chat](/agent-copilot/getting-started/voice-to-chat)
* [Getting started with Agent Copilot for Voice](/agent-copilot/getting-started/voice)
* [Agent Copilot Nodes](/ai/agents/develop/node-reference/agent-copilot/overview)