> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# AI controls

> Introduces DingTalk Approval's AI control capabilities — text summarization, information extraction, text translation, and image interpretation — to help approvers quickly grasp key form information and improve decision efficiency.

## 1. Capability overview

<Note>
  Value in one sentence: helps approvers quickly grasp key form information and improve decision efficiency.

  Applicable role: approver.

  Supported fields: Text, Number, Image, and most other approval form controls. Attachments and business control groups are not supported yet.

  Core capability: the admin selects a skill for the control → the AI runs automatically when the approver opens the form.
</Note>

| Before                                                                               | After                                                                                                            |
| ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
| The form has too much content, making key points hard to find                        | Text summarization: like a secretary, summarizes the core content of the application in one sentence             |
| Key information such as dates, amounts, and quantities is scattered and easy to miss | Information extraction: like a secretary, surfaces the key information and presents it in a structured way       |
| Cross-border approvals where you cannot read the form content                        | Text translation: like an on-site translator, provides translation support when you need to process the approval |
| Images have to be reviewed one by one, which is inefficient                          | Image interpretation: like a seasoned expert, interprets images and delivers professional judgments              |

## 2. Applicable scenarios

<Note>
  Input: fields on the form (custom selection, up to 10).

  Judgment basis: the 4 default skills plus a custom prompt.

  Output: conclusions delivered to the approver.
</Note>

### 1. Text summarization

Taking a project change approval as an example, configure the AI control in the form designer and select the text summarization scenario:

<Frame>
  ![Form designer for the project change approval, with the AI control settings panel on the right set to the text summarization scenario](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPyX12BWOdv/img/492bb9e8-ea2a-40b6-ac73-de03eb6c0643.png)
</Frame>

When the approval form is opened on desktop, the AI automatically summarizes the change content and provides a suggestion on whether the change is reasonable:

<Frame>
  ![Desktop approval detail page, where the AI control outputs a text summary and approval suggestion for the project change application](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPyX12BWOdv/img/4809e7b7-01f9-44e7-a023-9eab7c708add.png)
</Frame>

On mobile, the summary card also appears automatically, so the key points of a long application are visible at a glance:

<div style={{maxWidth: '400px', margin: '16px auto'}}>
  <Frame>
    ![Mobile approval detail page's text summary card, showing the project delay summary and the reasonableness suggestion for the change](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPyX12BWOdv/img/ac1ab9d0-0eed-4006-b0a7-9e6970311111.png)
  </Frame>
</div>

### 2. Information extraction

Taking a sales daily report as an example, configure the AI control to extract the day's key sales data and actions:

<Frame>
  ![Form designer for the sales daily report, with the AI control configured for the information extraction scenario](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPyX12BWOdv/img/62ae5a56-0c7d-46e5-8747-07180eed5983.png)
</Frame>

During desktop approval, key data such as total sales and conversion rate is extracted in a structured way:

<Frame>
  ![Desktop approval detail page, where the AI control extracts key data from the sales daily report in a structured way](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPyX12BWOdv/img/7328e688-b517-43f6-a01e-fdef68d0580b.png)
</Frame>

On mobile, the store's sales summary appears — including key data, highlights, and improvement suggestions:

<div style={{maxWidth: '400px', margin: '16px auto'}}>
  <Frame>
    ![Mobile approval detail page's information extraction card, showing key sales data, what went well, and improvement suggestions](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPyX12BWOdv/img/c60bf8d4-ca6d-4246-a79f-8166d496773a.png)
  </Frame>
</div>

### 3. Text translation

Taking an IT trouble ticket as an example, configure the AI control to translate the issue description into multiple languages:

<Frame>
  ![Form designer for the IT trouble ticket, with the AI control configured for the text translation scenario](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPyX12BWOdv/img/3c61345a-4ce7-4f17-8133-7a261fc1c26e.png)
</Frame>

During desktop approval, the ticket content is translated automatically, so cross-border approvals are no longer unintelligible:

<Frame>
  ![Desktop approval detail page, where the AI control translates the ticket's issue description into multiple languages](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPyX12BWOdv/img/17348500-6505-45d5-93b2-f1e5565df1f1.png)
</Frame>

On mobile, translations appear in English, Japanese, and Thai:

<div style={{maxWidth: '400px', margin: '16px auto'}}>
  <Frame>
    ![Mobile approval detail page's text translation card, with the issue type and description translated into English, Japanese, and Thai](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPyX12BWOdv/img/25ade518-a4b3-4df5-8219-9c5e89f54235.png)
  </Frame>
</div>

### 4. Image interpretation

Taking store inspection as an example, configure the AI control to interpret inspection images against the rules for stack displays, window displays, and advertising signage:

<Frame>
  ![Form designer for the store inspection form, containing image fields for stack displays, window displays, and advertising signage, plus the AI control](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPyX12BWOdv/img/6abbf260-cc17-4a93-801f-33e4bc7baa74.png)
</Frame>

During desktop approval, the AI interprets the images against the custom rating rules and gives a score:

<Frame>
  ![Desktop approval detail page, where the AI control interprets store inspection images by the rating rules and outputs scores](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPyX12BWOdv/img/fc1525ce-6cac-4057-b325-474b9c3a8881.png)
</Frame>

On mobile, each item's score and the reasons for deductions are shown, so the approver does not have to review images one by one:

<div style={{maxWidth: '400px', margin: '16px auto'}}>
  <Frame>
    ![Mobile approval detail page's image interpretation card, showing scores and deduction reasons for stack displays, window displays, and advertising signage](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPyX12BWOdv/img/3f557e1f-e699-487b-aedb-0a132e59eb97.png)
  </Frame>
</div>

## 3. Steps

<Steps>
  <Step title="Add the AI control to the form">
    In the upper right corner, click **Manage approval forms** to open the Admin Console. Search for the form you want to update, click **Edit** to open the form designer, click **Form design**, and add the AI control to the form:

    <Frame>
      ![Form designer, dragging the AI control from the left control list into the form](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPyX12BWOdv/img/72c1a4d1-487a-45c8-94cf-d6dcf9b07964.png)
    </Frame>
  </Step>

  <Step title="Configure the AI control">
    Set the AI control's title, choose the **scenario** (a model is matched automatically), select the fields to support, and enter your requirements in the AI prompt box:

    <Frame>
      ![AI control settings panel, where you can configure the title, scenario, supported fields, and requirements for the AI result](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPyX12BWOdv/img/e15531de-5904-4b5b-ae54-1d1ed2212abb.png)
    </Frame>
  </Step>

  <Step title="Publish the form and invoke the AI control">
    Once the form is published, opening the approval form on desktop invokes the AI control automatically:

    <Frame>
      ![Desktop approval detail page automatically invokes the AI control and outputs the analysis conclusion](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPyX12BWOdv/img/17348500-6505-45d5-93b2-f1e5565df1f1.png)
    </Frame>

    It also runs automatically on mobile:

    <div style={{maxWidth: '400px', margin: '16px auto'}}>
      <Frame>
        ![Mobile approval detail page automatically invokes the AI control and shows the analysis conclusion card](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPyX12BWOdv/img/25ade518-a4b3-4df5-8219-9c5e89f54235.png)
      </Frame>
    </div>
  </Step>
</Steps>

## 4. Walkthrough videos

### 1. Text summarization

Prompt example:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
You are a project lead with 10 years of experience.
Please summarize the change content and give a suggestion on whether the change is reasonable.
Keep it within 100 words, with the summary and suggestion on separate lines.
```

Full walkthrough from configuration to invocation:

<video src="https://mintlify.s3.us-west-1.amazonaws.com/dingtalk-8c0f98e2/images/ai-controls/text-summary.mp4" controls width="100%" />

### 2. Information extraction

Prompt example:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
You are a store manager with 10 years of retail sales experience.
Extract the key data and actions from today's sales, and give suggestions on what was done well and what needs improvement.
Keep it within 200 words, with items on separate lines.
```

Full walkthrough from configuration to invocation:

<video src="https://mintlify.s3.us-west-1.amazonaws.com/dingtalk-8c0f98e2/images/ai-controls/info-extract.mp4" controls width="100%" />

### 3. Text translation

Prompt example:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
You are a translator fluent in English, Japanese, and Thai, with over 10 years of business translation experience.
Please translate into English, Japanese, and Thai.
Make sure the wording matches local usage habits and is as concise as possible.
```

Full walkthrough from configuration to invocation:

<video src="https://mintlify.s3.us-west-1.amazonaws.com/dingtalk-8c0f98e2/images/ai-controls/text-translate.mp4" controls width="100%" />

### 4. Image interpretation

Prompt example:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Please analyze whether this store's stack display is neatly arranged, whether the window display is visually appealing, and whether the advertising signage is properly posted.
Based on the images, score this store and clearly explain the reasons for any deductions.
Stack display: max 40 points, at most 40 points can be deducted. Requires at least 4 images, with each image worth up to 10 points; images that are not relevant score 0. Deduct points based on the severity of any errors, with a minimum of 0. If there are more than 4 images, take the 4 highest-scoring ones.
Window display: max 30 points, requires at least 3 images; other rules are the same as above.
Advertising signage: max 30 points, requires at least 3 images; other rules are the same as above.
```

Full walkthrough from configuration to invocation:

<video src="https://mintlify.s3.us-west-1.amazonaws.com/dingtalk-8c0f98e2/images/ai-controls/image-review.mp4" controls width="100%" />

## 5. FAQs

<AccordionGroup>
  <Accordion id="q1" title="Who can see the AI control?">
    Like other controls, the AI control's visibility can be set per step:

    <Frame>
      ![Field permissions settings on a step, where the AI control's visibility can be configured per step](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPyX12BWOdv/img/16d3ffdb-98d8-4162-8f56-78e4ccfc3ddd.png)
    </Frame>
  </Accordion>

  <Accordion id="q2" title="Which controls are supported?">
    Text summarization, information extraction, and text translation: do not support description text, Image, detail/Spreadsheet, Attachment, Signature, industry contacts department, associated approval form, engineering project, all business controls, ID card recognition, or all business control groups.

    Image interpretation: only supports the Image control.
  </Accordion>

  <Accordion id="q3" title="Can it be used on mobile?">
    The configuration side currently supports only desktop and web, while the usage side supports both mobile and desktop.
  </Accordion>

  <Accordion id="q4" title="Will the AI read my approval content?">
    Only while the AI capability is running, the current content is sent temporarily for generation; it is not stored or logged afterward, meeting organization data security requirements.
  </Accordion>
</AccordionGroup>

## 6. Related documents

<CardGroup cols={2}>
  <Card title="AI Capabilities Overview" icon="wand-magic-sparkles" href="/approval/ai-capabilities-overview">
    Learn the product value and applicable roles of every Approval AI capability
  </Card>

  <Card title="AI Form Filling" icon="pen-to-square" href="/approval/ai-fill-form">
    Let AI fill the form for you — start an approval in 3 seconds
  </Card>
</CardGroup>
