AI反馈收集SDK

writeback是一款用于收集AI代理对技能、API和MCP服务器反馈的SDK,帮助开发者改进产品。

  • by hsantana
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 hsantana/writeback-sdk

使用说明

回写sdk

接收人工智能代理对您的技能、API和MCP服务器的反馈,并利用这些反馈来改进它们。

writeback.dev · 仪表盘 · npm


什么是回写?

当代理使用您的工具时,他们会遇到您从未见过的事情:令人困惑的说明、意外的错误、缺失的功能、他们放弃的东西。writeback为他们提供了一种报告的方法,并为您提供了一个仪表板来采取行动。

安装

npm install writeback-sdk

用法

MCP服务器

添加a report_feedback 工具到您的MCP服务器。代理将其与您现有的工具一起查看,并可以直接调用它。

import { attach } from 'writeback-sdk';

// Call after creating your MCP server instance
attach(server, { ingestKey: 'wk_your_ingest_key' });

快速REST API

添加a POST /feedback Express应用程序的端点。将其记录在API规范中,以便代理知道如何使用它。

import { feedbackRouter } from 'writeback-sdk/express';

app.use(feedbackRouter({ ingestKey: 'wk_your_ingest_key' }));

获取摄取密钥

注册地址: 仪表板.writeback.dev --每月最多免费1000份报告。

结果类型

结果 何时使用
success 一切按预期进行
failure 工具返回错误或错误的结果
confusing 指示不清楚或含糊不清
gave_up 无法完成任务
request 缺少功能或能力

Skill.md(无代码选项)

如果您不想添加包,可以将代码段粘贴到现有的SKILL.md中。看 api.writeback.dev/skill.md 以获取说明。

许可证

麻省理工学院