Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Esta guía te acompaña en la creación de un agente, la configuración de un entorno, el inicio de una sesión y el streaming de las respuestas del agente.
| Concepto | Descripción |
|---|---|
| Agente | El modelo, la indicación del sistema, las herramientas, los servidores MCP y las habilidades |
| Entorno | Configuración de dónde se ejecutan las sesiones: un sandbox en la nube gestionado por Anthropic, o un sandbox autoalojado en tu propia infraestructura |
| Sesión | Una instancia de agente en ejecución dentro de un entorno, que realiza una tarea específica y genera salidas |
| Eventos | Mensajes intercambiados entre tu aplicación y el agente (turnos del usuario, resultados de herramientas, actualizaciones de estado) |
brew install anthropics/tap/antVerifica la instalación:
ant --versionpip install anthropicConfigura tu clave de API como una variable de entorno:
export ANTHROPIC_API_KEY="your-api-key-here"Crea un agente
Crea un agente que defina el modelo, la indicación del sistema y las herramientas disponibles.
AGENT_ID=$(ant beta:agents create --transform id --raw-output < coding-assistant.agent.yaml)
echo "Agent ID: $AGENT_ID"name: Coding Assistant
model:
id: claude-opus-5
system: You are a helpful coding assistant. Write clean, well-documented code.
tools:
- type: agent_toolset_20260401El tipo de herramienta agent_toolset_20260401 habilita el conjunto completo de herramientas de agente predefinidas (bash, operaciones de archivos, búsqueda web y más). Consulta Herramientas para ver la lista completa y las opciones de configuración de cada herramienta.
Guarda el agent.id devuelto. Lo referenciarás en cada sesión que crees.
Crea un entorno
Un entorno define el sandbox donde se ejecuta tu agente.
ENVIRONMENT_ID=$(ant beta:environments create --transform id --raw-output < quickstart.environment.yaml)
echo "Environment ID: $ENVIRONMENT_ID"name: quickstart-env
config:
type: cloud
networking:
type: unrestrictedGuarda el environment.id devuelto. Lo referenciarás en cada sesión que crees.
Inicia una sesión
Crea una sesión que haga referencia a tu agente y entorno.
session = client.beta.sessions.create(
agent=agent.id,
environment_id=environment.id,
title="Quickstart session",
)
print(f"Session ID: {session.id}")Envía un mensaje y transmite la respuesta por streaming
Abre un stream, envía un evento de usuario y luego procesa los eventos a medida que llegan:
with client.beta.sessions.events.stream(session.id) as stream:
# Envía el mensaje del usuario después de que se abra el stream
client.beta.sessions.events.send(
session.id,
events=[
{
"type": "user.message",
"content": [
{
"type": "text",
"text": "Create a Python script that generates the first 20 Fibonacci numbers and saves them to fibonacci.txt",
},
],
},
],
)
# Procesa los eventos de streaming
for event in stream:
match event.type:
case "agent.message":
for block in event.content:
print(block.text, end="")
case "agent.tool_use":
print(f"\n[Using tool: {event.name}]")
case "session.status_idle":
print("\n\nAgent finished.")
breakEl agente escribe un script de Python, lo ejecuta en el sandbox y verifica que se haya creado el archivo de salida. Tu salida se verá similar a esto:
I'll create a Python script that generates the first 20 Fibonacci numbers and saves them to a file.
[Using tool: write]
[Using tool: bash]
The script ran successfully. Let me verify the output file.
[Using tool: bash]
fibonacci.txt contains the first 20 Fibonacci numbers (0 through 4181).
Agent finished.Cuando envías un evento de usuario, Claude Managed Agents:
session.status_idle cuando no tiene nada más que hacer.Cada uno de estos quickstarts combina Claude Managed Agents con un framework de chat popular para crear una aplicación completa y ejecutable. En cada uno, el framework renderiza la interfaz de chat mientras una sesión gestionada ejecuta el bucle del agente del lado del servidor: la sesión mantiene la transcripción, ejecuta herramientas en un sandbox y transmite por streaming los eventos que el front end renderiza.
Un analista de investigación en un chat de navegador construido con el Chat SDK de Vercel. Cada conversación es una sesión persistente que transmite su respuesta por streaming mientras un feed en vivo muestra las llamadas a herramientas. Cambiar el adaptador del Chat SDK traslada el mismo handler a Slack, Teams, Discord o WhatsApp.
Un analista de hojas de cálculo en un chat construido con primitivas de assistant-ui. Las sesiones son la lista de hilos, un reducer convierte el registro de eventos de la sesión en mensajes y tarjetas de herramientas, y cada comando bash renderiza una puerta de Permitir/Denegar en línea antes de ejecutarse.
Un asistente de finanzas personales en un chat de CopilotKit. El adaptador AG-UI para Claude Managed Agents asigna cada hilo de chat a una sesión gestionada y transmite las respuestas token por token, y las herramientas personalizadas renderizan gráficos interactivos en línea dentro de la conversación.
Crea configuraciones de agente reutilizables y versionadas
Personaliza la configuración de red y del sandbox
Habilita herramientas específicas para tu agente
Maneja eventos y dirige al agente durante la ejecución
Ejecuta tu agente en un horario cron recurrente
Destila un corpus de documentos una sola vez en una wiki de conocimiento y luego responde preguntas repetidas a partir de ella a una fracción del costo
Was this page helpful?