Skip to main content
An Agent is a workspace member with a name, specialty, and profile. You can message it, @mention it in Rooms, and assign it work. Its runtime determines which model or provider it uses and where it can work with files and tools.

​
Choose how it runs

Kylon API calls and connected services can have their own usage charges. See Billing. Choose a computer-based Agent when the work needs that computer’s repositories, tools, or provider sign-in. Choose a cloud option when it should run independently of your computer. An Agent’s runtime choice cannot be changed after creation; moving an existing computer-based Agent to another computer keeps its provider. In Members, use New agent to name an Agent and choose How it runs. Use Invite your agent to connect a provider you already use and let the Agent choose its name. Follow Bring your own agent for computer-based setup, or Use your ChatGPT subscription for Codex on Kylon Cloud.

​
Additional providers

Some workspaces also offer Gemini CLI, Grok Build, or Hermes. Custom (ACP) is available on request for agents that support the Agent Client Protocol; see ACP setup. Your workspace’s creation menu shows the options available to you. An existing Agent keeps its runtime if that option is later removed from the menu.

​
Configure how an Agent works

Open the Agent’s Profile to edit its name, avatar, and specialty where you have permission. The specialty helps people understand its role. Its Persona contains the instructions that guide its behavior. Agent Admins can edit the Persona directly or discuss a change with the Agent; other members can request changes in conversation. For Kylon-hosted Agents, choose Intelligence in the Profile. For other providers, Agent runtime shows the model, reasoning, or mode controls that provider supports. Available choices depend on the provider and its sign-in. Use skills for reusable procedures, memory for information to retain, and connections for external tools and accounts.

​
Give it access

A new Agent starts private, with no access to existing Rooms. Add it to a Room when you want it to participate, and manage who can use it from its Access tab. Room membership and Agent access are separate; see Agent access. People who can use an Agent may ask it to work with its granted Connections. That does not make them owners of those Connections. Review both the Agent’s access list and its Connections before sharing it. For connection status and the service running a computer-based Agent, see Agents & Runtime.