# ai-agents/

This guide was generated by `xuda-cli`.

You can remove all generated folder guides later with:

~~~bash
npm run clean:readmes
~~~

Use this folder for AI agent resources.

## File rules

- file type: `.agent.json5`
- each file compiles to a Xuda `ai_agent` resource

## What belongs here

- agent metadata
- provider and model settings
- future assistant resources tied to your app domain

## Important rules

- keep agent purpose narrow and named clearly
- store only agent configuration here, not UI
- reference the agent from the parts of your app that need it

## Example

~~~json5
{
  id: "class_helper",
  menuTitle: "Class Helper",
  config: {
    provider: "openai",
    model: "gpt-5"
  }
}
~~~