Book a build call
Volver a la Ayuda
Guía

Conecte su propio agente, paso a paso

5 min de lectura

Read in English

Un agente que usted ya ejecuta en su propia computadora puede llegar a casa, a uno de sus agentes de NetShow. Su agente de NetShow sigue al mando y conserva su cara, su voz y su nombre; su propio agente se une como observador y solo responde las preguntas que usted le envía. La guía del Harness le da el panorama general. Esta guía recorre cada paso, desde el código de un solo uso hasta la desconexión.

Sus visitantes nunca ven a su propio agente. Siguen encontrándose con su agente de NetShow, que habla primero y no necesita manos: saluda con la voz propia de NetShow, el micrófono del visitante se abre solo después de que el visitante toca la pantalla, y el chat escrito está en el pequeño menú para quien no tiene micrófono ni bocina.

1. Abra el tablero

En la página de su agente, siga el enlace Harness agents. El tablero se abre con:

Your avatar coordinates. Your own harness agent comes home as an observer.

Es decir: su avatar coordina, y su propio agente llega como observador. Un botón gris Coordinator role explica por qué la coordinación se queda con su agente de NetShow: Only your NetShow Live avatar can coordinate - it holds the voice, the face and the spending fence. Solo su avatar de NetShow Live puede coordinar, porque tiene la voz, la cara y el límite de gasto.

En Your harness home, un tablero nuevo dice No harness agent is home yet. Attach yours below.

2. Elija una receta

La página Bring your agents home muestra cada tipo de agente que usted podría ejecutar y si hoy se puede conectar. Para abrirla, agregue /recipes al final de la dirección del tablero. Una tarjeta marcada Ready muestra el comando exacto que debe ejecutar; una tarjeta marcada Connection unavailable explica el motivo en una línea, y ese tipo todavía no se puede conectar.

La página es clara sobre lo que sale con su agente: Connecting does not share your avatar’s memory or let a harness spend through NetShow. Conectarlo no comparte la memoria de su avatar ni permite que un agente externo gaste a través de NetShow.

Para probar la conexión primero, la tarjeta del Headless CLI agent ofrece un conector de eco, node scripts/outside-agents/harness-connector.mjs --echo, que simplemente le devuelve su texto, así puede revisar el camino sin usar ningún modelo.

3. Genere el código de un solo uso

De vuelta en el tablero, en Attach your agent:

  1. Escriba un Agent name que vaya a reconocer. Las tarjetas de receta usan "CLI agent"; si elige otro nombre, dele al conector el mismo nombre con su opción --name.
  2. Elija la Agent family que coincide con su tarjeta de receta.
  3. Presione Attach. La línea de abajo dice Create a private one-time code for your agent.

Aparece un código con la línea Enter this code in the connector on your own machine. It is shown only here. Una cuenta regresiva debajo muestra cuánto tiempo le queda: vence a los cinco minutos. El tablero no lo vuelve a mostrar si sale de la página o la recarga, y sirve para una sola conexión. Nunca lo pegue en ningún lugar que no sea la pregunta del conector.

Mientras el código espera, Your harness home muestra el nombre de su agente y "Waiting for your agent to connect." Si se acaban los cinco minutos, presione Reconnect; su nota dice Make a fresh code for this agent.

4. Ejecute el conector en su computadora

Download the NetShow connector (zip) · SHA-256 checksum. Node 18+; no npm install. Unzip it and run the commands from the folder you downloaded.

En la computadora donde su agente ya trabaja, ejecute el comando de su tarjeta de receta, tal como lo indica la página: Run the connector from the folder you downloaded and set its --base option to this NetShow site’s address. Cuando el conector lo pida, pegue el código. Su agente se ejecuta en su propia computadora; NetShow no lo ejecuta por usted.

De vuelta en el tablero, Your harness home ahora dice "Home. Connected." con el nombre y la familia que declaró su agente. Sus habilidades aparecen como Skills — declared by your agent, not checked by NetShow: las declaró su agente y NetShow no las verificó.

5. Hágale una pregunta y lea el comprobante

En Ask your harness agent:

Only this question goes to your harness. Its answer stays here for you to read.

Escriba en Your question y presione Ask this agent. La nota dice Send one question, up to 4000 characters. Your harness has 60 seconds to answer. Es decir, una pregunta de hasta 4000 caracteres, y su agente tiene 60 segundos para responder. Pueden esperar hasta cinco preguntas a la vez.

Una línea de comprobante aparece de inmediato debajo del recuadro, empezando con "Waiting for" y el nombre de su agente. Cuando su agente responde, cambia a "Answered by", y la respuesta aparece abajo. La línea también dice cuánto gastó NetShow en la pregunta (nada: el trabajo se hizo en su computadora) y cuántos segundos tardó. Una pregunta que nadie responde a tiempo dice "Expired with".

6. Los cambios esperan su clic

Puede pedirle a su agente de NetShow que pause, reanude, cambie de nombre o desconecte a su propio agente. Nada pasa por sí solo: abra o recargue el tablero, y la tarjeta Your avatar proposes le lee el cambio, por ejemplo "Pause CLI agent."

The change happens only when you click Confirm. This preview expires after five minutes.

Presione Confirm para hacerlo, o Dismiss para descartarlo.

7. Desconéctelo

Presione Detach en Your harness home. Su nota dice lo que hace: Disconnect this agent and clear its relay data.

Después, el tablero dice "Detached. Your agent is no longer connected." Desde ese momento el conector de su computadora ya no es aceptado, cualquier pregunta que siga esperando se rechaza, y Ask this agent queda desactivado. Para volver a traer un agente, presione Attach y genere un código nuevo.

¿Sigues con dudas?

La documentación completa explica a fondo los modelos, la voz, el conocimiento y los flujos de trabajo (en inglés).

Abrir la documentación
Mrs. NetShow, a NetShow Live avatar

I'm Mrs. NetShow, an AI agent. Ask me about attach your own agent, step by step.

You can interrupt me anytime.