Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 3 additions & 18 deletions es/optimize/feedback.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -122,28 +122,13 @@ Estos comentarios aparecen en la sección **Detailed feedback** identificados co
### Cómo funcionan los comentarios de agentes
</div>

Los agentes pueden enviar comentarios de dos maneras:

- **Servidor Search MCP**: Un agente conectado al [servidor Search MCP](/es/ai/model-context-protocol) de tu sitio puede descubrir y llamar a la herramienta `submit_feedback`. La herramienta requiere la ruta de la página y una descripción del problema.
- **Endpoint HTTP**: Un agente con capacidad para realizar solicitudes `POST` puede enviar la ruta de la página y el texto del comentario directamente a `https://your-domain.com/feedback`. Este método no requiere una conexión MCP.

Por ejemplo:

```bash
curl --request POST \
--url https://your-domain.com/feedback \
--header 'Content-Type: application/json' \
--data '{
"path": "/quickstart",
"feedback": "El comando de instalación de esta página está desactualizado."
}'
```
Conecta un agente al [servidor Search MCP](/es/ai/model-context-protocol) de tu sitio. El servidor proporciona una herramienta `submit_feedback` que requiere la ruta de la página y una descripción del problema.

<Note>
Las herramientas de búsqueda y obtención web no proporcionan al agente la herramienta MCP `submit_feedback`. Un agente que solo admite solicitudes `GET` no puede enviar comentarios. Necesita una conexión a tu servidor Search MCP o la capacidad de realizar una solicitud HTTP `POST`.
Las herramientas de búsqueda y obtención web no conectan a un agente con el servidor Search MCP. El agente debe estar conectado al servidor para descubrir y llamar a la herramienta `submit_feedback`.
</Note>

Ambos métodos registran el envío como un comentario no útil para la página especificada. Los comentarios aparecen en el panel junto con los comentarios humanos.
Cada envío se registra como un comentario no útil para la página especificada. Los comentarios aparecen en el panel junto con los comentarios humanos.

<div id="retrieve-agent-feedback-via-api">
### Recuperar los comentarios de agentes vía API
Expand Down
21 changes: 3 additions & 18 deletions fr/optimize/feedback.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -122,28 +122,13 @@ Ces retours apparaissent dans la section **Detailed feedback**, identifiés par
### Fonctionnement des retours des agents
</div>

Les agents peuvent soumettre des retours de deux façons :

- **Serveur Search MCP** : un agent connecté au [serveur Search MCP](/fr/ai/model-context-protocol) de votre site peut découvrir et appeler l'outil `submit_feedback`. L'outil requiert le chemin de la page et une description du problème.
- **Point de terminaison HTTP** : un agent capable d'effectuer des requêtes `POST` peut envoyer le chemin de la page et le texte du retour directement à `https://your-domain.com/feedback`. Cette méthode ne nécessite pas de connexion MCP.

Par exemple :

```bash
curl --request POST \
--url https://your-domain.com/feedback \
--header 'Content-Type: application/json' \
--data '{
"path": "/quickstart",
"feedback": "La commande d’installation de cette page est obsolète."
}'
```
Connectez un agent au [serveur Search MCP](/fr/ai/model-context-protocol) de votre site. Le serveur fournit un outil `submit_feedback` qui requiert le chemin de la page et une description du problème.

<Note>
Les outils de recherche et de récupération web ne donnent pas accès à l'outil MCP `submit_feedback`. Un agent qui prend uniquement en charge les requêtes `GET` ne peut pas soumettre de retour. Il doit être connecté à votre serveur Search MCP ou pouvoir effectuer une requête HTTP `POST`.
Les outils de recherche et de récupération web ne connectent pas un agent au serveur Search MCP. L'agent doit être connecté au serveur pour découvrir et appeler l'outil `submit_feedback`.
</Note>

Les deux méthodes enregistrent la soumission comme un retour négatif pour la page spécifiée. Le retour apparaît dans le tableau de bord aux côtés des retours humains.
Chaque envoi est enregistré comme un retour négatif pour la page spécifiée. Le retour apparaît dans le tableau de bord aux côtés des retours humains.

<div id="retrieve-agent-feedback-via-api">
### Récupérer les retours des agents via l'API
Expand Down
21 changes: 3 additions & 18 deletions optimize/feedback.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -107,28 +107,13 @@ This feedback appears in the **Detailed feedback** section identified by an **Ag

### How agent feedback works

Agents can submit feedback in two ways:

- **Search MCP server**: An agent connected to your site's [search MCP server](/ai/model-context-protocol) can discover and call the `submit_feedback` tool. The tool requires the page path and a description of the problem.
- **HTTP endpoint**: An agent with the ability to make `POST` requests can submit the page path and feedback text directly to `https://your-domain.com/feedback`. This method does not require an MCP connection.

For example:

```bash
curl --request POST \
--url https://your-domain.com/feedback \
--header 'Content-Type: application/json' \
--data '{
"path": "/quickstart",
"feedback": "The installation command on this page is outdated."
}'
```
Connect an agent to your site's [search MCP server](/ai/model-context-protocol). The server exposes a `submit_feedback` tool that requires the page path and a description of the problem.

<Note>
Web search and web fetch tools do not give an agent the `submit_feedback` MCP tool. An agent that only supports `GET` requests cannot submit feedback. It needs either a connection to your search MCP server or the ability to make an HTTP `POST` request.
Web search and web fetch tools do not connect an agent to the search MCP server. Connect the agent to the server so it can discover and call the `submit_feedback` tool.
</Note>

Both methods record the submission as unhelpful feedback for the specified page. The feedback appears in the dashboard alongside human feedback.
Mintlify records each submission as unhelpful feedback for the specified page. The feedback appears in the dashboard alongside human feedback.

### Retrieve agent feedback via API

Expand Down
21 changes: 3 additions & 18 deletions zh/optimize/feedback.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -122,28 +122,13 @@ boost: 3
### 智能体反馈的工作原理
</div>

智能体可以通过两种方式提交反馈:

- **Search MCP 服务器**:连接到您站点的 [Search MCP 服务器](/zh/ai/model-context-protocol)后,智能体可以发现并调用 `submit_feedback` 工具。该工具需要页面路径和问题描述。
- **HTTP 端点**:能够发出 `POST` 请求的智能体可以将页面路径和反馈文本直接提交到 `https://your-domain.com/feedback`。这种方式不需要 MCP 连接。

例如:

```bash
curl --request POST \
--url https://your-domain.com/feedback \
--header 'Content-Type: application/json' \
--data '{
"path": "/quickstart",
"feedback": "此页面上的安装命令已过时。"
}'
```
将智能体连接到您站点的 [Search MCP 服务器](/zh/ai/model-context-protocol)。该服务器提供 `submit_feedback` 工具,该工具需要页面路径和问题描述。

<Note>
网页搜索和网页获取工具不会为智能体提供 `submit_feedback` MCP 工具。仅支持 `GET` 请求的智能体无法提交反馈。它需要连接到您的 Search MCP 服务器,或具备发出 HTTP `POST` 请求的能力
网页搜索和网页获取工具不会将智能体连接到 Search MCP 服务器。智能体必须连接到该服务器,才能发现并调用 `submit_feedback` 工具
</Note>

两种方式都会将提交记录为指定页面的负面反馈。反馈将与人类反馈一起显示在仪表板中。
每次提交都会记录为指定页面的负面反馈。反馈将与人类反馈一起显示在仪表板中。

<div id="retrieve-agent-feedback-via-api">
### 通过 API 获取智能体反馈
Expand Down