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

# Tu primer agente: qué hacer cuando algo va mal

> Los avisos que puede mostrar un agente nuevo, los fallos que puedes encontrar en el alta y qué hacer con cada uno.

export const UiPath = ({children}) => {
  const parts = String(children).split(/\s*(?:→|>)\s*/).filter(Boolean);
  return <span className="pl-path">
      {parts.map((part, index) => <span key={`${index}-${part}`}>
          {index > 0 && <span className="pl-path__sep">→</span>}
          {part}
        </span>)}
    </span>;
};

export const Screenshot = ({id, alt, caption, frame = 'browser', url, marks = [], lang = 'en', workspace = 'northwind-outbound'}) => {
  const src = `/images/screenshots/${lang}/${id}.png`;
  const chrome = url ? `app.pipelime.ai/${workspace}${url}` : 'app.pipelime.ai';
  return <figure className={`pl-shot pl-shot--${frame} not-prose`}>
      <div className="pl-shot__frame">
        {frame !== 'bare' && <div className="pl-shot__bar">
            <span className="pl-shot__dots">
              <span className="pl-shot__dot" />
              <span className="pl-shot__dot" />
              <span className="pl-shot__dot" />
            </span>
            <span className="pl-shot__url">{chrome}</span>
          </div>}
        <div className="pl-shot__media">
          <img src={src} alt={alt} loading="lazy" />
          {marks.map(mark => <span key={mark.n} className="pl-shot__mark" style={{
    left: `${mark.x}%`,
    top: `${mark.y}%`
  }} aria-hidden="true">
              {mark.n}
            </span>)}
        </div>
      </div>
      {caption && <figcaption className="pl-shot__caption">{caption}</figcaption>}
    </figure>;
};

Un agente pone todos los problemas que conoce en avisos en la parte superior de su pestaña **Panel**, y un espacio de trabajo creado al registrarte llega con tres de ellos ya visibles.

<div className="pl-availability">
  <div className="pl-availability__row">
    <div className="pl-availability__label">Where</div>
    <div className="pl-availability__value"><span className="pl-path">Outreach<span className="pl-path__sep">→</span>AI Agents</span></div>
  </div>

  <div className="pl-availability__row">
    <div className="pl-availability__label">Your role needs</div>
    <div className="pl-availability__value">Read access to AI Agents <code>read-campaigns</code>. Admin, Member and Viewer have it by default.</div>
  </div>

  <div className="pl-availability__row">
    <div className="pl-availability__label">To create or change</div>
    <div className="pl-availability__value"><code>create-campaigns</code> to add one, <code>update-campaigns</code> to change one, on top of the permission above.</div>
  </div>

  <div className="pl-availability__note">If you cannot find this in your sidebar, your workspace may have a custom menu configuration. Contact support and we will check it for you.</div>
</div>

<Info>
  Las pantallas del agente están traducidas al español. Cuatro de las imágenes de
  esta página se muestran en inglés: las tres de los avisos de búsqueda y de la
  tarjeta de generación, que solo se capturan en inglés, y la del alta, que es una
  pantalla que la aplicación muestra en inglés en todos los idiomas. Los nombres de
  los botones que aparecen en el texto sí son los que vas a leer en pantalla.
</Info>

## Dónde mirar y qué significan los números

Abre el agente desde <UiPath>Prospección → Agentes IA</UiPath> y quédate en su pestaña **Panel**. Los avisos están arriba del todo, por encima del historial de actividad y de la columna lateral. Cada uno lleva un título, una línea que lo explica y el botón que lo resuelve.

Solo una tarjeta puede quedar por encima de ellos. Es la [tarjeta de primeros leads](/es/getting-started/first-leads-what-to-expect), y aparece un rato en un agente que lanzaste tú desde el asistente de creación. El agente que se creó solo al registrarte nunca la muestra, así que en ese agente los avisos son de verdad lo primero de la pestaña.

Cuando un agente no tiene nada mal, no hay ningún aviso. La franja desaparece en vez de quedarse vacía, así que un panel sin avisos es buena señal.

Otras dos pestañas repiten una parte. La pestaña **Configuración** levanta el canal de envío que falta y el objetivo sin llamada a la acción, porque son los dos que se arreglan ahí. La pestaña **Fuentes** levanta los dos problemas de búsqueda. Todo lo demás aparece solo en la pestaña **Panel**.

<Note>
  En la lista de agentes, cada agente lleva junto a su estado un recuento de sus problemas abiertos. Ese recuento se calcula con lo que la lista ya cargó, y dos problemas, **Aún no hay leads que coincidan** y **Aún no hay leads alcanzables por WhatsApp**, se juzgan con cifras que solo pide la página del propio agente. Por eso la lista puede mostrar un número menor que el agente. La pestaña **Panel** es la que hay que creer.
</Note>

Los avisos salen en un orden fijo, no por urgencia: primero el canal de envío, al final los de búsqueda.

## Los tres avisos que muestra todo agente nuevo

Ninguno de los tres es un fallo. Son las tres cosas que el producto te deja a ti a propósito, y las levanta en este orden: algo desde donde enviar, el permiso para empezar a enviar, y un sitio a donde mandar a la gente.

<Screenshot id="getting-started/troubleshooting-your-first-agent--post-onboarding-stack" frame="bare" lang="es" alt="Dos avisos apilados en la parte superior del panel de un agente: 'Ningún canal de envío conectado' con un botón Conectar remitentes, y 'La prospección está pausada mientras la búsqueda sigue activa' con un botón Reanudar prospección" caption="Los dos primeros, tal como llegan. El aviso del objetivo va debajo de ellos, en la misma franja." marks={[{ n: 1, x: 88, y: 24 }, { n: 2, x: 88, y: 74 }]} />

### Ningún canal de envío conectado

El agente no tiene desde dónde enviar: ninguna cuenta de email, ninguna de LinkedIn y ninguna de WhatsApp. Un espacio de trabajo nuevo no tiene ninguna, y por eso es lo primero que dice un primer agente.

**Conectar remitentes** (1) abre la capa de alta de remitentes encima de la página en la que estás, en vez de llevarte a la página de **Cuentas de Email**. [Conectar tu primer buzón](/es/getting-started/connect-your-first-email-account) tiene página propia.

Un agente configurado para rotar entre todas las cuentas de email del espacio de trabajo sigue mostrando este aviso mientras el espacio no tenga ninguna. Rotar sobre una lista vacía no envía nada, así que el aviso es correcto.

### La prospección está pausada mientras la búsqueda sigue activa

La búsqueda de leads del agente está produciendo y su prospección está apagada, así que llegan leads y nadie los contacta.

Aparece solo en esa combinación exacta. Una fuente que está en cola y aún no arrancó no cuenta como activa, así que un espacio de trabajo cuya primera búsqueda todavía espera su turno no ve ningún aviso aquí, aunque la prospección esté apagada.

**Reanudar prospección** (2) actúa donde estás: no cambia de página ni abre ningún diálogo. El botón muestra un indicador mientras trabaja y luego confirma con **Prospección reanudada**. Si falla, aparece un mensaje de error general y el aviso se queda.

### Al objetivo le falta su llamada a la acción

El agente sabe qué quiere conseguir pero no tiene a dónde mandar a nadie. Tu primer agente se construye con el objetivo en **Enlace de Reunión** y sin ningún enlace asociado, así que este aviso está desde el momento en que el agente existe.

**Configurar objetivo** abre la sección **Objetivo** de la pestaña **Configuración** del agente. Ahí puedes darle un destino al objetivo de reunión: elige uno de tus enlaces de reunión o pega una URL de reserva de cualquier otra herramienta de calendario. También puedes cambiar el objetivo a **Enlace al sitio web**, **WhatsApp** o **Personalizado**.

Cada objetivo tiene su propio campo, y el aviso desaparece cuando ese campo está lleno. Es un enlace para una reunión, una dirección web, un número de teléfono, o la descripción que escribes tú para un objetivo personalizado.

<Warning>
  Resolver uno de los tres no hace nada por los otros dos. Reanudar la prospección deja el aviso del canal que falta exactamente donde estaba, conectar un buzón no reanuda la prospección, y ninguno de los dos toca el objetivo. Un espacio de trabajo nuevo tiene los tres por resolver.
</Warning>

## Cuando la búsqueda se detiene

### Búsqueda pausada: sin créditos

Al menos una de las fuentes de leads del agente se detuvo porque el espacio de trabajo se quedó sin créditos. Si todavía estás en prueba, [qué cubren tus créditos de prueba](/es/billing/free-trial-credits) merece una lectura antes de comprar más.

**Obtener más créditos** abre el diálogo de suscripción encima de la página. No navega a ningún sitio, así que no pierdes tu sitio en el panel.

Cuando el espacio de trabajo vuelve a tener créditos, no tienes que reiniciar nada. Da igual si compraste créditos o si empezó un periodo de facturación nuevo. Revisamos cada cierto tiempo todas las fuentes pausadas por este motivo y ponemos a trabajar las que ya pueden pagar. No es inmediato. La fuente sigue pausada y el aviso sigue puesto hasta que esa revisión vuelva a ejecutarse, así que una fuente que sigue ahí un rato después de recargar créditos se está comportando de forma normal.

<Screenshot id="getting-started/troubleshooting-your-first-agent--no-credits" frame="bare" lang="en" alt="Un aviso que dice 'Sourcing paused,' avisando de que el espacio de trabajo se quedó sin créditos, sobre la línea 'Your agent stopped finding new companies because the workspace ran out of credits', con un botón Get more credits" caption="El botón abre el diálogo de suscripción sin moverte: no sales del agente." />

### La búsqueda alcanzó su límite de empresas

Al menos una fuente ya analizó todas las empresas que permite su límite.

El mismo aviso, con las mismas palabras y el mismo botón, aparece también cuando todas las búsquedas del agente terminaron: una situación distinta con un significado distinto. Hay dos formas de distinguirlas:

* La **Lista de configuración** de la columna lateral da la búsqueda por hecha cuando terminó, y la deja pendiente de atención cuando una fuente se paró en su límite. Una fila verde en la lista bajo un aviso ámbar significa que las búsquedas terminaron.
* La pestaña **Fuentes** levanta este aviso solo en el caso del límite. Si el aviso está en la pestaña **Panel** y no en la pestaña **Fuentes**, las búsquedas terminaron.

**Aumentar límite** edita un solo número, el límite de empresas de esa fuente. Abre un editor pequeño junto al botón, así que no sales del panel. Cuando hay más de una fuente agotada en el agente, el botón no puede saber a cuál te referías y cambia a la pestaña **Fuentes**.

<Screenshot id="getting-started/troubleshooting-your-first-agent--company-limit" url="/ai-agents/12" lang="en" alt="El panel de un agente mostrando el aviso 'Sourcing reached its company limit' con el editor del límite de empresas abierto junto a su botón Increase limit" caption="Una sola fuente agotada se edita ahí mismo. Con dos o más, el botón se rinde y abre la pestaña Fuentes." />

## Los otros avisos que puede levantar un primer agente

| Aviso                                                    | Qué te está diciendo                                                                              | Su botón                                                                                  |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| **Algunos remitentes necesitan atención**                | Una o más de las cuentas de email que puede usar este agente dejaron de enviar                    | **Revisar remitentes** abre la página de **Cuentas de Email**                             |
| **Ninguna etiqueta vinculada a este agente**             | El agente no tiene etiqueta, así que no puede reclamar leads, embudo ni métricas propias          | **Vincular una etiqueta** abre la pestaña **Configuración** del agente                    |
| **Aún no hay leads que coincidan**                       | La búsqueda analizó empresas y ninguna superó tus criterios                                       | **Ajustar segmentación** abre la pestaña **Fuentes**                                      |
| **Aún no hay leads alcanzables por WhatsApp**            | El agente envía solo por WhatsApp y ninguno de sus leads tiene número de teléfono                 | **Revisar canales** abre la sección de canales de la pestaña **Configuración** del agente |
| **Las cuentas de WhatsApp no pueden enviar ahora mismo** | Todas las cuentas de WhatsApp del agente agotaron su presupuesto de hoy; el envío se reanuda solo | **Revisar cuentas** abre la página de cuentas de WhatsApp                                 |

El canal que falta y el objetivo sin llamada a la acción son los dos que el producto trata como bloqueantes, y los dos que además ponen un punto en la pestaña **Configuración**. Nada de esta tabla lleva esa marca. [Avisos del agente y qué hacer con ellos](/es/ai-agents/agent-alerts-and-issues) los cubre todos a fondo.

## Cuando el alta es lo que falla

<Note>
  El asistente de alta se muestra en inglés sea cual sea el idioma del resto de la aplicación.
</Note>

### "We couldn't analyze that website. Let's set it up manually."

El análisis del sitio web que escribiste falló. El asistente te lleva directo a la primera de sus cuatro preguntas manuales: cómo se llama tu negocio, a qué se dedica, en qué idioma trabaja y a qué sectores vendes. Son los mismos cuatro campos que habría rellenado el análisis, así que no pierdes nada más que el tiempo de escribirlos. La dirección que escribiste se conserva.

Volver atrás desde esa primera pregunta te devuelve al campo del sitio web, así que puedes corregir la dirección y probar otra vez en lugar de escribirlo todo.

<Screenshot id="getting-started/troubleshooting-your-first-agent--scrape-failed" lang="en" alt="El asistente de alta mostrando un aviso emergente que dice 'We couldn't analyze that website. Let's set it up manually.' sobre la primera pregunta manual, que pregunta cómo se llama el negocio" caption="Un ejemplo representativo, reproducido y no sembrado. El asistente nunca te deja sin salida: siempre tiene un camino manual." />

### El análisis tarda demasiado

La pantalla de espera va narrando lo que hace línea a línea. Esa narración es el mismo guion cronometrado que el producto usa en todos los sitios donde espera a un modelo: no informa del progreso y nunca anuncia que terminó.

Si el análisis se alarga, aparece debajo un panel encabezado **This is taking longer than expected**, que ofrece **Keep waiting**, **Continue manually** y (solo si ya perteneces a un espacio de trabajo) **Back to workspaces**. Un enlace **Change website** está bajo el texto todo el tiempo, haya panel o no.

**Keep waiting** solo cierra el panel. El análisis nunca se detuvo y te lleva al paso siguiente por su cuenta si termina. Las otras tres opciones dejan de esperarlo.

### No pudimos crear tu primer agente

Tu primer agente se construye por ti después del alta, de nuestro lado. Mientras eso pasa, la página de Agentes IA muestra una tarjeta encabezada **Generando tu primer agente de IA** con una lista de etapas al lado. Esas etapas son una animación cronometrada: que una se encienda no significa que haya terminado.

Si la construcción falla, la tarjeta cambia las etapas por **No pudimos crear tu primer agente** y un único botón **Intentar de nuevo**, que arranca la construcción otra vez y vuelve a esperar. Si el panel a pantalla completa que se abre encima de la página sigue puesto, el mismo mensaje y el mismo botón aparecen ahí.

Mientras la tarjeta espera, comprueba el estado de la construcción en bucle. Una comprobación que falla por su cuenta (una conexión caída, un momento de red mala) se descarta y se vuelve a intentar. Una tarjeta que sigue mostrando etapas no te está escondiendo un error.

**Intentar de nuevo** no funciona así. Si la petición que reinicia la construcción no se puede ni enviar, el mismo mensaje de fallo vuelve al instante. Vuelve a pulsar el botón.

<Screenshot id="getting-started/troubleshooting-your-first-agent--generation-failed" frame="bare" lang="en" alt="La tarjeta del primer agente en su estado fallido: el título 'We couldn't build your first agent', la línea 'Something went wrong while setting things up. You can try again, or create an agent manually.' y un botón Try again" caption="Un ejemplo representativo, reproducido y no sembrado. Es el único fallo del primer agente que te ofrece reintentar." />

### La página de Agentes IA está vacía y no se está creando nada

Llegas a la página de Agentes IA después del alta y no encuentras agentes, ni tarjeta, ni error. Eso significa que la petición que arranca la construcción nunca llegó. El alta no se detiene por eso, te mete en el espacio de trabajo igual, así que el fallo se ve como una página vacía.

Desde esa pantalla no hay nada que reintentar. Crea uno tú con **Crear agente IA**, o usa **Sugerir con IA** para que te propongan la configuración, siguiendo [tu primer agente IA](/es/getting-started/your-first-ai-agent).

La tarjeta además solo se recuerda en la pestaña del navegador en la que terminaste el alta. Abre el espacio de trabajo en otra pestaña, o vuelve después de cerrar el navegador, y la tarjeta ya no está aunque la construcción siga en marcha. La lista se refresca sola mientras la miras, así que el agente aparece por su cuenta en cuanto está listo.

## Relacionado

<CardGroup cols={2}>
  <Card title="Avisos del agente y qué hacer con ellos" icon="triangle-alert" href="/es/ai-agents/agent-alerts-and-issues">
    Todos los avisos que puede levantar un agente, no solo los que muestra uno nuevo.
  </Card>

  <Card title="La lista de configuración del agente, explicada" icon="list" href="/es/getting-started/setup-checklist">
    La tarjeta de la columna lateral, y por qué puede no coincidir con un aviso.
  </Card>

  <Card title="Ningún canal de envío conectado" icon="send" href="/es/troubleshooting/agent-not-sending">
    Todas las razones por las que un agente no envía nada, en el orden que conviene revisar.
  </Card>

  <Card title="No se encuentran leads" icon="search" href="/es/troubleshooting/no-leads-found">
    Qué cambiar cuando la búsqueda corre y nada coincide.
  </Card>
</CardGroup>
