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

# Pipecat Simulations

> Test your Pipecat Cloud agent.

Connect an agent you deployed to Pipecat Cloud, then run simulated calls on it without a phone number.

![The Pipecat connection fields with a saved Pipecat API key and a Pipecat agent name](https://mintcdn.com/bluejay/EeUk0hD_moG9tWmI/images/connect-pipecat.png?fit=max\&auto=format\&n=EeUk0hD_moG9tWmI\&q=85\&s=96a7023275f3bea19e36c466fcb24d3a)

## Connect

**1. Deploy the agent**

Deploy your agent to Pipecat Cloud with the [Pipecat quickstart](https://docs.pipecat.ai/getting-started/quickstart). Note the agent name in `pcc-deploy.toml`.

**2. Add a public API key**

In the Pipecat dashboard, open **API Keys** and create a key on the **Public** tab. In Bluejay, open **Settings → Integrations** and choose the **Pipecat** tab. Paste the key there. A private key does not work: Bluejay needs a key that starts with `pk_`.

**3. Create the agent**

Create an Inbound Voice agent with the **Pipecat** connection type, and enter the agent name as **Pipecat Agent Name**. The **Pipecat** connection supports inbound agents only.

## Fields

For each simulated call, Bluejay starts a session for your agent in a Daily room and joins the room as a Digital Human. After you create the agent, you can set two more fields in its **Connection Settings**:

* **Pipecat Agent Configuration**: JSON that Bluejay sends to your agent as `body` on start.
* **Pipecat Room Properties**: JSON that Bluejay merges into the Daily room properties.

To report tool calls from a simulation, have your bot read its result ID from `args.body`. Bluejay adds the simulation IDs (`X-Simulation-Result-Id` and the other `X-` keys) to the `body` it sends on start. Then send the tool calls to [`/v1/update-simulation-result`](/api-reference/endpoint/update-simulation-result).

## Troubleshooting

| Symptom | Fix |
| - | - |
| **No Connection** with PIPECAT\_CONNECTION\_FAILED | The Pipecat session stopped before audio started. Make sure the saved key starts with `pk_`. |
| Run fails at start | Save a Pipecat key, and set **Pipecat Agent Name** on the agent. |

## Related

* [Agents API](/api-reference/endpoint/add-agent.md)
* [Agents MCP tools](/mcp/testing-tools.md#agents)
* [Agents](/test/simulations/create.md#connect-your-agent)
* [Simulation](/test/simulations/create.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.