使用说明
耻辱
使用激励智能的多智能体协调平台。 代理通过共享黑板进行协调，而不是通过彼此，就像蚁群在没有管理者的情况下组织数百万工人一样。
五名参考代理负责日常业务运营：电子邮件分类、日历管理、项目跟踪、会议准备和每日简报。黑板协议是真正的产品——代理是它工作的证明。
快速启动
选项1:MCP服务器（连接到正在运行的代理）
pip install stigmergent-mcp
配置您的代理URL：
export CSI_CHIEF_URL=https://your-chief-agent.azurecontainerapps.io
export CSI_COMMS_URL=https://your-comms-agent.azurecontainerapps.io
export CSI_OPS_URL=https://your-ops-agent.azurecontainerapps.io
export CSI_SCHEDULE_URL=https://your-schedule-agent.azurecontainerapps.io
export CSI_KNOWLEDGE_URL=https://your-knowledge-agent.azurecontainerapps.io
添加到克劳德代码：
{
"mcpServers": {
"stigmergent": {
"command": "stigmergent-mcp",
"env": {
"CSI_CHIEF_URL": "https://your-chief-agent.azurecontainerapps.io",
"CSI_COMMS_URL": "https://your-comms-agent.azurecontainerapps.io",
"CSI_OPS_URL": "https://your-ops-agent.azurecontainerapps.io",
"CSI_SCHEDULE_URL": "https://your-schedule-agent.azurecontainerapps.io",
"CSI_KNOWLEDGE_URL": "https://your-knowledge-agent.azurecontainerapps.io"
}
}
}
}
选项2：全本地堆栈（代理+黑板）
git clone https://github.com/CSI-Platform/stigmergent.git
cd stigmergent
cp .env.template .env
# Fill in your M365 credentials and Anthropic API key
docker-compose up
这将在端口8001-8005上本地启动所有5个代理。
每个代理都在做什么
| 代理 | 端口 | 角色 |
|---|---|---|
| 传播专员 | 8001 | 电子邮件分类、起草、承诺扫描、客户脉搏 |
| 运营经理 | 8002 | 项目跟踪、行动项目、责任检查 |
| 知识管理员 | 8003 | 会议准备、成绩单处理、知识检索 |
| 日程安排协调员 | 8004 | 日历管理、可用性、日程安排 |
| 参谋长 | 8005 | 上午简报会、代表团、集合 |
MCP工具
MCP服务器公开了9个工具：
| 工具 | 说明 |
|---|---|
morning_briefing |
每日简报——日历、项目、黑板提醒 |
triage_emails |
对最近的电子邮件进行分类并确定优先级 |
draft_email |
根据指示起草一封专业电子邮件 |
check_calendar |
显示即将发生的事件 |
schedule_meeting |
使用自然语言创建日历事件 |
list_projects |
具有状态和追逐日期的活动项目 |
accountability_check |
扫描过期项目和陈旧项目 |
scan_commitments |
在已发送的邮件中查找未完成的承诺 |
prep_meeting |
为会议建立背景和谈话要点 |
运作原理
You (Claude Code / any MCP client)
|
v
MCP Server (stigmergent-mcp)
|
v A2A JSON-RPC
+-------+-------+-----+-------+------+
| Chief | Comms | Ops | Sched | Know | <-- Agents (Docker / Azure)
+-------+-------+-----+-------+------+
| | |
v v v
Dataverse Graph API SharePoint
(Blackboard) (Mail/Cal) (Projects)
耻辱协调： 代理在黑板上写条目（BLOB）。其他代理人感知到这些条目并采取行动。通讯专家撰写了一篇 Classification 入境；运营经理在责任检查期间阅读它。日常协调不需要直接消息。
同行委托： 对于复杂的任务，代理通过A2A协议相互调用。运营部要求通信部起草后续电子邮件。Comms在起草之前要求Knowledge提供上下文。
LLM第一路由： 每个代理都使用Claude Haiku进行快速意图分类，并使用关键字回退。新颖的措辞可以正确路由，而不需要脆弱的模式匹配。
配置
复制 .env.template 到 .env 并填写：
| 变量 | 必填 | 描述 |
|---|---|---|
CSI_TENANT_ID |
是 | Azure AD租户ID |
CSI_CLIENT_ID |
是 | 应用程序注册客户端ID |
CSI_CLIENT_SECRET |
是 | 应用程序注册客户端密码 |
CSI_DATAVERSE_URL |
是 | Webex环境URL |
CSI_SHAREPOINT_HOST |
是 | SharePoint主机域 |
CSI_SHAREPOINT_SITE_PATH |
是 | SharePoint网站路径 |
CSI_USER_EMAIL |
是 | Graph API调用的用户电子邮件 |
ANTHROPIC_API_KEY |
是 | LLM的Anthropic API密钥 |
CSI_LLM_MODEL |
否 | 主型号（默认：claude-sonnet-4-6） |
CSI_LLM_ROUTER_MODEL |
否 | 路由器型号（默认：claude-haiku-4-5-20251001） |
TZ |
否 | 时区（默认：美国/凤凰城） |
先决条件
- Microsoft 365租户 使用Outlook、日历、SharePoint
- Azure AD应用程序注册 具有Graph API权限（Mail.Read、Calendars.ReadWrite、Sites.ReadWrite.All）
- BLOB环境 有黑板桌
- 无烟煤API键 对于克劳德
- 码头工人 用于在本地运行代理
- Python 3.13+ 对于MCP服务器
黑板协议
黑板是协调面。代理人用以下方式撰写条目：
- 条目类型 （分类、所需行动、责任警报、ClientPulse等）
- 状态生命周期 （新建->已读->已生效->已过期）
- 优先 （低、正常、高、紧急）
- 源代理 身份
- 有效载荷 （灵活的JSON）
任何符合A2A标准的代理都可以通过阅读和书写黑板条目来参与。协议规范： 扩展/黑板/扩展-规范.yaml
项目结构
stigmergent/
agents/
chief-of-staff/ # Briefings, delegation, aggregation
communications-specialist/ # Email, commitments, client pulse
operations-manager/ # Projects, action items, accountability
knowledge-curator/ # Meeting prep, knowledge management
schedule-coordinator/ # Calendar, scheduling, availability
csi-core/ # Shared library (auth, blackboard, Graph, LLM, router)
mcp-server/ # MCP server (9 tools, stdio transport)
extensions/ # Blackboard protocol spec
docker-compose.yml # Local development stack
建立自己的代理人
任何Python A2A服务器都可以通过读写黑板条目来参与Stigmergent协调。关键合同：写条目来宣布你做了什么或发现了什么。阅读条目以了解其他代理所做的工作。黑板负责协调——你只需参与。
许可证
Apache许可证2.0。看 许可证 全文。
由...建造 铜州情报局.
