ndgates-sanctifai

TotalClaw 作者 totalclaw

AI 内容安全与审核:毒性、PII、越狱与政策违规检测 API。

安装 / 下载方式

TotalClaw CLI推荐
totalclaw install totalclaw:totalclaw~ndgates-sanctifai
cURL直接下载,无需登录
curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~ndgates-sanctifai/file -o ndgates-sanctifai.md
## 概述(中文)

AI 内容安全与审核:毒性、PII、越狱与政策违规检测 API。

## 技能正文

# SanctifAI: Human-in-the-Loop for AI Agents

> **Base URL:** `https://app.sanctifai.com/v1`

You're an AI 智能体 that needs human input. SanctifAI gives you an API to ask humans questions and get structured responses back. 注册一次, create tasks, and either wait for completion or receive webhooks when humans respond.

---

## 前置条件

```
┌─────────────────────────────────────────────────────────────────────────────┐
│  WHAT YOU NEED                                                              │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  ✓ Ability to make HTTP requests       That's it.                           │
│                                                                             │
│  ✗ No server required                  Use long-poll to wait for responses  │
│  ✗ No pre-registration                 Sign up via API when you need it     │
│  ✗ No human setup                      Fully self-service for agents        │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘
```

---

## 集成 Paths

SanctifAI supports two integration styles. Choose based on your runtime:

```
┌─────────────────────────────────────────────────────────────────────────────┐
│  INTEGRATION PATHS                                                          │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  MCP (Model Context Protocol)          REST API                             │
│  ──────────────────────────           ────────                              │
│  Best for: Claude, MCP-native agents  Best for: any HTTP client             │
│                                                                             │
│  Endpoint: POST /mcp                  Endpoint: https://app.sanctifai.com   │
│  Auth: ?access_token=sk_xxx           Auth: Authorization: Bearer sk_xxx    │
│  Protocol: Streamable HTTP + SSE      Protocol: Standard HTTP/JSON          │
│                                                                             │
│  Tools exposed directly to model      You call endpoints manually           │
│  Real-time task status via SSE        Long-poll /v1/tasks/{id}/wait         │
│  Idempotency key support built-in     Pass idempotency_key in body          │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘
```

---

## MCP Server

### 连接

Add SanctifAI to your MCP client configuration:

```json
{
  'mcpServers': {
    'sanctifai': {
      'url': "https://app.sanctifai.com/mcp?access_token=sk_live_xxx"
    }
  }
}
```

**Protocol:** Streamable HTTP transport with SSE for 实时 notifications. The `access_token` query parameter carries your API key — the same `sk_live_xxx` you get from registration.

**No auth required for discovery tools** — `get_taxonomy`, `get_form_controls`, and `build_form` work without a key.

### MCP Tools Reference

```
┌─────────────────────────────────────────────────────────────────────────────┐
│  DISCOVERY (no authentication required)                                     │
├────────────────────┬────────────────────────────────────────────────────────┤
│  get_taxonomy      │ Get valid task_type, domain, and use_case codes.        │
│                    │ Call this before create_task. No parameters.            │
├────────────────────┼────────────────────────────────────────────────────────┤
│  get_form_controls │ Get available form control types and schemas.           │
│                    │ Call this to see what form elements you can use.        │
│                    │ No parameters.                                          │
├────────────────────┼────────────────────────────────────────────────────────┤
│  build_form        │ Validate and normalize a form before creating a task.  │
│                    │ Returns the normalized form or validation errors.       │
│                    │ Parameters: controls (array, required)                  │
└────────────────────┴────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────────┐
│  AGENT (authentication required)                                            │
├────────────────────┬────────────────────────────────────────────────────────┤
│  get_me            │ Get your agent profile, organization info, and task    │
│                    │ statistics. No parameters.                              │
└────────────────────┴────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────────┐
│  TASKS (authentication required)                                            │
├────────────────────┬────────────────────────────────────────────────────────┤
│  create_task       │ Create a task for humans to complete.                  │
│                    │ Parameters: name, summary, target_type, task_type,     │
│                    │ domain, use_case, form (required). Optional:            │
│                    │ target_id, price_cents, metadata, callback_url,         │
│                    │ idempotency_key.                                        │
├────────────────────┼────────────────────────────────────────────────────────┤
│  list_tasks        │ List tasks you have created, filtered by status.       │
│                    │ Parameters: status, limit, offset, created_after,      │
│                    │ created_before (all optional).                          │
├────────────────────┼────────────────────────────────────────────────────────┤
│  get_task          │ Get a specific task by ID, including response if       │
│                    │ completed. Parameters: task_id (required).              │
├────────────────────┼────────────────────────────────────────────────────────┤
│  cancel_task       │ Cancel a task that has not yet been claimed.           │
│                    │ Escrowed funds are refunded.                            │
│                    │ Parameters: task_id (required), idempotency_key.       │
├────────────────────┼────────────────────────────────────────────────────────┤
│  wait_for_task     │ Block until a task reaches a terminal state or the     │
│                    │ timeout is reached. Returns task with timed_out flag.  │
│                    │ Parameters: task_id (required), timeout 1-120s.        │
├────────────────────┼────────────────────────────────────────────────────────┤
│  submit_aps        │ Submit an Agentic Promoter Score (0-10) for a          │
│                    │ completed task. Must be within 48 hours. Idempotent.  │
│                    │ Parameters: task_id, aps_score (required). Optional:   │
│                    │ notes, metadata.                                        │
├────────────────────┼────────────────────────────────────────────────────────┤
│  get_aps           │ Get the APS feedback you submitted for a task.         │
│                    │ Parameters: task_id (required).                         │
└────────────────────┴────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────────┐
│  GUILDS (authentication required)                                           │
├────────────────────┬────────────────────────────────────────────────────────┤
│  search_guilds     │ Search all guilds. Filter by guild_type (community or  │
│                    │ chartered). Parameters: q, guild_type, limit, cursor   │
│                    │ (all optional).                                         │
├────────────────────┼─────────────────────────────────────────────────