> ## Documentation Index
> Fetch the complete documentation index at: https://puzzlet-9ba7bb98.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# AutoGen

> Trace Microsoft AutoGen (AgentChat) agents in AgentMark using the OpenInference instrumentor.

export const props_0 = undefined

export const subject_0 = "AutoGen"

The OpenInference `AutoGen AgentChat` instrumentor instruments [AutoGen](https://github.com/microsoft/autogen) AgentChat agents, capturing agent runs, model calls, and tool calls as OTLP spans. Point the exporter at AgentMark and the traces arrive normalized. AutoGen is a Python framework.

## Setup

<Steps>
  <Step title="Install the instrumentor and the OTLP exporter">
    ```bash theme={null}
    pip install openinference-instrumentation-autogen-agentchat \
      opentelemetry-sdk opentelemetry-exporter-otlp-proto-http
    ```
  </Step>

  <Step title="Point the exporter at AgentMark and instrument AutoGen">
    Use your AgentMark API key and app id from project settings.

    ```python theme={null}
    from openinference.instrumentation.autogen_agentchat import AutogenAgentChatInstrumentor
    from opentelemetry.sdk.trace import TracerProvider
    from opentelemetry.sdk.trace.export import BatchSpanProcessor
    from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter

    provider = TracerProvider()
    provider.add_span_processor(
        BatchSpanProcessor(
            OTLPSpanExporter(
                endpoint="https://api.agentmark.co/v1/traces",
                headers={
                    "Authorization": "<YOUR_API_KEY>",  # raw key, no "Bearer" prefix
                    "X-Agentmark-App-Id": "<YOUR_APP_ID>",
                },
            )
        )
    )

    AutogenAgentChatInstrumentor().instrument(tracer_provider=provider)
    ```
  </Step>

  <Step title="Run your agent">
    Run your AutoGen agents as usual. Each agent run, model call, and tool call arrives in AgentMark as a span, grouped into a trace. See [Traces and logs](/observe/traces-and-logs).
  </Step>
</Steps>

## What AgentMark captures

{props_0.subject_0} spans use the OpenInference attribute conventions: model, token usage, input and output messages, tool calls, settings, and span kind are all mapped onto AgentMark's normalized trace fields, and token counts feed [cost tracking](/observe/cost-and-token-tracking). See [OpenInference](/integrations/tracing/openinference#what-agentmark-captures) for the full attribute mapping.

<Note>
  The instrumentor captures agent and tool spans for any model client. It captures the model-call span (carrying model name and token counts) for AutoGen's OpenAI-compatible clients (`OpenAIChatCompletionClient`, `AzureOpenAIChatCompletionClient`).
</Note>

## Next steps

<CardGroup cols={2}>
  <Card title="OpenInference" icon="diagram-project" href="/integrations/tracing/openinference">
    How AgentMark reads OpenInference attributes
  </Card>

  <Card title="Traces and logs" icon="list-tree" href="/observe/traces-and-logs">
    Explore traces once they arrive
  </Card>
</CardGroup>

<div className="mt-8 rounded-lg bg-blue-50 p-6 dark:bg-blue-900/30">
  <h3 className="font-semibold mb-3">Have questions?</h3>
  <p className="mb-4">Reach out any time:</p>

  <ul>
    <li>
      Email the team at <a href="mailto:hello@agentmark.co" className="text-blue-600 hover:text-blue-800 dark:text-blue-400 dark:hover:text-blue-200">[hello@agentmark.co](mailto:hello@agentmark.co)</a> for support
    </li>

    <li>
      Schedule an <a href="https://cal.com/ryan-randall/enterprise" className="text-blue-600 hover:text-blue-800 dark:text-blue-400 dark:hover:text-blue-200">Enterprise Demo</a> to learn about AgentMark's business solutions
    </li>
  </ul>
</div>