:root {
  --ifm-background-section-color: #f2f2f2;
  --ifm-background-section-dark: #2c2c2c;
  --ifm-text-color: black;
  --ifm-text-color-dark: white;
}

html[data-theme="light"] .card {
  background-color: var(--ifm-background-section-color);
  color: var(--ifm-text-color);
}

html[data-theme="dark"] .card {
  background-color: var(--ifm-background-section-dark);
  color: var(--ifm-text-color-dark);
}

.features {
  padding: 3rem 0;
}

.feature {
  display: flex !important;
  flex-direction: column;
}

.feature a {
  color: unset;
  text-decoration: none;
}

.card {
  flex-grow: 1;
  justify-content: center;
  padding: 1rem;
  border-radius: 8px;
}

.titles {
  height: 120px;
}

@media screen and (max-width: 1200px) {
  .titles {
    height: 260px;
  }
}

@media screen and (max-width: 1000px) {
  .feature img {
    position: inherit;
    bottom: inherit;
  }

  .feature div {
    height: inherit !important;
    position: inherit !important;
  }
}

@media screen and (max-width: 1200px) {
  #features {
    padding: 3rem 1rem;
  }
}


.features {
  display: flex;
  align-items: center;
  justify-content: center;
  padding: 1rem 0;
  width: 100%;
}

.featureItem {
  display: flex;
  flex-direction: column;
  align-items: center;
  text-align: center;
}

.featureSvg {
  height: 130px;
  width: auto;
  margin-bottom: 1rem;
}


.responsiveIframe {
    width: 90%;
    height: 400px;
    border: none;
    max-width: 1140px;
  }

  .iframeDiv {
    display: flex;
    flex-direction: column;
    align-items: center;
    justify-content: center;
  }

  @media screen and (max-width: 1140px) {
    .responsiveIframe {
      width: 90%;
      height: 350px;
    }
  }

  @media screen and (max-width: 768px) {
    .responsiveIframe {
      width: 100%;
      height: 300px;
    }
  }

  @media screen and (max-width: 425px) {
    .responsiveIframe {
      width: 100%;
      height: 280px;
    }
  }


/* stylelint-disable docusaurus/copyright-header */
/* cspell:ignore Infima,Csvg */

/**
 * Any CSS included here will be global. The classic template
 * bundles Infima by default. Infima is a CSS framework designed to
 * work well for content-centric websites.
 */

/* You can override the default Infima variables here. */
:root {
  /* Colors generated from: https://docusaurus.io/docs/styling-layout */
  --ifm-color-primary: #4b9cd6;
  --ifm-color-primary-dark: #338fd1;
  --ifm-color-primary-darker: #2e88c8;
  --ifm-color-primary-darkest: #2670a5;
  --ifm-color-primary-light: #63a9db;
  --ifm-color-primary-lighter: #6eafde;
  --ifm-color-primary-lightest: #92c3e6;
  --ifm-code-font-size: 95%;
}

.docusaurus-highlight-code-line {
  background-color: rgba(0, 0, 0, 0.1);
  display: block;
  margin: 0 calc(-1 * var(--ifm-pre-padding));
  padding: 0 var(--ifm-pre-padding);
}

html[data-theme="dark"] .docusaurus-highlight-code-line {
  background-color: #4b9cd6;
}

/* For top navbar */

.header-github-link {
  display: flex;
  min-height: 28px;
}

.header-github-link:hover {
  opacity: 0.6;
}

.header-github-link:before {
  content: "";
  width: 24px;
  height: 24px;
  background: url("data:image/svg+xml,%3Csvg viewBox='0 0 24 24' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12'/%3E%3C/svg%3E")
    no-repeat;
}

html[data-theme="dark"] .header-github-link:before {
  background: url("data:image/svg+xml,%3Csvg viewBox='0 0 24 24' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath fill='white' d='M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12'/%3E%3C/svg%3E")
    no-repeat;
}

.header-github-link:after {
  content: "GitHub";
  padding-left: 0.5em;
}

.header-discord-link {
  display: flex;
  min-height: 28px;
}

.header-discord-link:hover {
  opacity: 0.6;
}

.header-discord-link:before {
  content: "";
  width: 28px;
  height: 28px;
  background: url("data:image/svg+xml,%3Csvg viewBox='0 0 24 24' fill='black' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M20.317 4.3698a19.7913 19.7913 0 00-4.8851-1.5152.0741.0741 0 00-.0785.0371c-.211.3753-.4447.8648-.6083 1.2495-1.8447-.2762-3.68-.2762-5.4868 0-.1636-.3933-.4058-.8742-.6177-1.2495a.077.077 0 00-.0785-.037 19.7363 19.7363 0 00-4.8852 1.515.0699.0699 0 00-.0321.0277C.5334 9.0458-.319 13.5799.0992 18.0578a.0824.0824 0 00.0312.0561c2.0528 1.5076 4.0413 2.4228 5.9929 3.0294a.0777.0777 0 00.0842-.0276c.4616-.6304.8731-1.2952 1.226-1.9942a.076.076 0 00-.0416-.1057c-.6528-.2476-1.2743-.5495-1.8722-.8923a.077.077 0 01-.0076-.1277c.1258-.0943.2517-.1923.3718-.2914a.0743.0743 0 01.0776-.0105c3.9278 1.7933 8.18 1.7933 12.0614 0a.0739.0739 0 01.0785.0095c.1202.099.246.1981.3728.2924a.077.077 0 01-.0066.1276 12.2986 12.2986 0 01-1.873.8914.0766.0766 0 00-.0407.1067c.3604.698.7719 1.3628 1.225 1.9932a.076.076 0 00.0842.0286c1.961-.6067 3.9495-1.5219 6.0023-3.0294a.077.077 0 00.0313-.0552c.5004-5.177-.8382-9.6739-3.5485-13.6604a.061.061 0 00-.0312-.0286zM8.02 15.3312c-1.1825 0-2.1569-1.0857-2.1569-2.419 0-1.3332.9555-2.4189 2.157-2.4189 1.2108 0 2.1757 1.0952 2.1568 2.419 0 1.3332-.9555 2.4189-2.1569 2.4189zm7.9748 0c-1.1825 0-2.1569-1.0857-2.1569-2.419 0-1.3332.9554-2.4189 2.1569-2.4189 1.2108 0 2.1757 1.0952 2.1568 2.419 0 1.3332-.946 2.4189-2.1568 2.4189Z'/%3E%3C/svg%3E")
    no-repeat;
}

html[data-theme="dark"] .header-discord-link:before {
  background: url("data:image/svg+xml,%3Csvg viewBox='0 0 24 24' fill='white' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M20.317 4.3698a19.7913 19.7913 0 00-4.8851-1.5152.0741.0741 0 00-.0785.0371c-.211.3753-.4447.8648-.6083 1.2495-1.8447-.2762-3.68-.2762-5.4868 0-.1636-.3933-.4058-.8742-.6177-1.2495a.077.077 0 00-.0785-.037 19.7363 19.7363 0 00-4.8852 1.515.0699.0699 0 00-.0321.0277C.5334 9.0458-.319 13.5799.0992 18.0578a.0824.0824 0 00.0312.0561c2.0528 1.5076 4.0413 2.4228 5.9929 3.0294a.0777.0777 0 00.0842-.0276c.4616-.6304.8731-1.2952 1.226-1.9942a.076.076 0 00-.0416-.1057c-.6528-.2476-1.2743-.5495-1.8722-.8923a.077.077 0 01-.0076-.1277c.1258-.0943.2517-.1923.3718-.2914a.0743.0743 0 01.0776-.0105c3.9278 1.7933 8.18 1.7933 12.0614 0a.0739.0739 0 01.0785.0095c.1202.099.246.1981.3728.2924a.077.077 0 01-.0066.1276 12.2986 12.2986 0 01-1.873.8914.0766.0766 0 00-.0407.1067c.3604.698.7719 1.3628 1.225 1.9932a.076.076 0 00.0842.0286c1.961-.6067 3.9495-1.5219 6.0023-3.0294a.077.077 0 00.0313-.0552c.5004-5.177-.8382-9.6739-3.5485-13.6604a.061.061 0 00-.0312-.0286zM8.02 15.3312c-1.1825 0-2.1569-1.0857-2.1569-2.419 0-1.3332.9555-2.4189 2.157-2.4189 1.2108 0 2.1757 1.0952 2.1568 2.419 0 1.3332-.9555 2.4189-2.1569 2.4189zm7.9748 0c-1.1825 0-2.1569-1.0857-2.1569-2.419 0-1.3332.9554-2.4189 2.1569-2.4189 1.2108 0 2.1757 1.0952 2.1568 2.419 0 1.3332-.946 2.4189-2.1568 2.4189Z'/%3E%3C/svg%3E")
    no-repeat;
}

.header-discord-link:after {
  content: "Discord";
  padding-left: 0.5em;

  /* The Discord icon makes the text misaligned by 1 pixel for some reason. */
  position: relative;
  top: 1px;
}

.header-wof-link {
  display: flex;
  min-height: 28px;
}

.header-wof-link:hover {
  opacity: 0.6;
}

.header-wof-link:before {
  content: "";
  width: 24px;
  height: 24px;
  background: url("data:image/svg+xml,%3Csvg viewBox='0 0 24 24' fill='black' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z'/%3E%3C/svg%3E")
    no-repeat;
}

html[data-theme="dark"] .header-wof-link:before {
  background: url("data:image/svg+xml,%3Csvg viewBox='0 0 24 24' fill='white' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z'/%3E%3C/svg%3E")
    no-repeat;
}

.header-wof-link:after {
  content: "Vanilla API Docs";
  padding-left: 0.5em;
}

/* Added styles */

.landing-logo {
  width: 7.5em;
  height: 7.5em;
}

.landing-button {
  margin-left: 0.5em;
  margin-right: 0.5em;
}

.features-icon {
  position: relative;
  top: 1em;
}

.features-language-icon {
  position: relative;
  top: 0.6em;
}

/* Added styles for TypeDoc pages */

html[class*="isaacscript-common"] h3 {
  color: #ac4b29;
}


/* stylelint-disable docusaurus/copyright-header */

/**
 * CSS files with the .module.css suffix will be treated as CSS modules
 * and scoped locally.
 */

.heroBanner {
  padding: 4rem 0;
  text-align: center;
  position: relative;
  overflow: hidden;
}

@media screen and (max-width: 966px) {
  .heroBanner {
    padding: 2rem;
  }
}

.buttons {
  display: flex;
  align-items: center;
  justify-content: center;
}


module.exports = {
  presets: [require.resolve('@docusaurus/core/lib/babel/preset')],
};


/** @type {import('@docusaurus/types').DocusaurusConfig} */
const math = require("remark-math");
const katex = require("rehype-katex");

customPostCssPlugin = () => {
  return {
    name: "custom-postcss",
    configurePostCss(options) {
      options.plugins.push(require("postcss-preset-env"));
      return options;
    },
  };
};

module.exports = {
  title: "AG2",
  tagline: "The Open Source Agent OS",
  url: "https://ag2ai.github.io",
  baseUrl: "/ag2/",
  onBrokenLinks: "throw",
  onBrokenMarkdownLinks: "warn",
  favicon: "img/ag2.ico",
  organizationName: "ag2ai", // Usually your GitHub org/user name.
  projectName: "ag2", // Usually your repo name.
  scripts: [
    {
      src: "/js/custom.js",
      async: true,
      defer: true,
    },
  ],
  markdown: {
    format: "detect", // Support for MD files with .md extension
  },
  themeConfig: {
    themeConfig: {
      colorMode: {
        defaultMode: 'dark',
      },
    },
    docs: {
      sidebar: {
        autoCollapseCategories: true,
      },
    },
    navbar: {
      title: "AG2",
      logo: {
        alt: "AG2",
        src: "img/ag2.svg",
      },
      items: [
        {
          type: "dropdown",
          position: "left",
          label: "Docs",
          items: [
            {
              type: "doc",
              label: "Getting Started",
              docId: "Getting-Started",
            },
            {
              type: "doc",
              label: "Installation",
              docId: "installation/Installation",
            },
            {
              type: "doc",
              label: "Tutorial",
              docId: "tutorial/introduction",
            },
            {
              type: "doc",
              label: "User Guide",
              docId: "topics",
            },
            {
              type: "doc",
              docId: "reference/agentchat/conversable_agent",
              label: "API Reference",
            },
            {
              type: "doc",
              docId: "FAQ",
              label: "FAQs",
            },
            {
              type: "doc",
              docId: "autogen-studio/getting-started",
              label: "AutoGen Studio",
            },
            {
              type: "doc",
              docId: "ecosystem",
              label: "Ecosystem",
            },
            {
              type: "doc",
              label: "Contributor Guide",
              docId: "contributor-guide/contributing",
            },
            {
              type: "doc",
              label: "Research",
              docId: "Research",
            },
          ],
        },
        {
          type: "dropdown",
          position: "left",
          label: "Examples",
          items: [
            {
              type: "doc",
              label: "Examples by Category",
              docId: "Examples",
            },
            {
              type: "doc",
              label: "Examples by Notebook",
              docId: "notebooks",
            },
            {
              type: "doc",
              label: "Application Gallery",
              docId: "Gallery",
            },
          ],
        },
        {
          label: "Other Languages",
          type: "dropdown",
          position: "left",
          items: [
            {
              label: "Dotnet",
              href: "https://ag2ai.github.io/autogen-for-net/",
            },
          ],
        },
        {
          to: "blog",
          label: "Blog",
          position: "left",
        },
        {
          to: "talks",
          label: "Community Talks",
          position: "left",
        },
        {
          href: "https://ag2.ai/",
          label: "AG2.ai",
          position: "right",
        },
        {
          href: "https://github.com/ag2ai/ag2",
          label: "GitHub",
          position: "right",
        },
        {
          href: "https://discord.gg/pAbnFJrkgZ",
          label: "Discord",
          position: "right",
        },
        {
          href: "https://twitter.com/Chi_Wang_",
          label: "Twitter",
          position: "right",
        },
      ],
    },
    footer: {
      style: "dark",
      links: [
        {
          // title: "Community",
          items: [
            //     // {
            //     //   label: 'Stack Overflow',
            //     //   href: 'https://stackoverflow.com/questions/tagged/pymarlin',
            //     // },
            // {
            //   label: "Discord",
            //   href: "https://discord.gg/pAbnFJrkgZ",
            // },
            // {
            //   label: "Twitter",
            //   href: "https://twitter.com/Chi_Wang_",
            // },
          ],
        },
      ],
      copyright: `Copyright © ${new Date().getFullYear()} AG2 Authors`,
    },
    // announcementBar: {
    //   id: "whats_new",
    //   content:
    //     'What\'s new in AutoGen? Read <a href="/autogen/blog/2024/03/03/AutoGen-Update">this blog</a> for an overview of updates',
    //   backgroundColor: "#fafbfc",
    //   textColor: "#091E42",
    //   isCloseable: true,
    // },
    /* Clarity Config */
    // clarity: {
    //   ID: "lnxpe6skj1", // The Tracking ID provided by Clarity
    // },
  },
  presets: [
    [
      "@docusaurus/preset-classic",
      {
        blog: {
          showReadingTime: true,
          blogSidebarCount: "ALL",
          // Adjust any other blog settings as needed
        },
        docs: {
          sidebarPath: require.resolve("./sidebars.js"),
          // Please change this to your repo.
          editUrl: "https://github.com/ag2ai/ag2/edit/main/website/",
          remarkPlugins: [math],
          rehypePlugins: [katex],
        },
        theme: {
          customCss: require.resolve("./src/css/custom.css"),
        },
      },
    ],
  ],
  stylesheets: [
    {
      href: "https://cdn.jsdelivr.net/npm/katex@0.13.11/dist/katex.min.css",
      integrity:
        "sha384-Um5gpz1odJg5Z4HAmzPtgZKdTBHZdw8S29IecapCSB31ligYPhHQZMIlWLYQGVoc",
      crossorigin: "anonymous",
    },
  ],

  plugins: [
    [
      '@docusaurus/plugin-content-blog',
      {
        id: 'talks',
        routeBasePath: 'talks',
        path: './talks',
        showReadingTime: true,
        blogSidebarCount: "ALL",
      },
    ],
    [
      require.resolve("@easyops-cn/docusaurus-search-local"),
      {
        // ... Your options.
        // `hashed` is recommended as long-term-cache of index file is possible.
        hashed: true,
        blogDir: "./blog/",
        // For Docs using Chinese, The `language` is recommended to set to:
        // ```
        // language: ["en", "zh"],
        // ```
        // When applying `zh` in language, please install `nodejieba` in your project.
      },
    ],
    customPostCssPlugin,
    [
      "@docusaurus/plugin-client-redirects",
      {
        redirects: [
          {
            to: "/docs/topics/llm_configuration",
            from: ["/docs/llm_endpoint_configuration/"],
          },
          {
            to: "/docs/Getting-Started",
            from: ["/docs/"],
          },
          {
            to: "/docs/topics/llm_configuration",
            from: ["/docs/llm_configuration"],
          },
          {
            to: "/docs/tutorial/chat-termination",
            from: ["/docs/tutorial/termination"],
          },
          {
            to: "/docs/tutorial/what-next",
            from: ["/docs/tutorial/what-is-next"],
          },
          {
            to: "/docs/topics/non-openai-models/local-lm-studio",
            from: ["/docs/topics/non-openai-models/lm-studio"],
          },
          {
            to: "/notebooks/agentchat_nested_chats_chess",
            from: ["/notebooks/agentchat_chess"],
          },
          {
            to: "/notebooks/agentchat_nested_chats_chess_altmodels",
            from: ["/notebooks/agentchat_chess_altmodels"],
          },
          {
            to: "/docs/contributor-guide/contributing",
            from: ["/docs/Contribute"],
          },
        ],
      },
    ],
    // ["docusaurus-plugin-clarity", {}],
  ],
};


// Load jQuery if not present
if (typeof jQuery === "undefined") {
  const jqueryScript = document.createElement("script");
  jqueryScript.src =
    "https://cdnjs.cloudflare.com/ajax/libs/jquery/3.7.1/jquery.min.js";
  document.head.appendChild(jqueryScript);

  jqueryScript.onload = function () {
    // Load Chosen after jQuery
    const chosenScript = document.createElement("script");
    chosenScript.src =
      "https://cdnjs.cloudflare.com/ajax/libs/chosen/1.8.7/chosen.jquery.min.js";
    document.head.appendChild(chosenScript);

    // Add Chosen CSS
    const chosenStyles = document.createElement("link");
    chosenStyles.rel = "stylesheet";
    chosenStyles.href =
      "https://cdnjs.cloudflare.com/ajax/libs/chosen/1.8.7/chosen.min.css";
    document.head.appendChild(chosenStyles);

    // Initialize Chosen when everything is loaded
    chosenScript.onload = function () {
      initializeGallerySelect();
    };
  };
}

function getTagsFromURL() {
  const searchParams = new URLSearchParams(window.location.search);
  const tags = searchParams.get("tags");
  return tags ? tags.split(",") : [];
}

// Function to initialize Chosen on gallery select
function initializeGallerySelect() {
  // Add flag to check if already initialized
  const selectElement = $(".examples-gallery-container .tag-filter");
  if (selectElement.length && !selectElement.data("chosen-initialized")) {
    selectElement
      .chosen({
        width: "100%",
        placeholder_text_multiple: "Filter by tags",
      })
      .data("chosen-initialized", true);

    // Get tags from URL and update chosen
    const urlTags = getTagsFromURL();
    if (urlTags.length > 0) {
      selectElement.val(urlTags);
      selectElement.trigger("chosen:updated");

      // Trigger the gallery:tagChange event with URL tags
      const customEvent = new CustomEvent("gallery:tagChange", {
        detail: urlTags,
      });
      document.dispatchEvent(customEvent);
    }

    // Set up change handler
    selectElement.on("change", function (evt, params) {
      const selectedValues = $(this).val() || [];
      const customEvent = new CustomEvent("gallery:tagChange", {
        detail: selectedValues,
      });
      document.dispatchEvent(customEvent);
    });
  }
}

// Debounce function
function debounce(func, wait) {
  let timeout;
  return function executedFunction(...args) {
    const later = () => {
      clearTimeout(timeout);
      func(...args);
    };
    clearTimeout(timeout);
    timeout = setTimeout(later, wait);
  };
}

// Debounced version of initialize
const debouncedInitialize = debounce(initializeGallerySelect, 100);

// Watch for URL changes using MutationObserver
const observer = new MutationObserver((mutations) => {
  if (window.location.pathname.includes("/notebooks")) {
    debouncedInitialize();
  }
});

observer.observe(document.body, {
  childList: true,
  subtree: true,
  attributes: false,
  characterData: false,
});

// Initialize on page load
document.addEventListener("DOMContentLoaded", function () {
  if (window.jQuery && window.jQuery.fn.chosen) {
    initializeGallerySelect();
  }
});


/**
 * Creating a sidebar enables you to:
 - create an ordered group of docs
 - render a sidebar for each doc of that group
 - provide next/previous navigation

 The sidebars can be generated from the filesystem, or explicitly defined here.

 Create as many sidebars as you want.
 */

module.exports = {
  docsSidebar: [
    "Getting-Started",
    {
      type: "category",
      label: "Installation",
      collapsed: true,
      items: ["installation/Docker", "installation/Optional-Dependencies"],
      link: {
        type: "doc",
        id: "installation/Installation",
      },
    },
    {
      type: "category",
      label: "Tutorial",
      collapsed: false,
      link: {
        type: "generated-index",
        title: "Tutorial",
        description: "Tutorial on the basic concepts of AutoGen",
        slug: "tutorial",
      },
      items: [
        {
          type: "doc",
          id: "tutorial/introduction",
          label: "Introduction",
        },
        {
          type: "doc",
          id: "tutorial/chat-termination",
          label: "Chat Termination",
        },
        {
          type: "doc",
          id: "tutorial/human-in-the-loop",
          label: "Human in the Loop",
        },
        {
          type: "doc",
          id: "tutorial/code-executors",
          label: "Code Executors",
        },
        {
          type: "doc",
          id: "tutorial/tool-use",
          label: "Tool Use",
        },
        {
          type: "doc",
          id: "tutorial/conversation-patterns",
          label: "Conversation Patterns",
        },
        {
          type: "doc",
          id: "tutorial/what-next",
          label: "What Next?",
        },
      ],
    },
    { "Use Cases": [{ type: "autogenerated", dirName: "Use-Cases" }] },
    {
      type: "category",
      label: "User Guide",
      collapsed: false,
      link: {
        type: "generated-index",
        title: "User Guide",
        slug: "topics",
      },
      items: [{ type: "autogenerated", dirName: "topics" }],
    },
    {
      type: "link",
      label: "API Reference",
      href: "/docs/reference/agentchat/conversable_agent",
    },
    {
      type: "doc",
      label: "FAQs",
      id: "FAQ",
    },

    {
      type: "category",
      label: "AutoGen Studio",
      collapsed: true,
      items: [
        {
          type: "doc",
          id: "autogen-studio/getting-started",
          label: "Getting Started",
        },
        {
          type: "doc",
          id: "autogen-studio/usage",
          label: "Using AutoGen Studio",
        },
        {
          type: "doc",
          id: "autogen-studio/faqs",
          label: "AutoGen Studio FAQs",
        },
      ],
      link: {
        type: "generated-index",
        title: "AutoGen Studio",
        description: "Learn about AutoGen Studio",
        slug: "autogen-studio",
      },
    },
    {
      type: "category",
      label: "Ecosystem",
      link: {
        type: "generated-index",
        title: "Ecosystem",
        description: "Learn about the ecosystem of AutoGen",
        slug: "ecosystem",
      },
      items: [{ type: "autogenerated", dirName: "ecosystem" }],
    },
    {
      type: "category",
      label: "Contributor Guide",
      collapsed: true,
      items: [{ type: "autogenerated", dirName: "contributor-guide" }],
      link: {
        type: "generated-index",
        title: "Contributor Guide",
        description: "Learn how to contribute to AutoGen",
        slug: "contributor-guide",
      },
    },
    "Research",
    "Migration-Guide",
  ],
  // pydoc-markdown auto-generated markdowns from docstrings
  referenceSideBar: [require("./docs/reference/sidebar.json")],
  notebooksSidebar: [
    {
      type: "category",
      label: "Notebooks",
      items: [
        {
          type: "autogenerated",
          dirName: "notebooks",
        },
      ],
      link: {
        type: "doc",
        id: "notebooks",
      },
    },
  ],
};


import React, { useEffect, useState, useCallback } from "react";
import { Card, List, Select, Typography } from "antd";
import { useLocation, useHistory } from "react-router-dom";

const { Option } = Select;
const { Paragraph, Title } = Typography;

const GalleryPage = (props) => {
  const location = useLocation();
  const history = useHistory();

  // Function to get tags from the URL query string.
  const getTagsFromURL = useCallback(() => {
    const searchParams = new URLSearchParams(location.search);
    const tags = searchParams.get("tags");
    return tags ? tags.split(",") : [];
  }, [location.search]);

  // Initialize selectedTags state based on URL parameters.
  const [selectedTags, setSelectedTags] = useState(getTagsFromURL());

  useEffect(() => {
    // Update state if the URL search parameters change.
    const tagsFromURL = getTagsFromURL();
    setSelectedTags(tagsFromURL);
  }, [getTagsFromURL]);

  const TagsView = ({ tags }) => (
    <div className="tags-container">
      {tags?.map((tag, index) => (

        <span className="tag" key={index} onClick={(evt) => {
          if (!selectedTags.includes(tag)) {
            handleTagChange([...selectedTags, tag])
          }
          evt.preventDefault();
          evt.stopPropagation();
          return false;
        }} >
          {tag}
        </span>
      ))}
    </div>
  );

  const allTags = [...new Set(props.items.flatMap((item) => item.tags))];

  const handleTagChange = (tags) => {
    setSelectedTags(tags);
    const searchParams = new URLSearchParams();
    if (tags.length > 0) {
      searchParams.set("tags", tags.join(","));
    }
    history.push(`${location.pathname}?${searchParams.toString()}`);
  };

  const filteredData =
    selectedTags.length > 0
      ? props.items.filter((item) =>
        selectedTags.some((tag) => item.tags.includes(tag))
      )
      : props.items;

  const defaultImageIfNoImage = props.allowDefaultImage ?? true;
  const imageFunc = (item) => {
    const image =
      <img
        alt={item.title}
        src={
          item.image
            ? item.image.includes("http")
              ? item.image
              : `../../static/img/gallery/${item.image}`
            : `../../static/img/gallery/default.png`
        }
        style={{
          height: 150,
          width: "fit-content",
          margin: "auto",
          padding: 2,
        }}
      />
      ;

    const imageToUse = item.image ? image : defaultImageIfNoImage ? image : null;
    return imageToUse;
  }

  const badges = (item) => {
    if (!item.source) {
      return null;
    }
    const colab_href = `https://colab.research.google.com/github/ag2ai/ag2/blob/main/${item.source}`;
    const github_href = `https://github.com/ag2ai/ag2/blob/main/${item.source}`;
    return (<span>
      <a style={{marginRight: '5px'}}href={colab_href} target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
      <a href={github_href} target="_parent"><img alt="Static Badge" src="https://img.shields.io/badge/Open%20on%20GitHub-grey?logo=github"/></a>
      </span>
    );
  }

  const target = props.target ?? "_blank";
  return (
    <div>
      <Select
        mode="multiple"
        placeholder="Filter by tags"
        style={{ width: "100%", marginBottom: 16 }}
        value={selectedTags}
        onChange={handleTagChange}
        aria-label="Filter by tags"
      >
        {allTags.map((tag) => (
          <Option key={tag} value={tag}>
            {tag}
          </Option>
        ))}
      </Select>

      <List
        grid={{
          gutter: 16,
          xs: 1,
          sm: 2,
          md: 2,
          lg: 3,
          xl: 4,
          xxl: 4,
        }}
        dataSource={filteredData}
        renderItem={(item) => (
          <List.Item>
            <a
              href={item.link}
              target={target}
              rel="noopener noreferrer"
              style={{ display: "block" }}
            >
              <Card
                hoverable
                bordered
                style={{ height: 370, paddingTop: imageFunc(item) ? 15 : 0 }}
                cover={imageFunc(item)}
              >
                <Title level={5} ellipsis={{ rows: 4 }}>
                  {item.title}
                </Title>
                {badges(item)}

                <Paragraph
                  ellipsis={{ rows: imageFunc(item) ? 3 : 6 }}
                  style={{
                    fontWeight: "normal",
                    color: "#727272",
                  }}
                >
                  {item.description ? item.description : item.title}
                </Paragraph>
                <TagsView tags={item.tags} />
              </Card>
            </a>
          </List.Item>
        )}
      />
    </div>
  );
};

export default GalleryPage;


import React, { useState } from "react";
import clsx from "clsx";
import Link from "@docusaurus/Link";
import useBaseUrl from "@docusaurus/useBaseUrl";
import styles from "./styles.module.css";

const firstDataRow = [
  {
    title: "Get Started",
    link: "/docs/Getting-Started",
    description: (
      <>
        Learn how to get started with AG2. Follow the instruction to quickly build-up your first AG2 application.
      </>
    ),
  },
  {
    title: "Tutorial",
    link: "docs/tutorial/introduction",
    description: (
      <>
        This tutorial introduces basic concepts and building blocks of AG2.
      </>
    ),
  },
  {
    title: "User Guide",
    link: "docs/topics",
    description: (
      <>
        Users' guide to different functionalities of AG2, including CodeExecution, GroupChat, and more.
      </>
    ),
  },
];

const secondDataRow = [
  {
    title: "Examples",
    link: "docs/Examples",
    description: (
      <>
        Learn different examples demonstrating the usage of AG2 in various scenarios.
      </>
    ),
  },
  {
    title: "Applications",
    link: "docs/Gallery",
    description: (
      <>
        A collection of different applications built using AG2.
      </>
    ),
  },
  {
    title: "Contributions",
    link: "docs/contributor-guide/contributing",
    description: (
      <>
        Learn about how you can contribute to AG2 and this documentation, including pushing patches, code review and more.
      </>
    ),
  },
];

function Feature({ title, link, description }) {
  const [hovered, setHovered] = useState(false);
  const toggleHover = () => setHovered(!hovered);

  return (
    <div className={clsx("col col--4", styles.feature)}>
      <Link
        to={useBaseUrl(link)}
        className={
          hovered
            ? clsx("padding--lg margin-bottom--lg item shadow--tl", styles.card)
            : clsx("padding--lg margin-bottom--lg item shadow--lw", styles.card)
        }
        onMouseOver={toggleHover}
        onMouseOut={toggleHover}
      >
        <div>
          <div className={clsx(styles.titles)}>
            <h4>{title}</h4>
            <p>{description}</p>
          </div>
        </div>
      </Link>
    </div>
  );
}

function Features() {
  return (
    <>
      {firstDataRow && firstDataRow.length > 0 && (
        <section className={clsx("home-container", styles.features)}>
          <div className={clsx("row margin-horiz--lg")}>
            <div className={clsx("col col--2")}>
              <h3 className="container-h3">Explore content</h3>
            </div>
            <div className={clsx("col col--10")}>
              <div className={clsx("row")}>
                {firstDataRow.map((props, idx) => (
                  <Feature key={idx} {...props} />
                ))}
              </div>
            </div>
            <div className={clsx("col col--2")}></div>
            <div className={clsx("col col--10")}>
              <div className={clsx("row")}>
                {secondDataRow.map((props, idx) => (
                  <Feature key={idx} {...props} />
                ))}
              </div>
            </div>
          </div>
        </section>
      )}
    </>
  );
}

export default Features;


import React from 'react';
import clsx from 'clsx';
import { Link } from 'react-router-dom';
import styles from './HomepageFeatures.module.css';

const FeatureList = [
  {
    title: 'Multi-Agent Conversation Framework',
    Svg: require('../../../static/img/conv_2.svg').default,
    docLink: './docs/Use-Cases/agent_chat',
    description: (
      <>
        AG2 provides multi-agent conversation framework as a high-level abstraction. With this framework, one can conveniently build LLM workflows.
      </>
    ),
  },
  {
    title: 'Easily Build Diverse Applications',
    Svg: require('../../../static/img/autogen_app.svg').default,
    docLink: './docs/Use-Cases/agent_chat#diverse-applications-implemented-with-autogen',
    description: (
      <>
        AG2 offers a collection of working systems spanning a wide range of applications from various domains and complexities.
      </>
    ),
  },
  {
    title: 'Enhanced LLM Inference & Optimization',
    Svg: require('../../../static/img/extend.svg').default,
    docLink: './docs/Use-Cases/enhanced_inference',
    description: (
      <>
        AG2 supports enhanced LLM inference APIs, which can be used to improve inference performance and reduce cost.
      </>
    ),
  },
];

function Feature({ Svg, title, description, docLink }) {
  return (
    <div className={clsx('col col--4', styles.featureItem)}>
      <Svg className={styles.featureSvg} alt={title} />
      <Link to={docLink}>
        <h3>{title}</h3>
      </Link>
      <p>{description}</p>
    </div>
  );
}

export default function HomepageFeatures() {
  return (
    <section className={clsx('home-container', styles.features)}>
      <div className={clsx('row margin-horiz--lg')}>
        {}
        <div className={clsx('col col--2')}>
          <h3 className="padding-top--lg container-h3">Key Features</h3>
        </div>

        {}
        <div className={clsx('col col--10')}>
          <div className="row" style={{ justifyContent: 'center' }}>
            {FeatureList.map((props, idx) => (
              <Feature key={idx} {...props} />
            ))}
          </div>
        </div>
      </div>
    </section>
  );
}


import React from "react";
import clsx from "clsx";
import styles from "./styles.module.css";

function PopularResources() {
  return (
    <>
      <section className={clsx("home-container", styles.features)}>
        <div className={clsx("row margin-horiz--lg")}>
          <div className={clsx("col col--2")}>
            <h3 className="padding-top--lg container-h3">
              Popular resources
            </h3>
          </div>
          <div className={clsx("col col--10")}>
            <div className={clsx("row")}>
              <div className={clsx("col col--4 padding--lg", styles.posRelative)}>
                <div className={styles.iframeDiv}>
                  <iframe
                    src="https://www.youtube.com/embed/RLwyXRVvlNk"
                    className={clsx(styles.responsiveIframe)}
                    title="Learn AG2 on DeepLearningAI"
                    frameBorder="0"
                    allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
                    allowFullScreen
                  ></iframe>
                  <a
                    href="https://www.youtube.com/watch?v=RLwyXRVvlNk"
                  >
                    Foundation Capital Interview with Dr. Chi Wang
                  </a>
                </div>
              </div>
              <div className={clsx("col col--4 padding--lg", styles.posRelative)}>
                <div className={styles.iframeDiv}>
                  <iframe
                    src="https://www.youtube.com/embed/TBNTH-fwGPE"
                    className={clsx(styles.responsiveIframe)}
                    title="Learn AG2 on DeepLearningAI"
                    frameBorder="0"
                    allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
                    allowFullScreen
                  ></iframe>
                  <a
                    href="https://www.youtube.com/watch?v=TBNTH-fwGPE"
                  >
                    Learn AG2 on DeepLearningAI
                  </a>
                </div>
              </div>
            </div>
          </div>
        </div>
      </section>
    </>
  );
}

export default PopularResources;


import React from 'react';
import clsx from 'clsx';
import Layout from '@theme/Layout';
import Link from '@docusaurus/Link';
import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
import styles from './index.module.css';
import HomepageFeatures from '../components/HomepageFeatures/HomepageFeatures';
import ExploreContent from "../components/ExploreContent/ExploreContent";
import PopularResources from '../components/PopularResource/PopularResource';
import useBaseUrl from "@docusaurus/useBaseUrl";

function HomepageHeader() {
  const {siteConfig} = useDocusaurusContext();
  return (
    <header className={clsx('hero hero--primary', styles.heroBanner)}>
      <div className="container">
        <img src={useBaseUrl("img/ag2.svg")} width="400em" />
        <h1 className="hero__title">{siteConfig.title}</h1>
        <p className="hero__subtitle">{siteConfig.tagline}</p>
        <div className={styles.buttons}>
          <Link
            className="button button--secondary button--lg"
            to="/docs/Getting-Started">
            Getting Started - 3min ⏱️
          </Link>
        </div>
      </div>
    </header>
  );
}

export default function Home() {
  const {siteConfig} = useDocusaurusContext();
  return (
    <Layout
      title={`AutoGen`}
      description="Enabling Next-Gen LLM Applications via Multi-Agent Conversation Framework">
      <HomepageHeader />
      <PopularResources />
      <HomepageFeatures />
      <ExploreContent />
    </Layout>
  );
}


import siteConfig from '@generated/docusaurus.config';
export default function prismIncludeLanguages(PrismObject) {
  const {
    themeConfig: { prism },
  } = siteConfig;
  const { additionalLanguages } = prism;
  // Prism components work on the Prism instance on the window, while prism-
  // react-renderer uses its own Prism instance. We temporarily mount the
  // instance onto window, import components to enhance it, then remove it to
  // avoid polluting global namespace.
  // You can mutate PrismObject: registering plugins, deleting languages... As
  // long as you don't re-assign it
  globalThis.Prism = PrismObject;

  additionalLanguages.forEach((lang) => {
    if (lang === 'php') {
      // eslint-disable-next-line global-require
      require('prismjs/components/prism-markup-templating.js');
    }
    // eslint-disable-next-line global-require, import/no-dynamic-require
    require(`prismjs/components/prism-${lang}`);
  });

  Prism.languages['text'] = {
    'message-id': {
      pattern: /\b(:?[A-Za-z0-9\-_]+)\s+$:?to\s([A-Za-z0=9\-_]+)$\:/,
      inside: {
        'class-name': /\b(?!to\b)[A-Za-z0-9\-_^]+\b/,
        punctuation: /[()]/,
        keyword: /\bto\b/
      }
    },
    builtin: /\bTERMINATE\b/,
    punctuation: /(?:(---)-+)/,
    function: />>>>>>>>.+[\r\n]?/
  };

  delete globalThis.Prism;
}


Documentation

Examples

Blog

Community Talks

MemGPT

Home

Getting Started

Overview

Introduction to AutoGen

Terminating Conversations Between Agents

Allowing Human Feedback in Agents

Code Executors

Tool Use

Conversation Patterns

What Next?

Multi-agent Conversation Framework

Enhanced Inference

Command Line Code Executor

Custom Code Executor

Jupyter Code Executor

User Defined Functions

Agent Backed by OpenAI Assistant API

Customize Speaker Selection

Resuming a GroupChat

Using Transform Messages during Speaker Selection

Using Custom Model Client classes with Auto Speaker Selection

Non-OpenAI Models

Tips for Non-OpenAI Models

Anthropic Claude

Amazon Bedrock

Cerebras

Cohere

Using Gemini in AutoGen with Other LLMs

Use AutoGen with Gemini via VertexAI

Groq

LiteLLM with WatsonX

Mistral AI

Together.AI

LiteLLM with Ollama

LM Studio

Ollama

Agent Library

Configurations in `nested_config`

Tool Library

Compressing Text with LLMLingua

Introduction to Transform Messages

LLM Caching

Agent Observability

LLM Configuration

ReAct

LLM Reflection

Retrieval Augmentation

Swarm Orchestration

Task Decomposition

Frequently Asked Questions

agent

agentchat.agent

assistant_agent

agentchat.assistant_agent

chat

agentchat.chat

conversable_agent

agentchat.conversable_agent

groupchat

agentchat.groupchat

user_proxy_agent

agentchat.user_proxy_agent

utils

agentchat.utils

abstract_cache_base

cache.abstract_cache_base

cache

cache.cache

cache_factory

cache.cache_factory

cosmos_db_cache

cache.cosmos_db_cache

disk_cache

cache.disk_cache

in_memory_cache

cache.in_memory_cache

redis_cache

cache.redis_cache

base

coding.base

docker_commandline_code_executor

coding.docker_commandline_code_executor

factory

coding.factory

func_with_reqs

coding.func_with_reqs

local_commandline_code_executor

coding.local_commandline_code_executor

markdown_code_extractor

coding.markdown_code_extractor

coding.utils

interoperability

interop.interoperability

interoperable

interop.interoperable

registry

interop.registry

io.base

console

io.console

websockets

io.websockets

base_logger

logger.base_logger

file_logger

logger.file_logger

anthropic

oai.anthropic

bedrock

oai.bedrock

cerebras

oai.cerebras

client

oai.client

client_utils

oai.client_utils

cohere

oai.cohere

completion

oai.completion

gemini

oai.gemini

groq

oai.groq

mistral

oai.mistral

ollama

oai.ollama

openai_utils

oai.openai_utils

together

oai.together

tool

tools.tool

browser_utils

code_utils

exception_utils

function_utils

graph_utils

math_utils

retrieve_utils

runtime_logging

token_count_utils

Using AutoGen Studio

FAQs

Agent Monitoring and Debugging with AgentOps

Azure Cosmos DB

Composio

Databricks

Llamaindex

Mem0:Long-Term Memory and Personalization for Agents

Microsoft Fabric

PGVector

Portkey Integration with AutoGen

Promptflow

Contributing to AG2

Docker for Development

File A Bug Report

Guidance for Maintainers

Pre-commit

Tests

Research

Migration Guide

Upcoming  Talks

Mosaia - The AI community’s platform for creating, sharing and deploying AI agents in a serverless cloud environment - Nov 28, 2024

Investigating Group Decision-Making Mechanism in Decentralized Multi-Agent Collaboration - Nov 25, 2024

Integrating Foundation Models and Symbolic Computing for Next-Generation Robot Planning - Nov 18, 2024

Introducing FastAgency - the fastest way to bring AutoGen workflows to production - Nov 12, 2024

Multi-AI Agents for Chip Design with Distilled Knowledge Debugging Graph, Task Graph Solving, and Multi-Modal Capabilities - Nov 11, 2024

Exploring Pragmatic Patterns in Agentic Systems - Nov 04, 2024

Agent-Model Orchestration in Multi-Agent Applications - Oct 15, 2024

Advanced AutoGen Interactions and Ethical Pathways for AI Sentience - Oct 14, 2024

Installation

Tutorials

Use Cases

User Guide

API Reference

AutoGen Studio

Ecosystem

Contributor Guide