Skip to content

Connectors

Connectors are external user accounts or data sources, such as Gmail, Calendar, Drive, and Notion.

Connector management is separate from model tools:

ts
const connectors = await configure.connectors.list(token);

When a connector is connected and allowed for the turn, enable its model tool explicitly:

ts
const tools = profile.tools({
  connectors: ["gmail", "calendar", "drive", "notion"],
});

Connector-backed model tools:

  • configure_gmail_search
  • configure_calendar_get
  • configure_drive_search
  • configure_notion_search

Actions are also explicit:

ts
const tools = profile.tools({
  actions: ["email.send", "calendar.create_event"],
});

Action model tools:

  • configure_email_send
  • configure_calendar_create_event

Do not expose action tools unless the user grant and your product policy allow the action for that turn.

Personalization infrastructure for agents