Teammates

A teammate is a reusable agent definition. You configure it once, then trigger runs as often as you need.

Create a teammate

Key fields

FieldTypeDescription
namestring (required)Teammate name
instructionsstringCore behavior and context
toolsstring[]Allowed tools for this teammate
rolestringOptional persona role
goalsstringOptional goals injected into prompt context
user_idstringEnd-user scope. See Users
allowed_sendersstring[]Allowed addresses or @domain patterns for email triggers

Triggering runs from teammates

Introduction

A teammate can be triggered in three ways: a direct message, inbound email, or webhook.

Message

Use direct messages when your app already has user input and needs immediate output.

Python

Email Inbox

Use email inbox when email itself should trigger the run.

Webhook

Use webhook when an external system should trigger runs over HTTP.

Manage teammates

Python

What's next

  • Runs for streaming, follow-ups, and status handling
  • Tasks for reusable job definitions and triggers
  • Tools for app and integration setup