> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/cli/es/guias/ai-agents.md).

# Trabajar con agentes de IA

Dos formas de trabajar con agentes de IA en Devolutions CLI, lanzar herramientas con devo secret run o conectar un cliente MCP. Elija según lo que el modelo pueda ver.

Los agentes de programación con IA, como Claude Code o GitHub Copilot, a menudo necesitan una credencial para terminar una tarea: una contraseña de base de datos, un token de API, una clave de implementación. Devolutions CLI le ofrece dos formas de dejar que un agente trabaje con su bóveda. La diferencia es si el valor del secreto puede llegar al modelo.

## Elegir el enfoque adecuado

<table><thead><tr><th width="220">ELIJA</th><th>QUÉ OCURRE</th><th>ÚSELO CUANDO</th></tr></thead><tbody><tr><td><strong>El agente ejecuta <code>devo secret run</code></strong></td><td>El agente solo maneja referencias <code>devo://</code>. Devolutions CLI las resuelve cuando se inicia la herramienta, entrega los valores solo a esa herramienta y los oculta en lo que la herramienta imprime. El valor queda fuera de la conversación.</td><td>El agente necesita <strong>usar</strong> una credencial: ejecutar una migración, llamar a una API, implementar. Es la opción más segura de forma predeterminada.</td></tr><tr><td><strong>El agente se conecta con MCP</strong></td><td>Su cliente de IA inicia <code>devo mcp</code> y obtiene herramientas para enumerar, buscar y administrar bóvedas y entradas. Una de estas herramientas devuelve un valor de secreto al cliente, de modo que el valor puede llegar al modelo.</td><td>El agente necesita <strong>trabajar en</strong> su espacio de trabajo: encontrar entradas, revisar el acceso, organizar bóvedas. Restrinja las herramientas a lo que la tarea necesita.</td></tr></tbody></table>

{% hint style="info" %}
Puede combinar ambas. Conecte el servidor MCP con la herramienta de resolución de secretos desactivada para que el agente pueda explorar sus bóvedas, y haga que lance herramientas mediante `devo secret run` cuando necesite una credencial.
{% endhint %}

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Dar una credencial a un agente sin exponerla</strong></td><td>Deje que el agente encuentre referencias y lance herramientas mediante <code>devo secret run</code>.</td><td><a href="/cli/es/guias/ai-agents/run-an-agent.md">Dar una credencial a un agente sin exponerla</a></td></tr><tr><td><strong>Conectar un cliente de IA con MCP</strong></td><td>Añada <code>devo mcp</code> a su cliente MCP y vea lo que puede hacer el modelo.</td><td><a href="/cli/es/guias/ai-agents/connect-mcp.md">Conectar un cliente de IA con MCP</a></td></tr><tr><td><strong>Limitar lo que puede hacer un agente</strong></td><td>Mantenga el servidor MCP en solo lectura, oculte las herramientas destructivas o mantenga los valores de secreto fuera del modelo.</td><td><a href="/cli/es/guias/ai-agents/limit-tools.md">Limitar lo que puede hacer un agente</a></td></tr><tr><td><strong>Qué permanece oculto y qué no</strong></td><td>Qué comandos entregan un secreto y dónde termina la protección de Devolutions CLI.</td><td><a href="/cli/es/guias/understand/security-model.md">Qué permanece oculto y qué no</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/cli/es/guias/ai-agents.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
