APPSOCOMDocs

AI Teammate

An AI Teammate joins a meeting or class with a role. It follows the whole discussion: who is here, who said what, and what each person contributed. People ask it by name ("Nova, what do you think?"), with Ask AI, or in the chat, and it answers in context. It can look things up in your knowledge base and point out when something said goes against your policies. AI Teammates need prepaid credit (see Pricing).

Roles

Role What it does
contributor Shares its view on the discussion when asked.
scribe Keeps notes and minutes: who said what, decisions, actions, open questions.
facilitator Keeps to the agenda, invites quiet people in and gives recaps.
policy Watches for statements that go against your policy documents.
co-teacher Explains further when asked. The teacher can ask it to teach a topic, and it runs a short lesson, then hands back.
custom Follows your own instructions.

Every role answers questions and keeps minutes. It never talks over people: it answers when it's addressed, one question at a time.

Add one

bash
curl -X POST https://api.appsocom.dev/rooms/staff-meeting/ai-participants \
  -H "Authorization: Bearer $APPSOCOM_API_KEY" -H "Content-Type: application/json" \
  -d '{"role":"contributor","name":"Nova","topic":"Term planning"}'
# → {"roomId":"staff-meeting","agentId":"agent-…","participant":{…}}
Field
role one of the roles above (required)
name the name people see and say. Default "AI Contributor", "AI Scribe"…
instructions extra guidance; required for custom
topic, agenda what the session is about; agenda is [{ "title", "minutes"? }] (facilitator)
voice true: it answers out loud as well as in the chat. Default false (chat only)
avatar a face: { "provider": "anam" | "simli" | "did", "id" }, or true for your default face. Default none. A face needs voice
directQuestions false: only hosts can ask it (others ask the teacher). Default true
knowledge use the knowledge base. Default true
outsideInfo look things up on the web (see Outside information). Default true
webSites web search only on these sites { "allow": ["cbn.gov.ng"] }, or never on these { "block": [...] }. Up to 20, not both
flags who sees policy notes: "hosts" (default) or "room"
watchPolicy check what's said against policy documents. Default true for the policy role and when you have policy documents
minutesEmails up to 20 addresses that get the minutes when it leaves
recapMinutes facilitator: recap every N minutes (0 = off)

Other calls:

  • GET /rooms/:roomId/ai-participants/:agentId: its settings, minutes so far and contributions per person
  • POST /rooms/:roomId/ai-participants/:agentId/control { "control": { "action": … } }: see below
  • POST /rooms/:roomId/ai-participants/:agentId/ask { "text", "userId"?, "name"?, "private"? }: ask from your backend
  • DELETE /rooms/:roomId/ai-participants/:agentId: it leaves; hosts get its final minutes

In your app

ts
room.aiParticipants;                                  // participants with participant.agent.ai
room.askAI("What did we decide about fees?");         // answered in the chat (or out loud with voice on)
room.askAI("Can you explain that again?", { private: true }); // only you see the answer
room.controlAI({ action: "pause" });                  // hosts: pause | resume | recap | minutes | introduce
room.controlAI({ action: "settings", directQuestions: false, voice: true });
room.controlAI({ action: "teach", topic: "Fractions", minutes: 10 }); // co-teacher
room.controlAI({ action: "stop-teaching" });
room.setAiOptOut(true);                               // "don't let the AI hear me"
room.on("ai-flag", (agentId, flag) => …);             // hosts: { name, quote, issue, source, severity }
room.on("ai-minutes", (agentId, minutes) => …);       // hosts: final minutes when it leaves

Answers arrive as chat messages from the AI Teammate (message.from === ai.id), to everyone or only to the person who asked privately.

Asking the AI or the teacher

Students and participants choose: Ask AI goes to the AI, or they ask the teacher (a private chat message or a raised hand). Hosts can turn off questions to the AI from everyone else (directQuestions: false); then only hosts can ask it.

Co-teacher

A teacher says "Tutor, can you teach the class fractions for ten minutes?" or uses the Teach button ({ action: "teach", topic }, or planId for an approved lesson plan). The co-teacher runs an AI Teacher lesson on that topic with slides, whiteboard and quizzes, using the room's hands-up floor, then says it's back to helping. Only hosts can hand it a lesson; when a student asks, it suggests asking the teacher. A topic-only lesson is taught without the library's review step, because the live teacher asked for it.

Privacy

  • Everyone sees that an AI is in the call and listening. Anyone can stop it hearing them (setAiOptOut): their speech and chat are then never given to the AI.
  • Speech is transcribed per speaker only while an AI Teammate (or captions) is on. Transcripts aren't kept after the session; the minutes are saved (and sent to minutesEmails) when it leaves.
  • Policy notes go to hosts only by default.
  • A project's knowledge base is never searched from another project's rooms.

Webhooks

ai_flag (a policy note) and ai_minutes (final minutes when it leaves).

Introducing itself

A host can ask the AI to introduce itself at any time: { "action": "introduce" } (or Introduce yourself in Spaces). It says its name and, in one sentence, what it does in the meeting and how to ask it something, out loud when it answers out loud and in the chat otherwise.

With an AI Presenter in the room

An AI Teammate and an AI Presenter can be in the same room. While the presenter is presenting:

  • "Hey AI" and "assistant" are for the presenter. Call the AI Teammate by its name ("AI Scribe, note that") or use Ask AI.
  • The presenter lets questions said to the AI Teammate by name pass, so only one of them answers.
  • They never talk over each other: each waits until the other has finished speaking.
  • The AI Teammate hears what the presenter says, so its minutes cover the presentation. It never answers the presenter.

Outside information

Besides your knowledge base, the AI can search the web for things outside your organisation: news, market figures, exchange rates, regulations, public standards, other companies and research. It searches only when that adds something the discussion and your documents don't cover, at most twice per answer, and says where the information came from ("according to the Central Bank's site"). Facts about your organisation still come only from your knowledge base.

The pages it looked at are listed at the end of the minutes ("Looked up on the web") and in minutes.sources. Hosts can switch it off or on during the call ({ "action": "settings", "outsideInfo": false }, or Stop web look-ups in Spaces). Turn it off with outsideInfo: false when it's added, or limit it to trusted sites with webSites.

Cost

Listening uses speech-to-text for each speaker (about $0.03 an hour of speech). Answers use Claude Sonnet 5.5 and notes and policy checks use Claude Haiku 5.5: a typical one-hour meeting with 20 questions costs about $0.30–$0.60, worst case about $1.50 an hour with constant questions and policy checks. Voice answers add text-to-speech; a face (avatar) adds the avatar provider's per-minute price. To cap spending, each AI Teammate answers at most 60 questions and runs at most 120 note-taking and policy checks an hour (self-hosted: AI_PARTICIPANT_ANSWERS_PER_HOUR, AI_PARTICIPANT_CHECKS_PER_HOUR); past that it says it's pausing and asks people to ask the host. Web searches cost about $0.01 each plus the pages read (roughly $0.03–$0.06 a search in all); each AI Teammate runs at most 20 searches an hour (self-hosted: AI_PARTICIPANT_SEARCHES_PER_HOUR, 0 turns web search off), and past that it answers without searching. Its time in the call is billed like an AI agent's.