")
# The US region host. For the EU region, use https://ai.cke-cs-eu.com
HOST="https://ai.cke-cs.com"
jq -n --rawfile doc document.html '{
content: [ { type: "document", content: $doc } ],
prompt: "Fix the grammar and spelling only in the introduction part.",
model: "agent-1"
}' | curl -s "$HOST/v1/documents/process" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d @- \
> response.json
```
If you do not have `jq` installed, pass the body inline. JSON-escape the document HTML: write quotes as `\"`, newlines as `\n`, and tabs as `\t`:
```bash
curl -s "$HOST/v1/documents/process" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"content": [ { "type": "document", "content": "Quarterly product update
\nwe shiped the new dashbord to all customers this quater. it should of been out sooner but we hit some bugs in the rollout.
\n\n\t\n\t\t| Metric | Q2 | Q3 |
|---|
\n\t\n\t\n\t\t| Active teams | 1,204 | 1,688 |
\n\t\t| Uptime | 99.95% | 99.97% |
\n\t\n
\n\n\t- Faster exports\n\t\t\n\t
\n\t- New review workflow
\n
\nNumbers above are unaudited.
\nWe also shipped the new documentation for recovering deleted files and mail process in Microsoft 365 products:
\n\n\t- \n\t\tRecovering deleted files and mail\n\t\t
\n\t\t\t- Files deleted from SharePoint or OneDrive sit in the first-stage recycle bin for 93 days, then move to the second-stage bin for a further 93 days. We can therefore always recover a document within six months of its deletion.
\n\t\t\t- Deleted mail is recoverable for 30 days. This is a platform limit and cannot be adjusted per mailbox
\n\t\t\t- If a user edits a file that is under a retention policy, the version that existed when the policy was applied is lost.
\n\t\t
\n\t \n
" } ],
"prompt": "Fix the grammar and spelling only in the introduction part.",
"model": "agent-1"
}' \
> response.json
```
Read the response:
```json
{
"documents": [
{
"document":"Quarterly product update
\nWe shipped the new dashboard to all customers this quarter. It should have been out sooner, but we hit some bugs in the rollout.
\n\n\t\n\t\t| Metric | Q2 | Q3 |
|---|
\n\t\n\t\n\t\t| Active teams | 1,204 | 1,688 |
\n\t\t| Uptime | 99.95% | 99.97% |
\n\t\n
\n\n\t- Faster exports\n\t\t\n\t
\n\t- New review workflow
\n
\nNumbers above are unaudited.
\nWe also shipped the new documentation for recovering deleted files and mail process in Microsoft 365 products:
\n\n\t- \n\t\tRecovering deleted files and mail\n\t\t
\n\t\t\t- Files deleted from SharePoint or OneDrive sit in the first-stage recycle bin for 93 days, then move to the second-stage bin for a further 93 days. We can therefore always recover a document within six months of its deletion.
\n\t\t\t- Deleted mail is recoverable for 30 days. This is a platform limit and cannot be adjusted per mailbox
\n\t\t\t- If a user edits a file that is under a retention policy, the version that existed when the policy was applied is lost.
\n\t\t
\n\t \n
",
"summary":"Corrected grammar, spelling, capitalization, and punctuation in the introductory paragraph only."
}
]
}
```
The response contains the edited document and a summary of the changes.
The edited element:
```html
Quarterly product update
We shipped the new dashboard to all customers this quarter. It should have been out sooner, but we hit some bugs in the rollout.
```
Only the introduction changed. The service preserves the rest of the document, including attributes and CSS classes, unless the prompt asks to change them. The result is valid HTML you can load into the editor with no further processing.
> **Note**
>
> Language models are non-deterministic, so the wording differs between runs. The service returns editor-ready HTML every time.
## Connect an MCP server
An MCP (Model Context Protocol) server gives the agent tools and knowledge the model alone does not have. The service has an admin API for registering MCP servers and managing their tools.
The example below uses the public [Microsoft Learn](https://learn.microsoft.com/) MCP server, `https://learn.microsoft.com/api/mcp`. You do not have to set up a server of your own. Give the server a name that is unique within the environment:
```bash
curl -s -X POST "$HOST/v1/admin/mcp-servers" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "microsoft-learn",
"url": "https://learn.microsoft.com/api/mcp"
}'
```
Response:
```json
{
"name": "microsoft-learn"
}
```
If your server needs authentication or extra headers, see [MCP tools](extensions/mcp-tools.md).
Send the sample document again, with a prompt that tells the agent to check its figures against the official Microsoft 365 documentation. This request also sets `responseFormat` to `arf`, so the response carries only the elements the agent changed instead of the whole document. [Fragment responses](fragment-responses.md) explains the format:
```bash
jq -n --rawfile doc document.html '{
content: [ { type: "document", content: $doc } ],
prompt: "Verify every retention figure and claim in this document against the official Microsoft 365 documentation, and correct the ones that are wrong.",
model: "agent-1",
responseFormat: "arf"
}' | curl -s "$HOST/v1/documents/process" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d @- \
> response-kb.json
```
Read the response:
```json
{
"documents":[
{
"document":"\n\n\t- \n\t\tRecovering deleted files and mail\n\t\t
\n\t\t\t- For SharePoint and OneDrive for work or school, deleted items are retained in the recycle bins for a combined total of 93 days from the original deletion date; moving an item to the second-stage recycle bin does not restart that period. Recovery is not guaranteed for six months, and items can be permanently deleted sooner.
\n\t\t\t- In Exchange Online, items removed from the Deleted Items folder are retained in Recoverable Items for 14 days by default. An administrator can increase this deleted-item retention period to a maximum of 30 days, including for an individual mailbox. Retention policies or holds can preserve content longer.
\n\t\t\t- When a user edits or deletes content subject to a Microsoft Purview retention policy, SharePoint and OneDrive preserve a copy in the Preservation Hold library. For retained documents, version retention depends on the applicable retention settings; editing a file does not simply discard the version that existed when retention applied.
\n\t\t
\n\t \n
\n",
"summary":"Corrected the three Microsoft 365 retention claims: SharePoint/OneDrive recycle-bin retention, Exchange Online deleted-item retention, and retained file-version behavior. The revised text now reflects Microsoft's documented policies."
}
]
}
```
The agent queried the Microsoft Learn server and corrected the three wrong claims. The `` comment stands for the content left untouched.
## Try it on your document
Run the same request on any HTML your product stores. Swap in your own file and your own prompt:
```bash
jq -n --rawfile doc your-own.html '{
content: [ { type: "document", content: $doc } ],
prompt: "Translate to German. Keep all markup exactly as it is.",
model: "agent-1"
}' | curl -s "$HOST/v1/documents/process" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d @-
```
## Next steps
* **[Authentication](authentication.md)** covers production setup: your own token endpoint, signed tokens, and permission profiles.
* **[Document Processing](document-processing.md)** covers the full endpoint: several documents in one call, editing part of a document, contexts, and streaming.
* **[Fragment responses](fragment-responses.md)** explains what a fragment contains and how to apply one to your copy of the document.
* **[MCP tools](extensions/mcp-tools.md)** covers listing servers, updating credentials, disabling individual tools, and removing a server.
* **[Choose an extension](extensions/overview.md)** covers everything else you can give the agent: contexts, skills, MCP servers, hooks, and model providers.
---
Full index of the Cloud Services documentation: [llms.txt](../../../llms.txt)