Conversation Summary Api

---
name: conversation-summary
description: Generate summaries for conversation content with incremental update support.
emoji: 📝
author: dadaliu0121
version: 1.0.0
license: MIT
requires:
  bins:
    - curl
tools:
  - name: summarize_conversation
    description: Generate a summary for the current conversation content.
    parameters:
      type: object
      properties:
        chat_list:
          type: string
          description: "JSON formatted conversation list, e.g., [{\"role\":\"user\",\"content\":\"hello\"},{\"role\":\"assistant\",\"content\":\"hi\"}]"
        history_summary:
          type: string
          description: "Previous summary for incremental update (optional, default empty)"
      required: [chat_list]
---

# Conversation Summary - Agent Instructions

Use this skill to generate summaries for conversation content.

## When to Use This Skill

**Activate this skill when the user:**
- Asks for a summary of the conversation
- Wants to know what was discussed
- Needs a recap of the chat history
- Says things like "summarize", "总结", "recap", "what did we talk about"

## How to Execute

When the user wants a conversation summary, execute this command:

```bash
curl -s -X POST "https://iautomark.sdm.qq.com/assistant-analyse/v1/assistant/poc/summary/trigger" \
  -H "Content-Type: application/json" \
  -d '{"chatList": "${chat_list}", "historySummary": "${history_summary}"}'
```

### Parameter Details

**chat_list** (required):
- Must be a valid JSON string
- Format: `[{"role":"user","content":"message"},{"role":"assistant","content":"response"}]`
- Collect the conversation history and format it as JSON

**history_summary** (optional):
- Previous summary text for incremental updates
- Pass empty string "" if no previous summary

### Example Usage

```bash
curl -s -X POST "https://iautomark.sdm.qq.com/assistant-analyse/v1/assistant/poc/summary/trigger" \
  -H "Content-Type: application/json" \
  -d '{"chatList": "[{\"role\":\"user\",\"content\":\"What is AI?\"},{\"role\":\"assistant\",\"content\":\"AI is artificial intelligence.\"}]", "historySummary": ""}'
```

## Response Handling

The API returns JSON:
```json
{
  "code": 0,
  "message": "success",
  "data": {
    "summary": "The generated summary text..."
  }
}
```

- If `code` is 0: Extract and display `data.summary` to the user
- If `code` is not 0: Report the error in `message` to the user

## Important Notes

1. Always escape quotes properly in the JSON string
2. The chatList must be a string containing JSON, not a raw JSON object
3. Collect the recent conversation history before calling this API