Skip to main content

Creating a Grok Agent

Estimated Time: 2 minutes

A Grok resource connects your agent to xAI Grok models using your own xAI API key. Predictable Dialogs supports the latest Grok models exposed in the model selector.

Before You Start​

You need an xAI API key.

  1. Open the xAI Console.
  2. Go to API Keys and create or copy a key.
  3. Make sure the account has credits and model access for the model you want to use.

Create From The Agents Page​

Step 1: Create New Agent​

  1. Sign in to Predictable Dialogs.
  2. Click + Create agent.
  3. Give a name to your agent.

Step 2: Configure Grok Settings​

  1. Click ADD AI.
  2. Select Grok as the provider.
  3. Select an existing Grok API key or enter a new xAI API key.
  4. Select the Grok model you want to use. The latest supported Grok models are listed in the model dropdown.
  5. Click Next to validate the key and model.

Step 3: Add The Instructions​

  1. Choose what your agent is for and adjust the personality and purpose.
  2. Click Next.
  3. Review or edit the agent behaviour instructions.
  4. Click Save to create the resource and connect it to your agent.

Understand The Instruction Hierarchy​

Agent instructions and Skill Instructions hierarchy

The Agent instructions section shown at the top is closed in the screenshot. It contains the provider and model details, along with the agent personality and purpose.

The Skill Instructions card contains the agent behaviour. It also contains Knowledge & actions and the Add button used to add documents, tools, and actions the agent can use. This separation is intentional: the agent personality stays separate from the skill, which defines what the agent knows how to do.

Next Steps​

  • Add knowledge and actions: Use the Tools overview to add searchable documents, API tools, app connections, or website payload actions to the agent skill.
  • Choose Channel: Embed your agent on your website or connect to WhatsApp.
  • Test Your Agent: Send test messages to verify everything works correctly.