Agents reference

查看 Markdown查看 Markdown

This reference covers the Dex Agents packages in production: install, sizing, limits, timeouts, approvals, Connector tools, upgrades, credentials, and Dex Web. Agent Frameworks explains how an agent session works and the rules for tool calls. Server limits on these pages are server-zd defaults. See the Server reference and Application for the rest of the setup.

Pages

• Install the packages: the Python and TypeScript packages, their runtimes, and how they are versioned.
• AgentEvents Stream: the Stream backend and how to size the live event Stream.
• Workers and timeouts: Worker task slots, Step timeouts, long model calls, separate Worker pools, and graceful stop.
• Limits for long sessions: the server limits a session grows into, what happens at the limit, and compaction.
• Approvals and waiting sessions: approval deadlines, RPC locks, and how to find sessions that wait for a person.
• Connector tools: packages, tool names, result size, and Connector connections.
• Crashes and tool call outcomes: what each failure repeats, its tests, and how a tool Step's failure picks the call's record.
• Spend limits: the ModelSpendLimit interface and its limits.
• Upgrades: deploy agent code while sessions wait, and roll out session settings.
• Credentials: where model keys and tool credentials live.
• Dex Web: render the session graph and show sessions in Dex Web.
• Change log: user-visible changes in each release.

Release notes

The agents packages are released together as agents/vX.Y.Z, on their own version line. See the agents releases on GitHub and the change log.