Início rápido

ConstruirPrimeiros passos

Comece com Claude Managed Agents

Crie seu primeiro agente autônomo.

Este guia orienta você na criação de um agente, configuração de um ambiente, início de uma sessão e transmissão de respostas do agente.

Conceitos principais

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)

Pré-requisitos

Uma conta no Console da Anthropic
Uma chave de API

Instalar a CLI

Verifique a instalação:

ant --version

Instalar o SDK

Defina sua chave de API como uma variável de ambiente:

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

Crie sua primeira sessão

Todas as requisições à API do Managed Agents requerem o cabeçalho beta managed-agents-2026-04-01. O SDK define o cabeçalho beta automaticamente.

Criar um agente
Crie um agente que define o modelo, o prompt do sistema e as ferramentas disponíveis.
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}'
O tipo de ferramenta agent_toolset_20260401 habilita o conjunto completo de ferramentas de agente pré-construídas (bash, operações de arquivo, pesquisa na web e mais). Consulte Ferramentas para a lista completa e opções de configuração por ferramenta.
Salve o agent.id retornado. Você o referenciará em cada sessão que criar.
Criar um ambiente
Um ambiente define o contêiner onde seu agente é executado.
ant beta:environments create \ --name "quickstart-env" \ --config '{type: cloud, networking: {type: unrestricted}}'
Salve o environment.id retornado. Você o referenciará em cada sessão que criar.

Iniciar uma sessão

Crie uma sessão que referencia seu agente e ambiente.

session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    title="Quickstart session",
)

print(f"Session ID: {session.id}")

Enviar uma mensagem e transmitir a resposta

Abra um stream, envie um evento de usuário e processe os eventos conforme chegam:

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

O agente escreverá um script Python, o executará no contêiner e verificará se o arquivo de saída foi criado. Sua saída será semelhante a esta:

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.

O que está acontecendo

Quando você envia um evento de usuário, o Claude Managed Agents:

Provisiona um contêiner: Sua configuração de ambiente determina como ele é construído.
Executa o loop do agente: Claude decide quais ferramentas usar com base na sua mensagem
Executa ferramentas: Gravações de arquivos, comandos bash e outras chamadas de ferramentas são executadas dentro do contêiner
Transmite eventos: Você recebe atualizações em tempo real enquanto o agente trabalha
Fica ocioso: O agente emite um evento session.status_idle quando não tem mais nada a fazer

Próximos passos

Defina seu agente

Crie configurações de agente reutilizáveis e versionadas

Configure ambientes

Personalize configurações de rede e contêiner

Ferramentas do agente

Habilite ferramentas específicas para seu agente

Eventos e streaming

Gerencie eventos e direcione o agente durante a execução

Was this page helpful?

ConstruirPrimeiros passos

Comece com Claude Managed Agents

Crie seu primeiro agente autônomo.

Este guia orienta você na criação de um agente, configuração de um ambiente, início de uma sessão e transmissão de respostas do agente.

Conceitos principais

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)

Pré-requisitos

Uma conta no Console da Anthropic
Uma chave de API

Instalar a CLI

Verifique a instalação:

ant --version

Instalar o SDK

Defina sua chave de API como uma variável de ambiente:

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

Crie sua primeira sessão

Todas as requisições à API do Managed Agents requerem o cabeçalho beta managed-agents-2026-04-01. O SDK define o cabeçalho beta automaticamente.

Criar um agente
Crie um agente que define o modelo, o prompt do sistema e as ferramentas disponíveis.
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}'
O tipo de ferramenta agent_toolset_20260401 habilita o conjunto completo de ferramentas de agente pré-construídas (bash, operações de arquivo, pesquisa na web e mais). Consulte Ferramentas para a lista completa e opções de configuração por ferramenta.
Salve o agent.id retornado. Você o referenciará em cada sessão que criar.
Criar um ambiente
Um ambiente define o contêiner onde seu agente é executado.
ant beta:environments create \ --name "quickstart-env" \ --config '{type: cloud, networking: {type: unrestricted}}'
Salve o environment.id retornado. Você o referenciará em cada sessão que criar.

Iniciar uma sessão

Crie uma sessão que referencia seu agente e ambiente.

session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    title="Quickstart session",
)

print(f"Session ID: {session.id}")

Enviar uma mensagem e transmitir a resposta

Abra um stream, envie um evento de usuário e processe os eventos conforme chegam:

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

O agente escreverá um script Python, o executará no contêiner e verificará se o arquivo de saída foi criado. Sua saída será semelhante a esta:

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.

O que está acontecendo

Quando você envia um evento de usuário, o Claude Managed Agents:

Provisiona um contêiner: Sua configuração de ambiente determina como ele é construído.
Executa o loop do agente: Claude decide quais ferramentas usar com base na sua mensagem
Executa ferramentas: Gravações de arquivos, comandos bash e outras chamadas de ferramentas são executadas dentro do contêiner
Transmite eventos: Você recebe atualizações em tempo real enquanto o agente trabalha
Fica ocioso: O agente emite um evento session.status_idle quando não tem mais nada a fazer

Próximos passos

Defina seu agente

Crie configurações de agente reutilizáveis e versionadas

Configure ambientes

Personalize configurações de rede e contêiner

Ferramentas do agente

Habilite ferramentas específicas para seu agente

Eventos e streaming

Gerencie eventos e direcione o agente durante a execução

Was this page helpful?