append_messages() — anthropic-sdk-python Function Reference

Architecture documentation for the append_messages() function in _beta_runner.py from the anthropic-sdk-python codebase.

Function python ExtensibilityTools ToolRunner calls 1 called by 4

Entity Profile

ExtensibilityTools→ ToolRunner→ append_messages() — anthropic-sdk-python Function Reference

Dependency Diagram

graph TD
  4970c546_0fad_9c03_1498_9ae6f7952dcf["append_messages()"]
  74dfae5d_02b1_0e09_5e30_62a5a1ac1ac2["BaseToolRunner"]
  4970c546_0fad_9c03_1498_9ae6f7952dcf -->|defined in| 74dfae5d_02b1_0e09_5e30_62a5a1ac1ac2
  98b55090_3b6f_2dd4_ca2d_6c52114d5a9e["__run__()"]
  98b55090_3b6f_2dd4_ca2d_6c52114d5a9e -->|calls| 4970c546_0fad_9c03_1498_9ae6f7952dcf
  d1f2e83f_ca29_2f3a_83b4_5a5af4a46b73["_generate_tool_call_response()"]
  d1f2e83f_ca29_2f3a_83b4_5a5af4a46b73 -->|calls| 4970c546_0fad_9c03_1498_9ae6f7952dcf
  e767db6b_72ea_d60e_0f49_54ac2dd6c0a7["__run__()"]
  e767db6b_72ea_d60e_0f49_54ac2dd6c0a7 -->|calls| 4970c546_0fad_9c03_1498_9ae6f7952dcf
  b5b59a19_0646_9f18_1716_6cbb729f18af["_generate_tool_call_response()"]
  b5b59a19_0646_9f18_1716_6cbb729f18af -->|calls| 4970c546_0fad_9c03_1498_9ae6f7952dcf
  adc89f46_a31c_f374_60f3_d6ae19ce9e15["set_messages_params()"]
  4970c546_0fad_9c03_1498_9ae6f7952dcf -->|calls| adc89f46_a31c_f374_60f3_d6ae19ce9e15
  style 4970c546_0fad_9c03_1498_9ae6f7952dcf fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

src/anthropic/lib/tools/_beta_runner.py lines 100–112

    def append_messages(self, *messages: BetaMessageParam | ParsedBetaMessage[ResponseFormatT]) -> None:
        """Add one or more messages to the conversation history.

        This invalidates the cached tool response, i.e. if tools were already called, then they will
        be called again on the next loop iteration.
        """
        message_params: List[BetaMessageParam] = [
            {"role": message.role, "content": message.content} if isinstance(message, BetaMessage) else message
            for message in messages
        ]
        self._messages_modified = True
        self.set_messages_params(lambda params: {**params, "messages": [*self._params["messages"], *message_params]})
        self._cached_tool_call_response = None