How to Connect Runway to an AI Agent: Step-by-Step Guide

· DoubleX

Quick answer

To connect Runway to an AI agent, open the Connectors screen in DoubleX Agentes, add Runway, and sign in to your Runway account. Then choose which agents can use the connection and run a test request. The models available depend on what your Runway account includes.

Runway is a platform for generating images and videos with AI models. Connecting it to an AI agent lets your team ask for visuals in plain language, without opening another tool. This guide walks through the full path: linking your Runway account, deciding who can use it, and checking that it works.

What can the Runway connector do?#

The Runway connector lets an agent generate images and videos using the AI models available in your Runway account. The agent sends the request, and the result comes back inside the task.

Typical uses include:

  • Creating a cover image for a blog post or campaign.
  • Generating a short video clip from a text description.
  • Producing several visual variations so the team can pick one.

An agent can also combine Runway with other connectors. For example, it can read a brief in Google Docs and then generate the matching visuals.

What do I need before connecting?#

You need a DoubleX Agentes account, at least one agent, and an active Runway account you can sign in to. Creating a DoubleX Agentes account is free and requires no card.

Check these points first:

ItemWhy it matters
Runway accountThe connection uses your account, so you need your login.
Models in your planThe models the agent can use depend on your Runway account.
An existing agentYou will release the connector to a specific agent.
Admin or owner role (if sharing with the company)Shared connections should be set up by someone who can manage them.

How do I connect Runway on the Connectors screen?#

You connect Runway from the Connectors screen by adding it to the list and authorizing your Runway account. The steps are:

  1. Sign in to DoubleX Agentes and open Connectors.
  2. Find Runway in the design category and select it.
  3. Choose the scope of the connection: personal, team, or company.
  4. Sign in to your Runway account when prompted and approve the access.
  5. Back in DoubleX Agentes, confirm that Runway appears as connected.

If you want to manage connectors programmatically, see the Connectors API reference. For a similar flow with another tool, the guide on how to connect Box to an AI agent follows the same logic.

How do I choose which agents and people can use the connection?#

In DoubleX Agentes, you choose for each agent which systems it can use and which actions it can run in each one. Connecting Runway does not automatically give every agent access to it.

  1. Open Agents and select the agent that should generate visuals.
  2. Add the Runway connector to that agent.
  3. Review the actions allowed for Runway and turn off any you do not want.
  4. Save the agent.

For shared connections, access follows the sharing level you set: person, team, or company. Roles (owner, administrator, and member) control who can change these settings.

To keep a record of what happened, open Tasks. Every request has a full history: who asked, which tools the agent used, and the result.

How do I test with a first image or video request?#

Send a short, specific request to the agent and check the result in the task. Start with an image, since it is simpler to evaluate than a video.

Examples you can copy:

  • "Generate a clean, minimalist image of a laptop on a wooden desk, soft morning light, for a blog header."
  • "Create three variations of a product banner with a blue and white palette and no text."
  • "Generate a 5-second video of waves on a beach at sunset, calm and cinematic."
  • "Using the brief in the document I shared, suggest a visual concept and generate one image for it."

When the task finishes, open the result and check it against your request. Files delivered by the agent can appear in Artifacts, where you can share them with a person, a team, the company, or by link. For a deeper look at prompts and results, read Runway with an AI agent: generate images and videos by prompt.

What should I do if the connection does not work?#

Most problems come from the account, the permissions, or the model you asked for. Work through this list:

SymptomWhat to check
Runway does not show as connectedRepeat the sign-in and approve the access again.
The agent says it cannot use RunwayConfirm the connector is added to that agent and the actions are enabled.
A model is not availableThe models depend on your Runway account, so check what your account includes.
A teammate cannot use itCheck whether the connection is personal or shared with their team.
The result is not what you wantedMake the request more specific and try again.

If you are still stuck, the Quickstart covers the basic setup flow from the beginning.

Frequently asked questions#

Do I need a Runway account to use the connector?#

Yes. The connector uses your Runway account, so you need to sign in and approve access. The models the agent can use depend on what that account includes.

Can I limit which agents use Runway?#

Yes. You choose, for each agent, which systems it uses and which actions it can run in each one. An agent without the Runway connector cannot generate visuals.

Is the connection personal or shared?#

It can be either. A connection can be personal, for a team, or for the whole company, depending on how you set it up.

Where can I see what the agent generated?#

Every request is saved as a task with its full history, including the tools used and the result. Delivered files can also appear in Artifacts.

Does the agent ask for confirmation?#

Before sending, deleting, or changing something in your systems, the agent asks for confirmation and shows what it did step by step.

Related guides

More Runway guides