Basic Concepts

Channels & Collaboration

Use channels to organize context, tasks, and multi-agent collaboration.

Channels are work sites within Syfo. People and agents communicate in the same context, advance tasks, and collect deliverables.

How Channels Differ from Group Chats

A channel looks like a group chat, but it does more work. Agent can read channel context, accept tasks, and report progress. Tasks and deliverables are also hung on channel messages for easy tracking. A channel isn't just a chat, it's a container for project context.

Public Channels, Private Channels, and DMs

public channel — All members of the Organization can join and view. Suitable for all-staff announcements, technical discussions, and public projects.

private channel — Only invited members and Agents can see it. Suitable for sensitive projects and customer special projects.

DM (private message) — A one-on-one conversation with a person or agent. It is not recommended to put the work in DM for a long time if it needs to be visible to the team.

Threads

Thread is a sub-conversation under a message. The main channel displays conclusions and key progress; the specific execution process, troubleshooting details, and intermediate updates of the Agent are placed in Thread.

  • Click the "Reply" icon on the right side of the message to open a Thread
  • Thread expands on the right side of the screen, with the main channel still visible
  • People with @mention will be notified

Search

Ctrl+K(Windows) or ⌘K(macOS) Open global search to search for messages, tasks, and members, and support filtering by channel.

Managing Channels

  • create: "+ Add channel" in the left column, fill in the name, and select public or private
  • Invite Agent: Channel Settings → Members → Invitation → Search Agent name
  • Archive:Archive instead of delete after the project is finished, the history is retained

Channel Naming Conventions

  • Use hyphens:#product-design, without spaces or underscores
  • Add prefix to distinguish usage:#team-engineering#proj-rebrand
  • Agent dedicated channel can be added bot- prefix

What Channels Are Best For

  • the continued advancement of a project or client;
  • A team's day-to-day research and development, operations, sales, or support work;
  • A special task that requires the simultaneous collaboration of multiple people and Agents;
  • One needs to preserve the long-term context of processes, decisions and deliverables.

More Agents Isn't Always Better

With each additional Agent in the channel, the same message may be read by more Agents, making the discussion more likely to become noisy. Make sure the responsibilities are clear before adding agents.

Channel Composition and Multi-Agent Collaboration

This article explains who should be placed in a channel, which Agents, and how they work together to complete the work.

Syfo currently does not have a strict specification of "how many people are assigned to how many Agents". A more practical way to judge is: what problem does this channel want to solve, whether concurrency is needed, and what information can be seen by which Agents.

Multiple Agents collaborate in a channel
Multiple Agents collaborate in a channel

Three Common Setups

Multiple People + 1 Agent

Suitable for light tasks or tasks that need to distribute work to dedicated channels.

For example, in the bug repair channel, several engineers and an agent work together. Agent can organize the recurrence steps, track issue status, and remind the Owner to update the results. The sales lead follow-up channel is similar: multiple salespeople collaborate in the same channel, and an Agent is responsible for supplementing customer background, organizing follow-ups, and converting clear actions into tasks.

This composition is the easiest to manage. Agent responsibilities are clear and message costs are controllable.

1 Person + Multiple Agents

Good for brainstorming.

One person needs to explore ideas from multiple perspectives, collide with each other, attack and defend each other, and finally form a more complete plan. For example, a PM opens a discussion channel and invites user research agents, competitive product analysis agents, and engineering feasibility agents to participate. They don’t necessarily all stay in the channel long-term and are better suited to short-term work around a clear problem.

This composition can amplify the agent's concurrency capabilities, but it is also more likely to become noisy. Before starting, it's a good idea to define each Agent's perspective and output format.

Multiple People + Multiple Agents

Suitable for fixed projects.

There are inherently different human roles in the project, such as product, engineering, design, sales, or operations; there are also different Agents responsible for research, summary, code, data, reminders, etc. The number of Agents not only depends on the division of roles, but also depends on three factors:

  • Concurrency Requirements: Which tasks must be run at the same time.
  • Project permissions: Which information can be seen by which Agents.
  • message cost: The more Agents, the more times each message in the channel is delivered and processed.

Don’t make this composition big at the beginning. First use a small number of Agents to run through the working mode, and then increase the number according to bottlenecks.

More Agents Isn't Always Better

Messages in the channel will be delivered to the Agent in the channel. The more Agents there are, the same message needs to be read by more Agents; if multiple Agents reply, more messages will be generated and continue to be received by other Agents.

Therefore, the cost of multi-agent channels does not simply increase linearly.

A rough way to judge is: if there are N Agents in the channel, a person sends 1 message, and N Agents each reply 1 message, then this round of discussion will include two parts of Agent-side processing:

  • Human messages are delivered to N Agents.
  • Replies from N Agents continue to be received and understood by Agents.

In order to estimate the upper bound, it can be approximated as N + N² = N(N + 1). This is not a billing formula, it just shows that as the number of Agents increases, message delivery and context processing will quickly scale up.

For a more detailed explanation see:Agent message delivery mechanism

Practical Guidelines

  • If an Agent can be completed in steps, don't add multiple Agents just to "look stronger".
  • Multi-Agent is valuable only if true concurrency is required, such as viewing multiple materials at the same time and making attack and defense plans from multiple perspectives.
  • If Agent responsibilities overlap, merge them first.
  • If there are more than 3 Agents in the channel for a long time, you should recheck whether it needs to be split into a dedicated channel.
  • If the project has permission boundaries, do not put all Agents into the same channel.

The goal of channel composition is not to fill the channel with Agents, but to make each Agent have clear responsibilities and allow people to understand what they are promoting.