Comienza con Claude Managed Agents

Esta guía te lleva paso a paso por 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.

Conceptos principales

Requisitos previos

• Una cuenta de Claude Console
• Una clave de API

Instala la CLI

brew install anthropics/tap/ant

Verifica la instalación:

ant --version

Instala el SDK

pip install anthropic

Configura tu clave de API como una variable de entorno:

export ANTHROPIC_API_KEY="your-api-key-here"

Crea tu primera sesión

1. 1

   Crea un agente

   Crea un agente que defina el modelo, la "system prompt" (indicación del sistema) y las herramientas disponibles.

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   AGENT_ID=$(ant beta:agents create --transform id --raw-output < coding-assistant.agent.yaml)
   
   echo "Agent ID: $AGENT_ID"

   coding-assistant.agent.yaml

   

   name: Coding Assistant
   model:
     id: claude-opus-5
   system: You are a helpful coding assistant. Write clean, well-documented code.
   tools:
     - type: agent_toolset_20260401

   El tipo de herramienta agent_toolset_20260401 habilita el conjunto completo de herramientas de agente prediseñadas (bash, operaciones de archivos, búsqueda web y más). Consulta Herramientas para ver la lista completa y las opciones de configuración por herramienta.

   Guarda el agent.id devuelto. Lo referenciarás en cada sesión que crees.

2. 2

   Crea un entorno

   Un entorno define el sandbox donde se ejecuta tu agente.

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   ENVIRONMENT_ID=$(ant beta:environments create --transform id --raw-output < quickstart.environment.yaml)
   
   echo "Environment ID: $ENVIRONMENT_ID"

   quickstart.environment.yaml

   

   name: quickstart-env
   config:
     type: cloud
     networking:
       type: unrestricted

   Guarda el environment.id devuelto. Lo referenciarás en cada sesión que crees.

3. 3

   Inicia una sesión

   Crea una sesión que haga referencia a tu agente y a tu entorno.

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   session = client.beta.sessions.create(
       agent=agent.id,
       environment_id=environment.id,
       title="Quickstart session",
   )
   
   print(f"Session ID: {session.id}")

4. 4

   Envía un mensaje y recibe la respuesta por streaming

   Abre un stream, envía un evento de usuario y luego procesa los eventos a medida que llegan:

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   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:
                       if block.type == "text":
                           print(block.text, end="")
               case "agent.tool_use":
                   print(f"\n[Using tool: {event.name}]")
               case "session.status_idle":
                   print("\n\nAgent finished.")
                   break

   El 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.

   

Qué está sucediendo

Cuando envías un evento de usuario, Claude Managed Agents:

1. Aprovisiona un sandbox: La configuración de tu entorno determina cómo se construye.
2. Ejecuta el bucle del agente: Claude determina qué herramientas usar según tu mensaje.
3. Ejecuta herramientas: Las escrituras de archivos, los comandos bash y otras llamadas a herramientas se ejecutan dentro del sandbox.
4. Transmite eventos por streaming: Recibes actualizaciones en tiempo real mientras el agente trabaja.
5. Queda inactivo: El agente emite un evento session.status_idle cuando no tiene nada más que hacer.

Construye una aplicación completa

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 administrada 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.

Próximos pasos