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

# Agent Identity

> Configuring the identity of an agent within the GenerativeAgent framework.

The Agent Identity section allows you to define and manage the unique characteristics and attributes of the agent that interacts with your customer. This includes setting the agent's name, role, model and other identifying information.

To access the Agent Identity section, navigate to **Identity** under **Build** in the left sidebar of the CXP.

In this section, you will configure:

* [General Information](#general-information)
* [Safety Attributes](#safety-attributes)
* [Voice Configuration](#voice-configuration)
* [Chat Configuration](#chat-configuration)
* [Integration Settings](#integration-settings)

## General Information

The General Information section allows you to specify the basic identifying details of the agent, such as:

* **Company name**: The name of the company the agent represents.
* **Greeting**: The initial message or salutation used by the agent when interacting with customers.
* **Live agent name**: How the live agent is referred to during interactions with customers (e.g., "Support agent", "Team member", etc.)

<Frame>
  <img src="https://mintcdn.com/asapp/PBABazre87WaI4tX/images/generativeagent/agent-identity-general-information.png?fit=max&auto=format&n=PBABazre87WaI4tX&q=85&s=bb5137cb192d1ed31adccdc28551f4ac" alt="Agent Identity - General Information" width="2782" height="1620" data-path="images/generativeagent/agent-identity-general-information.png" />
</Frame>

## Safety Attributes

The Safety section allows you to add **Input Guardrails**, which are topics or content that the agent is allowed to discuss or respond to during interactions with customers. This helps ensure that the agent maintains appropriate and safe communication at all times.

To add an Input Guardrail, click on the **Add** button and specify:

* **Name**: A unique name that should reflect the main theme of the content (e.g., "Stocks", "Cancellations", etc).
* **Description**: A brief description that will help the agent understand the context and limitations of the content.
* **Example Conversation**: An example dialogue that illustrates how the agent should handle the topic or content within the guardrail. (e.g., "Customer: I want to cancel my subscription. Agent: Sure, I can help you with that.")
* **Example Explanation**: An explanation of why the example conversation is appropriate and how it aligns with the input guardrail.

You can add up to three examples. Once the examples are added, click the **Save** button.

<Frame>
  <img src="https://mintcdn.com/asapp/PBABazre87WaI4tX/images/generativeagent/agent-identity-safety-attributes.png?fit=max&auto=format&n=PBABazre87WaI4tX&q=85&s=0eb74accdeb79a25f7c765b36773c96c" alt="Agent Identity - Safety Attributes" width="1278" height="1488" data-path="images/generativeagent/agent-identity-safety-attributes.png" />
</Frame>

## Voice Configuration

The Voice Configuration section allows you to set up the agent's voice and the Agent Version.

### Agent Version

This setting allows you to specify Company-wide voice prompts and the version of the models that will be used during interactions with customers. You can swap between the different versions as needed.

You can also enable **"Always use latest stable version"** if you want the agent to automatically use the most recent stable version of the model.

Expand the Agent Version setting to configure:

<AccordionGroup>
  <Accordion title="Company-wide voice prompt">
    When enabled, GenerativeAgent uses the following company-wide prompts to guide its voice responses instead of task-specific prompts.

    * **Voice instructions**: Instruct the agent on how to use its voice during interactions with customers (e.g., tone, pitch, speed).
    * **Time-buying filler instructions**: Instruct the agent on how to use filler phrases to buy time during conversations (e.g., "Let me check that for you", "One moment please").
    * **Empathy instructions**: Instruct the agent on how to express empathy during interactions with customers.
    * **Backchanneling instructions**: Instruct the agent on how to use backchanneling cues (e.g., "I see", "Uh-huh") to show active listening.
  </Accordion>

  <Accordion title="Configure Models used">
    Configure the models used for the following functions:

    * safety
    * scope
    * task\_selector
    * task\_reasoner
    * output\_safety\_llm\_hallucination
    * output\_safety\_llm\_phenomena
    * output\_safety\_llm\_toxic

    Expand each section to configure the model information such as:

    * **Provider**: The provider of the model (e.g., OpenAI, Anthropic).
    * **Model**: The model used (e.g., GPT-4, Claude v1).
    * **LLM arguments**: The arguments passed to the model.
      ```json theme={null}
          {
           "max_tokens": 12,
           "temperature": 0,
           "extra_body": {
               "timeout": 5,
               "fallbacks": [
               "claude-4.5-sonnet"
               ]
           },
           "llm_client_config_override": {
               "retry_mechanism": "hedged",
               "client_max_retries": 3,
               "hedge_delay": 2.5,
               "hedge_concurrent_requests": 2
           }
           }
      ```
    * **Retry model settings**: The arguments passed to the model to handle retries.
    * **Maximum retry attempts**: The maximum number of times the model will retry.

    You can enable "B Variant" if you want the model to use the alternative variant for testing.
  </Accordion>
</AccordionGroup>

<Frame>
  <img src="https://mintcdn.com/asapp/PBABazre87WaI4tX/images/generativeagent/agent-identity-voice-configuration.png?fit=max&auto=format&n=PBABazre87WaI4tX&q=85&s=84f020e889d485ceffd83d68bc36bd80" alt="Agent Identity - Voice Configuration" width="2766" height="1432" data-path="images/generativeagent/agent-identity-voice-configuration.png" />
</Frame>

### Voice Selection

Select the voice for the agent from the available options. You can preview each voice before making a selection.

<Frame>
  <img src="https://mintcdn.com/asapp/PBABazre87WaI4tX/images/generativeagent/agent-identity-voice-selection.png?fit=max&auto=format&n=PBABazre87WaI4tX&q=85&s=48bcc8243586f3179e15585177aa958f" alt="Agent Identity - Voice Selection" width="1202" height="1630" data-path="images/generativeagent/agent-identity-voice-selection.png" />
</Frame>

## Chat Configuration

Configure the models used for the following functions during a chat interaction:

* safety
* scope
* filler
* task\_selector
* task\_variant\_kb\_aware
* output\_safety\_llm\_hallucination
* output\_safety\_llm\_phenomena
* output\_safety\_llm\_toxic
* question\_extractor

Expand each section to configure the model information such as:

* **Provider**: The provider of the model (e.g., OpenAI, Anthropic).
* **Model**: The model used (e.g., GPT-4, Claude v1).
* **LLM arguments**: The arguments passed to the model.
  ```json theme={null}
      {
       "max_tokens": 12,
       "temperature": 0,
       "extra_body": {
           "timeout": 5,
           "fallbacks": [
           "claude-4.5-sonnet"
           ]
       },
       "llm_client_config_override": {
           "retry_mechanism": "hedged",
           "client_max_retries": 3,
           "hedge_delay": 2.5,
           "hedge_concurrent_requests": 2
       }
       }
  ```
* **Retry model settings**: The arguments passed to the model to handle retries.
* **Maximum retry attempts**: The maximum number of times the model will retry.

You can enable "B Variant" if you want the model to use the alternative variant for testing.

<Frame>
  <img src="https://mintcdn.com/asapp/PBABazre87WaI4tX/images/generativeagent/agent-identity-chat-configuration.png?fit=max&auto=format&n=PBABazre87WaI4tX&q=85&s=4071e8a583bbb95933f52d9aa3e8cfa2" alt="Agent Identity - Chat Configuration" width="2788" height="1542" data-path="images/generativeagent/agent-identity-chat-configuration.png" />
</Frame>

## Integration-settings

Configure HILA integration and other third-party integrations with sensitive API keys.

### Sensitive API Keys

Add the names of of any API fields that contain sensitive customer data. Once added, the Sensitive data protection toggle in Safety controls whether filtering is active.

To add a sensitive API key, click the "Add" button, enter the name of the API field, and click "Add" again.

### HILA Configuration

HILA (Human-in-the-Loop AI) allows you to integrate human oversight into the agent's decision-making process. You can configure HILA settings to manage the following aspects of contact center interactions:

<AccordionGroup>
  <Accordion title="Timeout Settings">
    Configure the timeout settings for HILA interactions, including:

    * **Maximum wait time for live agent response**
    * **Live agent assignment limit**
    * **Live agent inactivity timeout**
    * **Live agent connectivity check interval**

    <Frame>
      <img src="https://mintcdn.com/asapp/PBABazre87WaI4tX/images/generativeagent/agent-identity-hila-timeout-settings.png?fit=max&auto=format&n=PBABazre87WaI4tX&q=85&s=b8b356f4ffd180387d2799f727102bc1" alt="Agent Identity - HILA Timeout Settings" width="2690" height="664" data-path="images/generativeagent/agent-identity-hila-timeout-settings.png" />
    </Frame>
  </Accordion>

  <Accordion title="HILA Routing Rules">
    Define the routing rules for routing config entry used for CCaaS routing attributes, including:

    * **Label**: The label for the routing rule. (e.g., hila\_agent)
    * **Value**: The value associated with the routing rule. (e.g., hila\_agent\_value)
    * **Default Value**: The default value for the routing rule if no specific value is set.
    * **Description**: A brief description of the routing rule and its purpose.

    <Frame>
      <img src="https://mintcdn.com/asapp/PBABazre87WaI4tX/images/generativeagent/agent-identity-hila-routing-rules.png?fit=max&auto=format&n=PBABazre87WaI4tX&q=85&s=c4c641618180ac921c448920d8e8f455" alt="Agent Identity - HILA Routing Rules" width="1272" height="1026" data-path="images/generativeagent/agent-identity-hila-routing-rules.png" />
    </Frame>
  </Accordion>

  <Accordion title="Cutomer Info Attribute Allowlist">
    Define the customer information attributes that will be passed to the agent during interactions. Click on the "Add" button to add a new attribute, and specify the attribute name.
  </Accordion>

  <Accordion title="Secure Forms">
    Enable Secure Forms to ensure that sensitive customer information are collected and transmitted securely during interactions. You can enable or disable Secure Forms to be used in voice and chat interactions.

    <Frame>
      <img src="https://mintcdn.com/asapp/PBABazre87WaI4tX/images/generativeagent/agent-identity-hila-secure-forms.png?fit=max&auto=format&n=PBABazre87WaI4tX&q=85&s=279cdc175c7bbd22fbc0c44ec7868adb" alt="Agent Identity - HILA Secure Forms" width="2708" height="308" data-path="images/generativeagent/agent-identity-hila-secure-forms.png" />
    </Frame>
  </Accordion>

  <Accordion title="Business Hours">
    Configure the business hours for the agent, including:

    * **Time zone**: The time zone in which the business hours are defined.
    * **Business hours**: The specific hours during which the agent is available to interact with customers. You can set different hours for each day of the week.

    <Frame>
      <img src="https://mintcdn.com/asapp/PBABazre87WaI4tX/images/generativeagent/agent-identity-hila-business-hours.png?fit=max&auto=format&n=PBABazre87WaI4tX&q=85&s=219fedd5106235e1123d5c3cad247cb4" alt="Agent Identity - HILA Business Hours" width="1278" height="1482" data-path="images/generativeagent/agent-identity-hila-business-hours.png" />
    </Frame>
  </Accordion>

  <Accordion title="Ccaas Configuration">
    Select the type of CCaaS configuration you want to use for the agent. You can choose the configuration for sandbox or production environments.
  </Accordion>
</AccordionGroup>

## Deployment

Once you have configured the agent's identity, you can deploy the agent to your desired environment.

To deploy the agent:

1. Click on the **Deploy** button in the top right corner of the CXP.
2. Select the environments where you want to "Deploy from" and "Deploy to" (e.g., Sandbox, Production).
3. In the **Release Notes** section, provide a brief description of the changes made to the agent's identity.
4. In the **Resources** section, select **Agent Identity** under **General Configuration** to include the agent's identity configuration in the deployment.
5. Click on the **Deploy** button to initiate the deployment process.

## Next Steps

<CardGroup>
  <Card title="Add a use case " href="/generativeagent/build/adding-a-use-case">
    <p>Learn how to add a use case for your agent, defining the specific scenarios and interactions it will handle.</p>
  </Card>

  <Card title="Connect your Knowledge base" href="/generativeagent/configuring/connecting-your-knowledge-base">
    <p>Learn how to configure the knowledge base for your agent, including adding, updating, and managing knowledge articles.</p>
  </Card>
</CardGroup>
