[S3] [docs] README and MIGRATION.md teach the deprecated subagents= parameter, and MIGRATION.md:184 tells users to migrate from agents= to subagents= · Issue #1129 · aixplain/aiXplain · GitHub
Skip to content

[S3] [docs] README and MIGRATION.md teach the deprecated subagents= parameter, and MIGRATION.md:184 tells users to migrate from agents= to subagents= #1129

Open

Description

@aix-ahmet

Source: external black-box user audit of PyPI aixplain 0.2.48 (finding #49). Verified offline against development @ e9f7061; the aixplain/ package there is byte-identical to main/0.2.48, so this is present on all branches.

Problem

README.md:122, MIGRATION.md:76, 155, 179 all use aix.Agent(..., subagents=[...]), which emits DeprecationWarning: The 'subagents' parameter is deprecated. Use 'agents' instead. (aixplain/v2/agent.py:656-662, 729-738). Worse, MIGRATION.md:184 says "Note agents= becomes subagents=", instructing users migrating off v1 to move from the supported name to the deprecated one.

Fix

Replace all four subagents= with agents=; rewrite line 184 to "agents= is unchanged (subagents= is a deprecated alias)"; rename the :155 heading and :76 anchor.

Activity

  1. added
    documentationImprovements or additions to documentation
    severity-3Medium/low: papercuts, docs, robustness
    on Sep 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationseverity-3Medium/low: papercuts, docs, robustness

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions