---
title: Team
description: "hand_off, remember, make_agent and change_agent, for working with the owner's other agents."
tools: [hand_off, remember, make_agent, change_agent]
source: [packages/agents/src/tools/team.ts]
generated: true
---

> Roadstar docs for agents. Every page, as markdown: https://docs.roadstar.app/llms.txt

Tools for the owner's other agents. Any agent can hand work to any other, by name. Only Roadstar's chat makes and changes agents.

What they return:

- `hand_off`: `{ "handed": "Proposal writer", "answer": "comes back to you" }`. With `answer: "whoever asked me"`, the answer goes straight to whoever asked you, and your part is done.
- `remember`: the agent's notes as they now stand, `{ "notes": ["…"] }`. Only Roadstar has `about`, and saving it alone returns `{ "about": "saved" }`.
- `make_agent`: `{ "made": "Proposal writer", "next": "Hand it the work with hand_off." }`.
- `change_agent`: `{ "changed": "Proposal writer" }`. A change goes past the check first.

See [hand-offs](/how-it-works/hand-offs/), [agents and the chart](/how-it-works/agents/) and [making an agent](/use-cases/make-an-agent/).

## Where each is offered

| Tool | Roadstar's chat | An agent's chat | A thread | A Mac or outside app |
| --- | --- | --- | --- | --- |
| [hand_off](#hand_off) | Yes | Yes | Yes | Yes |
| [remember](#remember) | Yes | Yes | Yes | Yes |
| [make_agent](#make_agent) | Yes | — | — | — |
| [change_agent](#change_agent) | Yes | — | — | — |

## hand_off

What the agent reads, word for word:

> Give work to another of the owner's agents, by name: the task, notes and links to what it needs. It hasn't seen your chat. Its answer comes back to you; don't wait for it.

| Input | Type | Required | What it is | Limits |
| --- | --- | --- | --- | --- |
| `agent` | text | yes | The agent, by name |  |
| `task` | text | yes | What to do, in a sentence or two |  |
| `notes` | text | no | Facts it needs that no link holds: names, dates, choices |  |
| `links` | list of text | no | What to read, as mail:, file:, contact:, doc: or web: with the id or address a tool gave you |  |
| `answer` | one of `me`, `whoever asked me` | no | You by default; whoever asked you, when you pass their work on whole |  |

## remember

What the agent reads, word for word:

> Keep a short note on how the owner likes your work done, when they say remember or agree to one. Your threads read it too.

| Input | Type | Required | What it is | Limits |
| --- | --- | --- | --- | --- |
| `note` | text | no |  |  |
| `forget` | text | no | A note to drop, word for word |  |
| `about` | text | no | What every agent should know about the owner and the business (what it does, its site, customers, prices, voice), given whole, rewritten with what you learned |  |

## make_agent

What the agent reads, word for word:

> Make one agent for a lasting job, from a short job description. Then hand it the work that led to it with hand_off.

| Input | Type | Required | What it is | Limits |
| --- | --- | --- | --- | --- |
| `name` | text | yes |  |  |
| `job` | text | yes | Its job in one line |  |
| `owns` | text | yes | What it owns, in a line or two |  |
| `good` | text | yes | What good looks like |  |
| `works` | text | yes | When it works: as mail arrives, Fridays at 4 PM |  |
| `asksFirst` | text | yes | What it asks the owner before doing |  |
| `model` | one of `gpt-6-luna`, `gpt-6.1-terra`, `gpt-6.1-sol`, `gpt-6-astra` | no | Leave it out for the default. Luna is cheapest, for simple repeated work; Sol and Astra cost 2× and 10×, for harder judgement |  |
| `reportsTo` | text | no | Who it sits under on the chart, by name; Roadstar if none |  |
| `department` | text | no | Its department on the chart |  |

## change_agent

What the agent reads, word for word:

> Change an agent: its name, job, description, model, or where it sits on the chart.

| Input | Type | Required | What it is | Limits |
| --- | --- | --- | --- | --- |
| `agent` | text | yes | The agent, by name |  |
| `name` | text | no |  |  |
| `job` | text | no |  |  |
| `owns` | text | no | What it owns, in a line or two |  |
| `good` | text | no | What good looks like |  |
| `works` | text | no | When it works: as mail arrives, Fridays at 4 PM |  |
| `asksFirst` | text | no | What it asks the owner before doing |  |
| `model` | one of `gpt-6-luna`, `gpt-6.1-terra`, `gpt-6.1-sol`, `gpt-6-astra` | no | Leave it out for the default. Luna is cheapest, for simple repeated work; Sol and Astra cost 2× and 10×, for harder judgement |  |
| `reportsTo` | text | no | Who it sits under, by name |  |
| `department` | text | no |  |  |