Create Custom Agents

Build custom AI agents in Nebula to automate specific tasks, workflows, or app integrations. Create them in chat or from the Agents page.

You can create custom agents in Nebula to handle specific tasks, workflows, or app integrations. Custom agents work on your behalf — Nebula delegates to them automatically when their skills are relevant.

The easiest way: just ask

The simplest way to create a custom agent is to describe what you need in chat:

You

Create an agent that monitors my GitHub repositories for new pull requests and summarizes them.

Create Agent

Creating GitHub PR Monitor agent with GitHub and web search capabilities.

Nebula

Done! Your GitHub PR Monitor agent is ready. It can watch your repos for new pull requests and generate summaries.

Nebula will create the agent, configure its tools, and connect it to the right apps — walking you through any setup steps needed.

What gets configured

Name and description — A short name and summary of what the agent does. This helps Nebula know when to delegate tasks to it.

System prompt — Instructions that shape the agent's behavior, tone, and focus. Nebula generates this based on your description. See System Prompts.

Model — The AI model powering the agent. Change it anytime by clicking the model badge on the detail page. See Choosing a Model.

Tools — The APIs and services the agent can call (e.g., Web Search, Code Execution, Sentry API). See Tools & Connected Apps.

Variables — Secrets or configuration values the agent needs (e.g., API tokens). Add and manage these from the detail page.

Connected apps — Third-party services the agent can access (e.g., GitHub, Gmail, Slack). See Connecting apps below.

Linked triggers — Any automations connected to this agent.

Connecting apps

Agents become much more powerful when connected to your apps and services. Nebula supports two methods:

The most common and secure way to connect. Nebula supports OAuth for 600+ apps including Gmail, GitHub, Slack, Google Calendar, Notion, Shopify, Linear, Discord, and more.

Go to Integrations in the sidebar and search for the app.

Click Connect — you'll be redirected to the app's authorization page.

Review the permissions and approve. The connection is established immediately.

To review or revoke permissions, find the connected app in Integrations and click the expand button.

For services that don't support OAuth (e.g., Sentry, custom APIs, internal tools).

Generate an API key in the third-party service's settings.

Enter it in the secure credential input form when prompted by Nebula, or add it as a Variable on the agent's detail page.

To rotate a key, update the variable with the new value. The agent uses it immediately.

Never paste API keys into a chat message. Always use the variable configuration form on the agent's detail page.

For details on how permissions work, see Permissions.

After creating an agent

Appears in your Agents list under Your Agents.

Is available for Nebula to delegate to automatically.

Can be invoked directly by mentioning it in chat.

Can be used as a step in automated triggers.

You

Ask my GitHub agent to list open pull requests.

List Pull Requests@github-agent

Found 7 open pull requests across your repositories.

Editing and deleting agents

To edit an agent, click it in the Agents list and update its settings. To delete an agent, open it and select Delete. Deletion is permanent — the agent's configuration is removed, though any work it has already completed is preserved in your task history.

Not sure how to configure your agent? Ask Nebula to do it for you — it has tools to create and modify agents directly.

Create Custom Agents

The easiest way: just ask

What gets configured

Connecting apps

After creating an agent

Editing and deleting agents

What's next?

System Prompts

Tools & Connected Apps

Permissions

Agent Memory

On this page