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

# Descubrimiento de objetivos

> Revisa los objetivos candidatos en Target Inventory y gestiona el contexto, las programaciones y las sugerencias de descubrimiento desde el panel, la API o MCP.

## Descripción general

El descubrimiento propone objetivos candidatos para tu organización. Revisa las sugerencias antes de aceptarlas en tu inventario de objetivos. El descubrimiento solo está disponible cuando está habilitado para tu organización.

La API pública y MCP admiten el siguiente flujo de trabajo:

1. Leer el estado, el contexto y la programación actuales del descubrimiento.
2. Actualizar la nota de contexto con información que ayude a identificar los activos de tu organización.
3. Iniciar una ejecución de descubrimiento o configurar una programación recurrente.
4. Listar las sugerencias pendientes.
5. Aceptar las sugerencias relevantes o descartar las que no quieras agregar.

Al aceptar una sugerencia se crea un objetivo mediante el flujo de trabajo normal de objetivos. Comprueba su estado de verificación y completa cualquier verificación de propiedad requerida antes de iniciar una evaluación.

## Panel

Cuando el descubrimiento está habilitado, abre **Target Inventory** para encontrar su panel Discovery. El panel ofrece:

* **Add background**, **Edit background** o **View background** para información específica de la organización que orienta el descubrimiento.
* **Schedule** para la cadencia, la hora local y la zona horaria.
* Controles **Run now** y **Stop**, con el estado de la ejecución actual.
* Acciones **Accept** y **Dismiss** sobre los objetivos candidatos.

Revisa una sugerencia antes de aceptarla. Aceptarla agrega un objetivo, pero no demuestra que el objetivo se haya evaluado ni que la verificación de propiedad esté completa. Los propietarios y administradores gestionan el descubrimiento desde el panel. Los demás miembros pueden revisar el contexto y las sugerencias disponibles.

## Operaciones de la API

| Acción | Endpoint |
| - | - |
| Leer el estado | `GET /v1/discovery` |
| Establecer el contexto | `PUT /v1/discovery/context` |
| Establecer la programación | `PUT /v1/discovery/schedule` |
| Iniciar una ejecución | `POST /v1/discovery/runs` |
| Cancelar una ejecución | `POST /v1/discovery/runs/{run_id}/cancel` |
| Listar sugerencias | `GET /v1/discovery/suggestions` |
| Aceptar una sugerencia | `POST /v1/discovery/suggestions/{suggestion_id}/accept` |
| Descartar una sugerencia | `POST /v1/discovery/suggestions/{suggestion_id}/dismiss` |

Las programaciones admiten ejecuciones diarias o semanales, una hora local y una zona horaria IANA como `America/Los_Angeles`. Las programaciones semanales requieren `day_of_week`, donde `0` es lunes y `6` es domingo. Las programaciones diarias omiten ese campo o lo establecen en `null`.

Las sugerencias tienen un estado de ciclo de vida `pending`, `accepted`, `dismissed` o `superseded`. Consulta la referencia del endpoint para conocer los campos de la solicitud y la paginación.

## MCP

Empieza con `get_current_context` para comprobar si el descubrimiento está habilitado. Usa `get_discovery_status`, `update_discovery_context` y `update_discovery_schedule` para inspeccionarlo y configurarlo. Ejecuta y revisa el descubrimiento con `start_discovery_run`, `list_discovery_suggestions`, `accept_discovery_suggestion` y `dismiss_discovery_suggestion`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.