Inicio rápido

ConstruirPrimeros pasos

Comenzar con Claude Managed Agents

Crea tu primer agente autónomo.

Esta guía te lleva a través de la creación de un agente, la configuración de un entorno, el inicio de una sesión y la transmisión de respuestas del agente.

Conceptos principales

Concept	Description
Agent	The model, system prompt, tools, MCP servers, and skills
Environment	Configuration for where sessions run: an Anthropic-managed cloud container, or a self-hosted sandbox on your own infrastructure
Session	A running agent instance within an environment, performing a specific task and generating outputs
Events	Messages exchanged between your application and the agent (user turns, tool results, status updates)

Requisitos previos

Una cuenta de Console de Anthropic
Una clave de API

Instalar la CLI

Verifica la instalación:

ant --version

Instalar el SDK

Establece tu clave de API como variable de entorno:

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

Crea tu primera sesión

Todas las solicitudes a la API de Managed Agents requieren el encabezado beta managed-agents-2026-04-01. El SDK establece el encabezado beta automáticamente.

Crear un agente
Crea un agente que defina el modelo, el prompt del sistema y las herramientas disponibles.
ant beta:agents create \ --name "Coding Assistant" \ --model '{id: claude-opus-4-7}' \ --system "You are a helpful coding assistant. Write clean, well-documented code." \ --tool '{type: agent_toolset_20260401}'
El 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 por herramienta.
Guarda el agent.id devuelto. Lo referenciarás en cada sesión que crees.
Crear un entorno
Un entorno define el contenedor donde se ejecuta tu agente.
ant beta:environments create \ --name "quickstart-env" \ --config '{type: cloud, networking: {type: unrestricted}}'
Guarda el environment.id devuelto. Lo referenciarás en cada sesión que crees.

Iniciar 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}")

Enviar un mensaje y transmitir la respuesta

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:
    # Send the user message after the stream opens
    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",
                    },
                ],
            },
        ],
    )

    # Process streaming events
    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.")
                break

El agente escribirá un script de Python, lo ejecutará en el contenedor y verificará que el archivo de salida fue creado. 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á ocurriendo

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

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

Próximos pasos

Define tu agente

Crea configuraciones de agente reutilizables y versionadas

Configurar entornos

Personaliza la configuración de red y del contenedor

Herramientas del agente

Habilita herramientas específicas para tu agente

Eventos y streaming

Maneja eventos y dirige al agente durante la ejecución

Was this page helpful?

ConstruirPrimeros pasos

Comenzar con Claude Managed Agents

Crea tu primer agente autónomo.

Esta guía te lleva a través de la creación de un agente, la configuración de un entorno, el inicio de una sesión y la transmisión de respuestas del agente.

Conceptos principales

Concept	Description
Agent	The model, system prompt, tools, MCP servers, and skills
Environment	Configuration for where sessions run: an Anthropic-managed cloud container, or a self-hosted sandbox on your own infrastructure
Session	A running agent instance within an environment, performing a specific task and generating outputs
Events	Messages exchanged between your application and the agent (user turns, tool results, status updates)

Requisitos previos

Una cuenta de Console de Anthropic
Una clave de API

Instalar la CLI

Verifica la instalación:

ant --version

Instalar el SDK

Establece tu clave de API como variable de entorno:

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

Crea tu primera sesión

Todas las solicitudes a la API de Managed Agents requieren el encabezado beta managed-agents-2026-04-01. El SDK establece el encabezado beta automáticamente.

Crear un agente
Crea un agente que defina el modelo, el prompt del sistema y las herramientas disponibles.
ant beta:agents create \ --name "Coding Assistant" \ --model '{id: claude-opus-4-7}' \ --system "You are a helpful coding assistant. Write clean, well-documented code." \ --tool '{type: agent_toolset_20260401}'
El 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 por herramienta.
Guarda el agent.id devuelto. Lo referenciarás en cada sesión que crees.
Crear un entorno
Un entorno define el contenedor donde se ejecuta tu agente.
ant beta:environments create \ --name "quickstart-env" \ --config '{type: cloud, networking: {type: unrestricted}}'
Guarda el environment.id devuelto. Lo referenciarás en cada sesión que crees.

Iniciar 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}")

Enviar un mensaje y transmitir la respuesta

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:
    # Send the user message after the stream opens
    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",
                    },
                ],
            },
        ],
    )

    # Process streaming events
    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.")
                break

El agente escribirá un script de Python, lo ejecutará en el contenedor y verificará que el archivo de salida fue creado. 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á ocurriendo

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

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

Próximos pasos

Define tu agente

Crea configuraciones de agente reutilizables y versionadas

Configurar entornos

Personaliza la configuración de red y del contenedor

Herramientas del agente

Habilita herramientas específicas para tu agente

Eventos y streaming

Maneja eventos y dirige al agente durante la ejecución

Was this page helpful?