Skip to content

docs(agent): mark crew attribute as optional in Agent schema#4918

Open
BillionClaw wants to merge 1 commit into
crewAIInc:mainfrom
BillionClaw:clawoss/docs/crew-optional-4730
Open

docs(agent): mark crew attribute as optional in Agent schema#4918
BillionClaw wants to merge 1 commit into
crewAIInc:mainfrom
BillionClaw:clawoss/docs/crew-optional-4730

Conversation

@BillionClaw
Copy link
Copy Markdown

@BillionClaw BillionClaw commented Mar 17, 2026

The crew attribute in BaseAgent has default=None in the Field definition, making it optional. However, the docstring listed it as crew (Any) without indicating optionality, and it was missing from the documentation table entirely.

Changes:

  • Update BaseAgent docstring to show crew (Any | None)
  • Add crew attribute to agents.mdx documentation table with _(optional)_ marker

Note

Low Risk
Documentation-only change that clarifies BaseAgent.crew can be None; no runtime logic is modified.

Overview
Clarifies that an agent’s crew reference is optional.

Updates the BaseAgent docstring type to Any | None and adds crew to the Agents docs attribute table as Optional[Crew] with an optional marker, noting it’s set automatically when added to a crew.

Written by Cursor Bugbot for commit 072d65c. This will update automatically on new commits. Configure here.

The crew attribute in BaseAgent has default=None, making it optional,
but the docstring and documentation table did not indicate this.

- Update BaseAgent docstring to show crew (Any | None)
- Add crew attribute to agents.mdx documentation table with _(optional)_ marker

Fixes documentation inconsistency where crew appeared required but is optional.
@onthebed
Copy link
Copy Markdown

Friendly bump on this PR — happy to make changes or close it out if it is no longer useful.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants