:orphan:




.. raw:: html

    <div class="sphx-glr-thumbnails">

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="AgentScope 实现了基于 OpenTelemetry 的追踪来监控和调试 智能体应用程序的执行，具有以下特性">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_tracing_thumb.png
    :alt:

  :doc:`/tutorial/task_tracing`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">追踪</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="本章从工程实践的角度介绍 AgentScope 中的核心概念，从而阐明 AgentScope 的设计理念。">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_quickstart_key_concept_thumb.png
    :alt:

  :doc:`/tutorial/quickstart_key_concept`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">核心概念</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="AgentScope Studio 是一个本地部署的 Web 应用程序，它">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_studio_thumb.png
    :alt:

  :doc:`/tutorial/task_studio`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">AgentScope Studio</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="关于 AgentScope ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 什么是AgentScope？     AgentScope 是一个多智能体框架，旨在提供一种简单高效的方式来构建基于大语言模型的智能体应用程序。">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_faq_thumb.png
    :alt:

  :doc:`/tutorial/faq`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">常见问题</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="AgentScope 需要 Python 3.10 或更高版本。您可以从源代码或 PyPI 安装。">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_quickstart_installation_thumb.png
    :alt:

  :doc:`/tutorial/quickstart_installation`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">安装</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="AgentScope 在 agentscope.token 模块下提供了 token 计数功能，用于计算给定消息中 的 token 数量，允许开发者在调用 LLM API 前预估 token 数量。">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_token_thumb.png
    :alt:

  :doc:`/tutorial/task_token`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Token 计数</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="下面展示了一个简单的示例，其中创建了两个智能体并并发执行。">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_workflow_concurrent_agents_thumb.png
    :alt:

  :doc:`/tutorial/workflow_concurrent_agents`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Concurrent Agents</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="智能体技能（Agent skill） 是 Anthropic 提出的一种提升智能体在特定任务上能力的方法。">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_agent_skill_thumb.png
    :alt:

  :doc:`/tutorial/task_agent_skill`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">智能体技能</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="钩子（Hook）是 AgentScope 中的扩展点，允许开发者在特定位置自定义智能体行为，提供了一种灵活的方式来修改或扩展智能体的功能，而无需更改其核心实现。">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_hook_thumb.png
    :alt:

  :doc:`/tutorial/task_hook`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">智能体钩子函数</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Handoffs 是由 OpenAI 提出的工作流模式，通过调用子智能体的方式来完成目标任务。 在 AgentScope 中通过工具调用的方式实现 handoffs 非常简单。首先，我们创建一个函数来允许协调者动态创建子智能体。">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_workflow_handoffs_thumb.png
    :alt:

  :doc:`/tutorial/workflow_handoffs`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Handoffs</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="对于多智能体编排，AgentScope 提供了 agentscope.pipeline 模块 作为将智能体链接在一起的语法糖，具体包括">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_pipeline_thumb.png
    :alt:

  :doc:`/tutorial/task_pipeline`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">管道 (Pipeline)</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="AgentScope 为长期记忆提供了一个基类 LongTermMemoryBase 和一个基于 mem0 的具体实现 Mem0LongTermMemory。 结合 agent 章节中 ReActAgent 类的设计，我们提供了两种长期记忆模式：">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_long_term_memory_thumb.png
    :alt:

  :doc:`/tutorial/task_long_term_memory`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">长期记忆</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="实时智能体（Realtime Agent） 用于处理实时交互场景，例如语音对话或实时聊天会话。 AgentScope 中的实时智能体具有以下特性：">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_realtime_thumb.png
    :alt:

  :doc:`/tutorial/task_realtime`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">实时智能体</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="AgentScope 中，嵌入模块提供了用于向量生成的统一接口，具有以下特性：">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_embedding_thumb.png
    :alt:

  :doc:`/tutorial/task_embedding`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">嵌入(Embedding)</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="本章将介绍 AgentScope 对 MCP（Model Context Protocol）的以下支持：">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_mcp_thumb.png
    :alt:

  :doc:`/tutorial/task_mcp`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">MCP</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="AgentScope 提供了 tuner 模块，用于通过强化学习（RL）训练智能体应用。 本教程将带你系统了解如何利用 tuner 提升智能体在特定任务上的表现，包括：">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_tuner_thumb.png
    :alt:

  :doc:`/tutorial/task_tuner`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Tuner</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="消息是 AgentScope 中的核心概念，用于支持多模态数据、工具 API、信息存储/交换和提示构建。">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_quickstart_message_thumb.png
    :alt:

  :doc:`/tutorial/quickstart_message`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">创建消息</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="AgentScope 为多个 API 提供商的文本转语音（TTS）模型提供了统一接口。 本章节演示如何在 AgentScope 中使用 TTS 模型。">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_tts_thumb.png
    :alt:

  :doc:`/tutorial/task_tts`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">TTS</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="在章我们首先重点介绍 AgentScope 中的 ReAct 智能体，然后简要介绍如何从零开始自定义智能体。">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_agent_thumb.png
    :alt:

  :doc:`/tutorial/task_agent`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">智能体</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Conversation 是一种智能体间交换和共享信息的设计模式，常见于游戏、聊天机器人和多智能体讨论场景。">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_workflow_conversation_thumb.png
    :alt:

  :doc:`/tutorial/workflow_conversation`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Conversation</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A2A（Agent-to-Agent）是一种开放标准协议，用于实现不同 AI 智能体之间的互操作通信。">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_a2a_thumb.png
    :alt:

  :doc:`/tutorial/task_a2a`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">A2A 智能体</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Multi-Agent debate 模拟不同智能体之间的多轮讨论场景，通常包括几个 solver 和一个 aggregator。 典型情况下，solver 生成并交换他们的答案，而 aggregator 收集并总结答案。">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_workflow_multiagent_debate_thumb.png
    :alt:

  :doc:`/tutorial/workflow_multiagent_debate`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Multi-Agent Debate</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="在本教程中，我们介绍 AgentScope 中集成的模型 API、如何使用它们，以及如何集成新的模型 API。 AgentScope 目前支持的模型 API 和模型提供商包括：">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_model_thumb.png
    :alt:

  :doc:`/tutorial/task_model`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">模型</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="AgentScope 在 agentscope.agent 模块下提供了开箱即用的 ReAct 智能体 ReActAgent 供开发者使用。">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_quickstart_agent_thumb.png
    :alt:

  :doc:`/tutorial/quickstart_agent`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">创建 ReAct 智能体</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="AgentScope 中的计划（Plan）模块使智能体能够正式地将复杂任务分解为可管理的子任务并系统地执行它们。主要功能包括：">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_plan_thumb.png
    :alt:

  :doc:`/tutorial/task_plan`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">计划</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="在 AgentScope 中，&quot;状态&quot; 是指智能体在运行中某一时刻的数据快照，包括其当前的系统提示、记忆、上下文、装备的工具以及其他 随时间变化 的信息。">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_state_thumb.png
    :alt:

  :doc:`/tutorial/task_state`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">状态/会话管理</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="AgentScope 中的格式化器（formatter）模块负责">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_prompt_thumb.png
    :alt:

  :doc:`/tutorial/task_prompt`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">提示词格式化</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="- 使用结构化输出的显式 routing - 使用工具调用的隐式 routing">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_workflow_routing_thumb.png
    :alt:

  :doc:`/tutorial/workflow_routing`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Routing</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="AgentScope 中的记忆模块负责：">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_memory_thumb.png
    :alt:

  :doc:`/tutorial/task_memory`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">记忆</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="AgentScope 提供了一个内置的评测框架，用于评测智能体在不同任务和基准测试中的性能，主要特性包括：">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_eval_thumb.png
    :alt:

  :doc:`/tutorial/task_eval`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">智能体评测</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="AgentScope 提供了内置的 RAG（Retrieval-Augmented Generation) 实现。本节将详细介绍">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_rag_thumb.png
    :alt:

  :doc:`/tutorial/task_rag`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">RAG</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="AgentScope 提供了灵活的中间件系统，允许开发者拦截和修改各种操作的执行。 目前，中间件支持已在 Toolkit 类中实现，用于工具执行。">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_middleware_thumb.png
    :alt:

  :doc:`/tutorial/task_middleware`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">中间件</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="为了确保准确可靠的工具解析，AgentScope 全面支持工具 API 的使用，具有以下特性：">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_tool_thumb.png
    :alt:

  :doc:`/tutorial/task_tool`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">工具</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="[OpenJudge](https://github.com/agentscope-ai/OpenJudge) 是一个专为评估LLM/Agent应用质量而设计的评估框架。通过将 OpenJudge 集成到 AgentScope 中，您可以将 AgentScope 的原生评估能力从基础的执行检查扩展到深度的语义质量分析。">

.. only:: html

  .. image:: /tutorial/images/thumb/sphx_glr_task_eval_openjudge_thumb.png
    :alt:

  :doc:`/tutorial/task_eval_openjudge`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">OpenJudge 评估器</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /tutorial/task_tracing
   /tutorial/quickstart_key_concept
   /tutorial/task_studio
   /tutorial/faq
   /tutorial/quickstart_installation
   /tutorial/task_token
   /tutorial/workflow_concurrent_agents
   /tutorial/task_agent_skill
   /tutorial/task_hook
   /tutorial/workflow_handoffs
   /tutorial/task_pipeline
   /tutorial/task_long_term_memory
   /tutorial/task_realtime
   /tutorial/task_embedding
   /tutorial/task_mcp
   /tutorial/task_tuner
   /tutorial/quickstart_message
   /tutorial/task_tts
   /tutorial/task_agent
   /tutorial/workflow_conversation
   /tutorial/task_a2a
   /tutorial/workflow_multiagent_debate
   /tutorial/task_model
   /tutorial/quickstart_agent
   /tutorial/task_plan
   /tutorial/task_state
   /tutorial/task_prompt
   /tutorial/workflow_routing
   /tutorial/task_memory
   /tutorial/task_eval
   /tutorial/task_rag
   /tutorial/task_middleware
   /tutorial/task_tool
   /tutorial/task_eval_openjudge



.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_